linkfox-sellersprite-market-research

SellerSprite 市場調査

このスキルは、SellerSprite の市場調査データを使用して、Amazon のカテゴリー市場をスクリーニングし、順位付けするのに役立ちます。

基本概念

• カテゴリー市場レベルの分析：商品単位の一覧ではなく、カテゴリー／ノードごとに集約された市場プロファイルです。
• 市場規模：月平均販売数、月平均売上高、商品数などです。
• 競争構造：セラー／ブランドの集中度、上位集中度、自社販売比率、FBA／FBM 比率です。
• 入力パラメーターの尺度：絞り込みに使用する GoodsCrn / BrandCrn / SellerCrn / EbcProportion / FbaProportion / FbmProportion / AmazonSelfProportion（min*/max*）は 0～1 の小数で指定する必要があります。以下のパラメーター表と references/api.md を参照してください。
• 新商品の機会：新商品数、新商品比率、新商品の平均価格／評価／販売数などです。

呼び出し方法

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

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

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

主なパラメーター

インターフェースの絞り込み項目はツール _sellersprite_market_research と共通です（70 以上）。以下の表はよく使用される項目の抜粋です。完全なパラメーターと出力フィールドについては references/api.md を参照してください。

パラメーター	型	必須	説明
marketplace	string	はい	マーケットプレイスのコード。デフォルトは US です
month	string	いいえ	nearly または yyyyMM
nodeIdPath	string	いいえ	カテゴリーノードのパス
departmentKeyword	string	いいえ	カテゴリーキーワードのパス
page / size	integer	いいえ	ページネーション。デフォルトは 1/50、size の最大値は 200 です
orderField / orderDesc	string/boolean	いいえ	並べ替えフィールドと順序。orderDesc のデフォルトは true（降順）です
minAvgRevenue / maxAvgRevenue	number	いいえ	月平均売上高の範囲
minAvgUnits / maxAvgUnits	integer	いいえ	月平均販売数の範囲
minGoodsCount / maxGoodsCount	integer	いいえ	商品数の範囲
minGoodsCrn / maxGoodsCrn	number	いいえ	商品集中度（0～1 の小数。例：0.4 は 40% を表します。整数の 40 は使用しないでください）
minSellerCrn / maxSellerCrn	number	いいえ	セラー集中度（0～1 の小数）
minBrandCrn / maxBrandCrn	number	いいえ	ブランド集中度（0～1 の小数）
minAmazonSelfProportion / maxAmazonSelfProportion	number	いいえ	Amazon 自社販売比率（0～1 の小数）
minFbaProportion / maxFbaProportion	number	いいえ	FBA 比率（0～1 の小数）
minFbmProportion / maxFbmProportion	number	いいえ	FBM 比率（0～1 の小数）
minEbcProportion / maxEbcProportion	number	いいえ	A+ コンテンツ数の比率（0～1 の小数）
minNewProportion / maxNewProportion	number	いいえ	新商品比率（尺度は上記と異なる場合があります。references/api.md／schema を参照してください）
minAvgPrice / maxAvgPrice	number	いいえ	平均価格の範囲
minAvgRating / maxAvgRating	number	いいえ	平均評価の範囲
minAvgProfit / maxAvgProfit	number	いいえ	平均粗利益率（%）

使用例

{
  "marketplace": "US",
  "month": "nearly",
  "minAvgRevenue": 10000,
  "maxGoodsCrn": 0.4,
  "minNewProportion": 10,
  "maxSellerCrn": 0.5,
  "orderField": "total_amount",
  "orderDesc": true,
  "page": 1,
  "size": 50
}

表示ルール

1. まず市場候補の Top N を提示し、次に主要指標（市場規模、集中度、新商品比率）を表示します。
2. 入力パラメーターの再表示：GoodsCrn／BrandCrn／SellerCrn／EbcProportion／FbaProportion／FbmProportion／AmazonSelfProportion に対応する絞り込み値は 0～1 の小数です。ユーザーに説明するときはパーセンテージに換算できます（例：0.4 を指定した場合、「商品集中度の上限は 40%」と表現できます）。レスポンスの data[] に「(%)」フィールドが含まれている場合、入力パラメーターの尺度と異なる可能性があるため、返された値に従ってください。
3. その他の比率や粗利益率などのフィールドの単位については、references/api.md を参照してください。
4. ユーザーが再現できるよう、絞り込み条件を再表示してください。
5. 結果が少なすぎる、または多すぎる場合は、主要なしきい値（集中度、規模のしきい値など）の調整を提案してください。

重要な制限事項

• 必須パラメーター：marketplace
• 1 ページあたり最大 200 件
• 過去の月の範囲はサードパーティの制限を受けます（通常は直近 24 か月）

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

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

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

フィードバック：

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

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

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