linkfox-sellersprite-competitor

Name: linkfox-sellersprite-competitor
Author: linkfox-ai

github.com/linkfox-aiマーケティング・グロース113170 回インストール2 週間前に更新

リポジトリ

linkfox-sellersprite-competitor について

SellerSprite のデータで競合商品を調べる Amazon セラー向けスキルです。ASIN、キーワード、セラー、ブランド、カテゴリーで12市場の商品を検索し、最新および過去の月次指標を確認できます。

主な機能

01ASIN・キーワード・セラー・ブランド・カテゴリー検索
02Amazon 12市場に対応
03月間販売数・売上・BSR 指標
04最新および過去のスナップショット
05商品バリエーションと成長データ

活用シーン

01キーワードの主要競合を探す
02ブランドやセラーの比較
03スナップショットによる季節性の比較
04商品バリエーションと成長の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-sellersprite-competitor

インストール後、Claude Code で/linkfox-sellersprite-competitorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

api.md

scripts/

response_io.py

sellersprite_competitor_lookup.py

詳細

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+コンテンツ（Y/N）
badgeVideo	動画あり（Y/N）

APIの使用方法

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

使用例

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"
}

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

表示ルール

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

重要な制限事項

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

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

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

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

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

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

フィードバック：

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

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

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

大きな応答の処理

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

python scripts/response_io.py run --script scripts/sellersprite_competitor_lookup.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を設定してください。

Markdown 対応

ログインしてコメント

基本情報

作者: linkfox-ai
リポジトリ: linkfox-ai/linkfox-skills
カテゴリ: マーケティング・グロース
インストール数: 170
GitHub スター: 113

問題を報告