mcpField
L
linkfox-sellersprite-market-statistics

linkfox-sellersprite-market-statistics

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

linkfox-sellersprite-market-statistics について

SellerSpriteを通じて、Amazonのカテゴリー階層ノードの集計市場統計を取得するスキルです。商品一覧全体ではなく、上位商品のサンプル数、新商品の対象月数、集計期間を指定できます。

主な機能

  1. 01カテゴリー階層ノードの集計統計
  2. 02上位商品サンプル数の指定
  3. 03新商品の対象期間設定
  4. 04集計期間の指定
  5. 05JSON保存とローカルキャッシュ

活用シーン

  1. 01Amazonカテゴリー市場の評価
  2. 02カテゴリー上位商品の統計確認
  3. 03期間別のノードデータ分析

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
scripts/
onboarding.py
sellersprite_market_statistics.py

詳細

SellerSprite Market Statistics

このスキルは、SellerSprite を通じて Amazon カテゴリーのノードレベルの市場統計を取得します。

基本概念

  • ノード統計：指定したカテゴリーのノードを集計した統計であり、商品詳細の全件は返しません。
  • TopN の基準：topN は、上位商品の統計サンプル数を決定します（デフォルトは 10）。
  • 新商品の定義：newProduct は、「新商品」を直近何か月間として定義するかを指定します（デフォルトは 6）。

呼び出し方法

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

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

  • 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-market-statistics-<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／プランの有効期限切れ／チャージが必要／チャージしてください」または同様の内容が含まれている。

パラメーター

パラメーター型必須説明
marketplacestringはいマーケットプレイスのコード。デフォルトは US
nodeIdPathstringはいノード ID のパス。例：1064954:1069242:...
monthstringいいえnearly または yyyyMM
topNintegerいいえ上位サンプル数。デフォルトは 10
newProductintegerいいえ新商品の定義（月）。デフォルトは 6

使用例

{
  "marketplace": "US",
  "nodeIdPath": "172282:281407",
  "month": "nearly",
  "topN": 10,
  "newProduct": 6
}

表示ルール

  1. 統計の基準を明確に示します：topN、newProduct、期間。
  2. まず主要な概要指標を出力し、次に追加フィールドを出力します。
  3. ユーザーが nodeIdPath を指定していない場合は、ノードパスを提示するよう案内するか、先にカテゴリーを特定してください。

重要な制限事項

  • 必須パラメーター：marketplace、nodeIdPath
  • nodeIdPath は有効なノードパスである必要があります
  • 月の指定による検索は、サードパーティーが提供する過去データの範囲に制限されます

計算リソース消費ルール

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

ユーザーは計算リソースの消費に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかをユーザーに決めてもらってください。

フィードバック：

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

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

references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの操作を中断しないでください。

コメント

Markdown 対応