linkfox-jiimore-page-asins-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"）

並べ替えオプション

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

呼び出し方法

• API エンドポイント：POST /jiimore/pageAsinsByAsin（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
• Python スクリプト：python scripts/jiimore_page_asins_by_asin.py '<JSON 参数>' [--inline]
• コスト上の制約：このツールは計算リソースを消費します。同一セッション内の同じパラメーターの組み合わせに対する呼び出しは、デフォルトで1回のみです。スクリプトには24時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードを自動的に変更したり、ページをめくったり、郵便番号を変えたりして連続して試してはいけません。検索を続ける必要がある場合は、追加のコストが発生することを事前にユーザーに伝えてください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-jiimore-page-asins-by-asin-<timestamp>.json に保存します（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動的にまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が8 KB以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が8 KBを超える場合：ファイルに保存した後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最も大きいリストフィールドの長さと先頭3件のサンプル）
• --inline を指定すると、stdout に全件を強制的に出力します（同様にファイルにも保存します）

データの読み取りに関する推奨事項：まず要約を確認して情報が十分か判断してください。具体的なフィールドが必要な場合は、保存済みの json ファイルから jq または ConvertFrom-Json を使って必要なデータだけを抽出し、JSON 全体がコンテキストに入るのを避けてください。

認証と計算リソースの問題の解決

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが401または402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの期限切れ／チャージが必要／チャージしてください」または類似の内容が含まれている場合。

使用例

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～100 ではなく 0～1 の範囲を使用します。フィルターを作成する際は、正しい値を設定してください。
• 日付形式：発売日に関するパラメーターには、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 を案内してください。

算力消耗规则

9 算力を消費します。

ユーザーは算力の消費に応じて料金を支払います。十分に評価してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが算力の消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md の指定に従って Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

---

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