linkfox-sellersprite-competitor-lookup

SellerSprite の競合製品検索

このスキルでは、Amazon の競合製品データの検索と分析方法について説明します。Amazon の販売者が競合製品を見つけ、パフォーマンスを比較し、実用的な競合情報を得るのに役立ちます。

基本概念

SellerSprite の競合製品検索ツールは、12 のマーケットプレイスにわたる包括的な Amazon 製品データを提供します。ASIN、キーワード、販売者名、ブランド、カテゴリーで製品を検索でき、月間販売数量、売上高、BSR ランキング、価格、評価、成長傾向などの詳細な指標を取得できます。

データスナップショット：このツールは、リアルタイムデータ（過去 30 日間）と過去の月次スナップショットの両方に対応しています。現在のデータには nearly（デフォルト）を、過去のスナップショットには yyyyMM 形式（例：202501）を使用してください。過去のスナップショットには、その月に出品中だったすべてのリスティングが含まれており、前年比や季節ごとの比較が可能です。

カテゴリー階層：Amazon のカテゴリー名は、コロン（:）で区切った複数階層のパスに対応しています。例：Electronics:Computers & Accessories:Monitors。ユーザーが指定したカテゴリーの説明を、適切なコロン区切り形式に変換してください。

対応マーケットプレイス

US（米国）、UK（英国）、DE（ドイツ）、FR（フランス）、JP（日本）、CA（カナダ）、IT（イタリア）、ES（スペイン）、MX（メキシコ）、AU（オーストラリア）、TR（トルコ）、IN（インド）

デフォルトのマーケットプレイスは US です。ユーザーがマーケットプレイスを指定しない場合は、US を使用してください。

パラメーターガイド

検索フィルター

パラメーター	説明	例
marketplace	Amazon マーケットプレイスコード	US、UK、DE、JP
keyword	検索キーワード（マーケットプレイスの言語に翻訳）	wireless earbuds
asinList	1 つ以上の ASIN（カンマ区切り、最大 40 件）	B072MQ5BRX,B08N5WRWNW
sellerName	絞り込み対象の販売者名	Anker Direct
brand	ブランド名	Anker
nodeLabel	Amazon カテゴリー名（階層をコロンで区切る）	Electronics:Headphones
nodeIdPath	Amazon カテゴリー ID パス	172282
matchType	キーワードの一致モード：1 = フレーズ、2 = あいまい、3 = 完全一致（デフォルトは 1）	1
showVariation	製品バリエーションを表示：Y または N（デフォルトは N）	N
dataSnapshotMonth	データスナップショットの対象月（リアルタイムの場合は nearly、それ以外は yyyyMM）	nearly

ページネーションと並べ替え

パラメーター	説明	例
page	ページ番号（1 から開始）	1
size	1 ページあたりの結果数（10～100、デフォルトは 50）	50
order.field	並べ替えフィールド（以下の並べ替えオプションを参照）	total_units
order.desc	並べ替え順：true = 降順、false = 昇順	true

並べ替えフィールドのオプション

フィールド	説明
total_units	月間販売数量
total_amount	月間売上高
bsr_rank	BSR ランキング
price	価格
rating	評価スコア
reviews	レビュー数
profit	粗利益率
reviews_rate	レビュー率
available_date	出品日
questions	質問と回答の件数
total_units_growth	月間販売数量の成長率
total_amount_growth	月間売上高の成長率
reviews_increasement	月間の新規レビュー数
bsr_rank_cv	7 日間の BSR 上昇回数
bsr_rank_cr	7 日間の BSR 上昇率
amz_unit	バリエーションの販売数量

主要なレスポンスフィールド

フィールド	説明
asin	商品の ASIN
title	商品名
price	現在の価格
monthlySalesUnits	月間販売数
monthlySalesRevenue	月間売上高
bsr	BSR ランキング
bsrGrowthRate	BSR 成長率
bsrGrowthCount	BSR 成長数
rating	評価スコア
ratings	評価数
ratingsGrowth	月間の新規評価数
ratingsRate	レビュー率
brand	ブランド名
sellerName	BuyBox の販売者
sellerNation	BuyBox の販売者の国籍
fulfillment	フルフィルメントの種類（AMZ/FBA/FBM）
availableDateString	出品日
profit	粗利益率
nodeLabelPath	カテゴリーパス
imageUrl	商品画像の URL
monthlySalesUnitsGrowthRate	月間販売数の成長率
listingQualityScore	出品品質スコア
variationNum	バリエーション数
parent	親 ASIN
badgeBestSeller	ベストセラーバッジ（Y/N）
badgeAmazonChoice	Amazon's Choice バッジ（Y/N）
badgeEbc	A+ Content（Y/N）
badgeVideo	動画の有無（Y/N）

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-competitor-lookup-<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 で競合商品を検索する

{
  "marketplace": "US",
  "asinList": "B072MQ5BRX,B08N5WRWNW"
}

使用例：ASIN を指定して、特定の競合商品を分析します。

2. キーワードで競合商品を検索する

{
  "marketplace": "US",
  "keyword": "wireless earbuds",
  "matchType": 1,
  "order": {"field": "total_units", "desc": "true"},
  "size": 20
}

使用例：キーワードに関連する売れ筋商品を、月間販売数順に見つけます。

3. ブランドとカテゴリーで絞り込む

{
  "marketplace": "US",
  "brand": "Anker",
  "nodeLabel": "Electronics:Headphones",
  "order": {"field": "total_amount", "desc": "true"}
}

使用例：カテゴリー内の特定ブランドの商品ラインアップを分析します。

4. 販売者名で商品を検索する

{
  "marketplace": "DE",
  "sellerName": "Anker Direct",
  "order": {"field": "bsr_rank", "desc": "false"}
}

使用例：特定の販売者の商品を BSR 順に表示します。

5. 過去のスナップショットを比較する

{
  "marketplace": "US",
  "keyword": "space heater",
  "dataSnapshotMonth": "202412",
  "order": {"field": "total_units", "desc": "true"},
  "size": 20
}

使用例：過去のデータスナップショットを使って、季節ごとの商品パフォーマンスを分析します。

6. 商品のバリエーションを表示する

{
  "marketplace": "JP",
  "asinList": "B0XXXXXXXXX",
  "showVariation": "Y"
}

使用例：商品ファミリーのバリエーションごとのデータをすべて確認します。

表示ルール

1. データを明確に提示する：クエリ結果は適切に書式設定された表で表示します。ASIN、タイトル、価格、月間販売数、BSR、評価、ブランドなどの主要指標を含めてください。ユーザーから求められない限り、主観的なビジネス上のアドバイスは提供しないでください。
2. キーワードの言語：キーワードで検索する場合は、必ず対象マーケットプレイスの言語に翻訳します（例：米国／英国では英語、DEではドイツ語、JPでは日本語）。ユーザーが誤った言語でキーワードを入力した場合は、その旨を伝えてください。
3. BSR の説明：BSR データを表示する際は、値が低いほど販売実績が高いことをユーザーに伝えてください。
4. 成長指標：成長率を表示する際は、正の値が改善と低下のどちらを意味するのかを明確にします（BSR の成長数が正の場合、BSR が上昇しており、ランキングが低下したことを意味します）。
5. ページネーションの通知：結果の総数が返されたページサイズを超える場合は、総件数をユーザーに伝え、追加ページを取得するか確認してください。
6. バッジの強調表示：商品にバッジ（ベストセラー、Amazon's Choice、A+ Content、動画）が付いている場合は、重要な競争指標となるため、結果内で目立たせてください。
7. エラー処理：クエリが失敗した場合は、message フィールドに基づいて理由を説明し、クエリパラメーターの調整を提案してください。
8. スナップショットの案内：ユーザーが季節性やトレンドの分析を希望する場合は、比較用に過去のスナップショット（例：昨年の同じ月）の利用を積極的に提案してください。

重要な制限事項

• 結果の上限：各ページで返されるレコードは 10～100 件です（size で指定）。より多くの結果を取得するには、ページネーションを使用してください。
• ASIN の上限：asinList を使用して一度にクエリできる ASIN は最大 40 件です。
• 過去のスナップショット：クエリできるのは既存の月次スナップショットのみです。将来の日付はサポートされていません。
• キーワードの言語：最適な結果を得るには、キーワードをマーケットプレイスの言語に合わせてください。

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

該当する -- Amazon の競合商品データに関するクエリ：

ユーザーの発言	シナリオ
「この ASIN の競合商品を見つけて」	ASIN に基づく競合商品の検索
「ワイヤレスイヤホンの売れ筋商品」	キーワードに基づく商品検索
「この出品者は何を販売していますか」	出品者の商品ポートフォリオ分析
「エレクトロニクスカテゴリの商品を表示して」	カテゴリに基づく閲覧
「これらの ASIN の月間販売数」	特定商品の販売数推定
「売れ行きが伸びている新商品」	成長トレンドの検出
「ブランド間で商品を比較して」	ブランドのベンチマーク
「昨年の 12 月、このニッチ市場はどうでしたか」	過去のスナップショット分析
「評価の高いベストセラー」	複数指標による絞り込み
「このカテゴリの FBA と FBM の比較」	フルフィルメントタイプの分析

該当しない -- 競合商品データの範囲を超えるニーズ：

• ABA の検索語データまたはキーワードランキング（代わりに ABA Data Explorer を使用してください）
• 広告／PPC キャンペーンの管理
• 商品レビューの内容またはセンチメント分析
• 出品情報のコピーライティングまたは最適化の提案
• サプライヤーの調達または製造コスト
• アカウントの健全性またはポリシー遵守

計算リソースの消費ルール

計算リソースを 15 消費します。

ユーザーは計算リソースの消費に対して料金を支払います。この点を十分に考慮してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに通知し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md に記載されているとおりに Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

---

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