linkfox-jiimore-niche-by-asin

ASIN による Jiimore ニッチ競合商品検索

このスキルでは、参照 ASIN と同じニッチセグメントに属する Amazon の競合商品を検索・絞り込む方法を説明します。クリックコンバージョン率、複合コンバージョン率、クリック数、販売数量、レビュー数、価格、FBA 手数料、粗利益率などの指標を使って、Amazon セラーが潜在的な競合商品を見つけ、機会を評価できるよう支援します。

主な概念

参照 ASIN を指定すると、このツールは Amazon 上で同じニッチセグメントを共有する競合 ASIN を抽出し、豊富な指標を含むページ分けされた一覧を返します。指標には、クリックコンバージョン率、複合コンバージョン率、クリック数（過去 7 日間／30 日間／90 日間）、販売数量、価格、FBA 手数料、粗利益率、顧客評価、過去 90 日間のトレンドデータが含まれます。データを利用できるマーケットプレイスは、US、JP、DEのみです。

ASIN は必須です：すべてのクエリに参照 asin を含める必要があります。このツールは、その ASIN と同じニッチセグメントを共有する商品を検索し、詳細な指標とともに返します。

パーセンテージ項目：いくつかのパラメーターは、0%～100%を表す 0～1 の小数範囲を使用します。これらの値をユーザーに表示する際は、パーセンテージに変換してください（例：0.15 → 15%）。

日付形式：発売日のパラメーターには yyyyMMdd000000 形式を使用します（例：1 月 1 日を表す 20240101000000）。

パラメーターガイド

必須

パラメーター	型	説明
asin	string	競合商品を検索するための参照 ASIN（最大 1000 文字）

マーケットプレイスとページネーション

パラメーター	型	デフォルト	説明
countryCode	string	US	国コード：US、JP、DE
page	integer	1	ページ番号（1 から開始）
pageSize	integer	50	1 ページあたりの結果数（10～100）
sortField	string	purchasedClicksT360	並べ替えに使用する項目（下記の並べ替えオプションを参照）
sortType	string	desc	並べ替え順：desc または asc

フィルターパラメーター（すべて任意、最小値／最大値の範囲）

価格と FBA：

パラメーター	型	説明
priceMin / priceMax	number	商品価格の範囲
fbaFeeMin / fbaFeeMax	number	FBA 手数料の範囲
grossProfitMarginMin / grossProfitMarginMax	number	粗利益率の範囲

レビューと評価：

パラメーター	型	説明
totalReviewsMin / totalReviewsMax	integer	レビュー総数の範囲
customerRatingMin / customerRatingMax	number	顧客評価の範囲（0.0～5.0）

クリックデータ（過去 7 日間）：

パラメーター	型	説明
clickCountT7Min / clickCountT7Max	integer	週間クリック数の範囲
clickCountGrowthT7Min / clickCountGrowthT7Max	number	週間クリック数増加率（0～1）
clickConversionRateMin / clickConversionRateMax	number	クリックコンバージョン率（0～1）

クリックデータ（過去 30 日間）：

パラメーター	型	説明
clickCountT30Min / clickCountT30Max	integer	月間クリック数の範囲
clickCountGrowthT30Min / clickCountGrowthT30Max	number	月間クリック数増加率（0～1）

複合コンバージョン：

パラメーター	型	説明
clickConversionRateCompositeMin / clickConversionRateCompositeMax	number	複合クリックコンバージョン率（0～1）

販売数と発売日：

パラメーター	型	説明
salesVolumeT360Min / salesVolumeT360Max	integer	過去 360 日間の販売数量の範囲
launchDateMin / launchDateMax	string	発売日の範囲（形式：yyyyMMdd000000）

ニッチとセラー：

パラメーター	型	説明
nicheCountMin / nicheCountMax	integer	商品が属するニッチの数
sellerCountry	string	セラーの国コード（複数指定する場合はカンマ区切り、例："CN,US"）

並べ替えオプション

値	意味
purchasedClicksT360	360 日間の購入クリック数（デフォルト）
totalReviews	レビュー総数
price	価格
launchDate	発売日
clickCountT30	30 日間のクリック数
clickCountT90	90 日間のクリック数
clickCountT7	7 日間のクリック数
clickConversionRate	クリックコンバージョン率
clickConversionRateComposite	複合クリックコンバージョン率
customerRating	顧客評価
clickCountGrowthT7	週間クリック増加率
clickCountGrowthT30	月間クリック増加率
currentPrice	現在の価格
fbaFee	FBA 手数料
shippingFee	FBA 配送料
gpm	粗利益率

API の使用方法

このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し規約、リクエストパラメーター、レスポンス構造については、references/api.md を参照してください。scripts/jiimore_page_asins_by_asin.py を直接実行してクエリを実行することもできます。

使用例

1. ASIN による基本的な競合商品検索 米国市場で、基準となる ASIN の競合商品を検索します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

2. コンバージョン率の高い競合商品 複合コンバージョン率が 15% を超える競合商品を検索します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickConversionRateCompositeMin": 0.15,
  "sortField": "clickConversionRateComposite",
  "sortType": "desc"
}

3. 新商品の販売機会 クリック増加率が高く、発売から 3 か月以内の競合商品を検索します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "launchDateMin": "20240101000000",
  "clickCountGrowthT7Min": 0.1,
  "sortField": "clickCountGrowthT7",
  "sortType": "desc"
}

4. 価格帯で絞り込んだ競合商品 粗利益率が良好で、価格が 20 ドルから 50 ドルの競合商品を検索します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "priceMin": 20,
  "priceMax": 50,
  "grossProfitMarginMin": 0.3,
  "sortField": "gpm",
  "sortType": "desc"
}

5. クリック数が多くレビュー数が少ない競合商品（潜在的な弱点） 月間クリック数が 2000 を超え、レビュー数が 100 件未満の競合商品を検索します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "clickCountT30Min": 2000,
  "totalReviewsMax": 100,
  "sortField": "clickCountT30",
  "sortType": "desc"
}

6. 日本市場の競合分析 評価順に並べ替えて、日本市場の競合商品を調査します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "JP",
  "sortField": "customerRating",
  "sortType": "desc"
}

7. 同じニッチ市場の中国の販売者 販売者の国（中国）で競合商品を絞り込み、販売量の多い商品を検索します：

{
  "asin": "B0GC4RPX79",
  "countryCode": "US",
  "sellerCountry": "CN",
  "salesVolumeT360Min": 1000,
  "sortField": "purchasedClicksT360",
  "sortType": "desc"
}

表示ルール

1. データを明確に表示する：クエリ結果は、適切に構成された表で表示します。読みやすくするため、小数の比率はパーセンテージに変換します（例：0.25 → 25%）。
2. 主要な指標を強調する：ASIN、商品タイトル、価格、顧客評価、クリックコンバージョン率（複合）、クリック数、レビュー総数、粗利益率を、主要な列として必ず表示します。
3. ニッチ市場の背景を示す：niches フィールドがある場合は、商品が競合する市場セグメントを把握できるよう、上位のニッチタイトルと需要スコアを表示します。
4. トレンドを可視化する：trends データがある場合は、クリック数や価格などの主要な指標について、90 日間のトレンドの方向（上昇／下降／横ばい）を要約します。
5. ページネーションの案内：total が現在のページサイズを超える場合は、総件数を伝え、必要に応じて追加ページを取得するよう案内します。
6. エラー処理：クエリに失敗した場合は、レスポンスメッセージに基づいて理由を説明し、フィルター条件の調整（例：範囲の拡大や ASIN の確認）を提案します。
7. 主観的なアドバイスはしない：求められていないビジネス上の提案は加えず、データを客観的に提示します。解釈は、ユーザーから明示的に求められた場合にのみ提示します。

重要な制限事項

• 対応マーケットプレイス：利用できるのは US、JP、DE のみです。それ以外のマーケットプレイスコードは拒否されます。
• ASIN が必須：すべてのクエリに基準となる ASIN を指定する必要があります。ASIN がない場合、API は結果を返しません。
• 結果の上限：1 ページあたり最大 100 件です。
• パーセンテージ値：すべての率／シェアのパラメーターは 0～1 の範囲で指定し、0～100 ではありません。フィルターを作成する際は、正しい値を指定してください。
• 日付形式：発売日のパラメーターは yyyyMMdd000000 形式で指定する必要があります。

ユーザー表現とシナリオのクイックリファレンス

該当するケース — 参照 ASIN に基づいて競合商品を見つける場合：

ユーザーの発言	シナリオ
「ASIN B0GC4RPX79 の競合商品を見つけて」	競合商品の直接検索
「この ASIN と競合する商品は何ですか？」	同じニッチの競合商品を探す
「同じニッチの類似商品を表示して」	ニッチ内の競合商品を見つける
「自分の商品と競合する、コンバージョン率の高い商品を探して」	コンバージョン率に基づく競合商品の絞り込み
「自分のニッチで競合する新商品を探して」	新規参入商品の特定
「この ASIN と競合する中国のセラーはどれですか？」	セラーの原産地に基づく絞り込み
「自分の商品に似た、レビュー数が少なくクリック数の多い商品を探して」	機会ギャップの分析
「ASIN XX の競合商品との価格分析」	価格に焦点を当てた競合分析

該当しないケース — ASIN に基づく同じニッチの競合商品発見を超えるニーズ：

• キーワードレベルのニッチ市場分析（代わりに Jiimore Niche Info by Keyword を使用）
• 個別 ASIN の売上または利益の推定
• ABA 検索語データ／キーワード調査
• 広告キャンペーンの管理または入札額の最適化
• 商品レビューの分析または出品情報の最適化
• サプライヤーの調達または物流計画

適用範囲の判断：「競合分析」や「類似商品」とユーザーが言った場合、特定の ASIN と同じニッチで競合する商品を見つけることが目的であれば、このスキルが該当します。キーワードレベルの市場セグメントデータが必要な場合は、Jiimore Niche Info by Keyword を案内してください。単一 ASIN の詳細な商品データが必要な場合は、Amazon Product Detail を案内してください。

フィードバック：

以下のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出して報告してください。

1. このスキルで説明されている機能または目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満や称賛を表明する
4. 改善できると思われることがある

references/api.md に記載されている方法でフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

大きな応答の処理

エージェントのコンテキストがあふれないように、応答をディスクに保存し、必要なフィールドだけを抽出してください：

python scripts/response_io.py run --script scripts/jiimore_page_asins_by_asin.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git の作業ツリーの外（Unix では /tmp/...、Windows では %TEMP%/... など）に指定してください。保存された応答には、PII、価格情報、認証関連の機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、作業が終わったら削除してください。

run は完全な応答をファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は特定のフィールドを抽出し、--limit/--offset で範囲を指定し、--format json|jsonl|csv|table で出力形式を指定できます。

このパターンを優先する場合 — 応答の特性に基づいて判断してください。例：

• レコードあたりのフィールド数が多い場合、または不要なフィールドがある場合
• バッチ結果／ページ分割された結果（1 回の呼び出しで複数の項目が返される場合）
• 長文フィールド（説明、レビュー、HTML、時系列データ）
• すぐに使用せず、後続の手順で再利用する出力

小規模で一度だけ使用する応答の場合は、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューは、切り詰められたスキーマとサンプルであり、完全なデータではありません。フィールド単位の判断には、必ず保存済みファイルを read で読み込んでください。

---

高品質でプロフェッショナルな越境ECスキルをさらに利用するには、LinkFox Skills を設定してください。