linkfox-sellersprite-traffic-keyword について
linkfox-sellersprite-traffic-keywordは、SellerSpriteを通じてAmazon商品のASIN流入キーワードを調べる商品リサーチ向けスキルです。マーケットプレイス、月、キーワード種別、コンバージョン種別で絞り込み、並べ替えやページ分割もできます。
主な機能
- 01ASINから流入キーワードを取得
- 02直近30日または指定月を検索
- 03流入種別とコンバージョン種別で絞り込み
- 04キーワードバッジで絞り込み
- 05結果の並べ替えとページ分割
活用シーン
- 01商品への流入を生むキーワードを調べる
- 02過去月のキーワード実績を確認
- 03自然検索やおすすめのバッジ語を絞る
- 04自然検索順位と広告掲載順位を比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/linkfox-sellersprite-traffic-keywordを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api.mdonboarding.mdscripts/onboarding.pysellersprite_traffic_keyword.py詳細
SellerSprite トラフィックキーワード
このスキルは、SellerSprite を介して Amazon ASIN のトラフィックキーワードリストを検索・分析するのに役立ちます。
基本概念
- ASIN 逆引きキーワード：商品 ASIN を入力として、その商品へのトラフィックを獲得しているキーワードのリストを確認します。
- トラフィック比率の種類（
trafficKeywordTypes）：主要トラフィックキーワード、正確なトラフィックキーワード、およびスキーマ内のpreciseLongTail（ツールの説明では「コンバージョン流出キーワード」）など。 - コンバージョンの種類（
conversionKeywordTypes）：コンバージョン優良キーワード、安定キーワード、流出キーワードなど。 - キーワードタグ（
badges）：自然検索キーワード、Amazon Choice 推奨キーワードなど。
呼び出し方法
- API エンドポイント：
POST /sellersprite/traffic/keyword（パラメーター／レスポンス／エラーコードの全容はreferences/api.mdを参照） - Python スクリプト：
python scripts/sellersprite_traffic_keyword.py '<JSON 参数>' [--inline] - コスト制限：このツールは計算リソースを消費します。同じセッション内で同じパラメーターの組み合わせは、デフォルトで 1 回のみ呼び出します。スクリプトには 24 時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードを自動で変更したり、ページを切り替えたり、郵便番号を変更して連続して試したりしてはいけません。検索を続ける必要がある場合は、追加のコストが発生することを先にユーザーに説明してください。
出力方針（スクリプトのデフォルト動作）：
- 常に完全なレスポンスを
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sellersprite-traffic-keyword-<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／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれる場合。
主なパラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| marketplace | string | はい | マーケットプレイス。デフォルトは US |
| asin | string | はい | 逆引きする商品 ASIN |
| month | string | いいえ | 過去の月。形式は yyyyMM。指定しない場合は直近 30 日 |
| page | integer | いいえ | ページ番号。デフォルトは 1 |
| size | integer | いいえ | 1 ページあたりの件数。デフォルトは 50、最大 100 |
| keyword | string | いいえ | キーワードで絞り込み |
| badges | string | いいえ | キーワードタグ。複数値はカンマ区切り |
| trafficKeywordTypes | string | いいえ | トラフィック比率の種類。複数値はカンマ区切り |
| conversionKeywordTypes | string | いいえ | コンバージョンの種類。複数値はカンマ区切り |
| orderField | string | いいえ | 並べ替えフィールド。デフォルトは rankPosition |
| orderDesc | boolean | いいえ | 降順にするかどうか。デフォルトは false |
使用例
{
"marketplace": "US",
"asin": "B0XXXXXXXXX",
"size": 50,
"orderField": "rankPosition",
"orderDesc": false
}
{
"marketplace": "US",
"asin": "B0XXXXXXXXX",
"month": "202507",
"trafficKeywordTypes": "primary,precise",
"conversionKeywordTypes": "excellent,stable",
"page": 1,
"size": 100
}
表示ルール
- 結果では、キーワード、自然検索順位、広告掲載順位、トラフィック比率の種類、コンバージョンの種類を優先して表示します。
- 検索期間（直近 30 日または過去の月）を明記します。
- ページ分けがある場合は、総件数と現在のページを伝えます。
- ユーザーから明示的に求められない限り、インターフェースと無関係な主観的な商業上の提案は出力しません。
重要な制限事項
- 必須パラメーター：
marketplace、asin - 1 ページあたり最大 100 件
- 過去の月を検索する場合は
yyyyMMを指定してください
計算リソース消費ルール
計算リソースを 15 消費します。
ユーザーは計算リソースの消費に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかはユーザーに判断してもらってください。
フィードバック：
次のいずれかに該当する場合は、フィードバック API を介してフィードバックを自動検出し、報告してください。
- このスキルに記載された機能または目的が、実際の動作と一致しない
- このスキルの結果がユーザーの意図と一致しない
- ユーザーがこのスキルに対して不満または称賛を表明する
- 改善できると思われる点がある
references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの作業の流れを妨げないでください。