linkfox-junglescout-keyword-by-keyword

Jungle Scout — キーワードを起点としたキーワード情報の拡張（Keyword by Keyword）

このスキルでは、Jungle Scout データソースを通じて、シードキーワードを検索ボリューム、トレンド、PPC 入札額、ランキング難易度などの競合指標を含む関連キーワードのリストに拡張します。10 の Amazon マーケットプレイスに対応しています。

主な概念

Jungle Scout Keyword by Keyword ツールは、Amazon キーワード調査の中核となるツールの 1 つです。シードキーワードを起点に、関連する多数のキーワードと競合指標を抽出します。主な用途は次のとおりです。

• キーワードの拡張／発見：コアキーワードを入力し、数百件の関連キーワードを取得して、商品リスティングのキーワードリストを拡充します
• ロングテールキーワードの抽出：minWordCount で 3 語以上のロングテールキーワードを絞り込み、競争が少なくコンバージョン率の高い機会を見つけます
• PPC 入札調査：完全一致／部分一致の PPC 入札額とブランド広告の入札額を確認し、広告予算を計画します
• 競争度の評価：easeOfRankingScore と organicProductCount に基づいて、キーワードのランキング難易度を判断します
• トレンド分析：月次トレンドと四半期トレンドの変化率を確認し、成長中のキーワードを特定します

データフィールド

出力フィールド（keywordInfoList）

項目	API 名	説明	例
キーワード	name	キーワード名	yoga mat thick
マーケットプレイス	country	マーケットコード	us
完全一致検索ボリューム	monthlySearchVolumeExact	月平均の完全一致検索ボリューム	45000
部分一致検索ボリューム	monthlySearchVolumeBroad	月平均の部分一致検索ボリューム	120000
月次トレンド	monthlyTrend	前月比の検索ボリューム変化率	15.3
四半期トレンド	quarterlyTrend	前四半期比の検索ボリューム変化率	-5.2
主要カテゴリー	dominantCategory	検索結果で最も大きな割合を占めるカテゴリー	Sports & Outdoors
関連性スコア	relevancyScore	シードキーワードとの関連性スコア	856
ランキング難易度	easeOfRankingScore	ランキングの容易さを示すスコア（高いほど容易）	3
自然検索商品数	organicProductCount	検索結果で自然検索順位を獲得している商品の数	342
広告商品数	sponsoredProductCount	検索結果に表示される広告商品の数	28
PPC 完全一致入札額	ppcBidExact	完全一致 PPC の推奨入札額（米ドル）	1.25
PPC 部分一致入札額	ppcBidBroad	部分一致 PPC の推奨入札額（米ドル）	0.89
ブランド広告入札額	spBrandAdBid	Sponsored Brand 広告の推奨入札額（米ドル）	2.50
推奨プロモーション	recommendedPromotions	推奨されるプロモーション用景品の数	150
消費トークン	costToken	今回の呼び出しで消費した token 数	1

対応マーケットプレイス

Amazon の 10 マーケットプレイスに対応しています：us（デフォルト）、uk、de、in、ca、fr、it、es、mx、jp。ユーザーがマーケットプレイスを指定しない場合は、us を使用します。

マーケットプレイス	marketplace 値	説明
米国	us	Amazon.com
英国	uk	Amazon.co.uk
ドイツ	de	Amazon.de
インド	in	Amazon.in
カナダ	ca	Amazon.ca
フランス	fr	Amazon.fr
イタリア	it	Amazon.it
スペイン	es	Amazon.es
メキシコ	mx	Amazon.com.mx
日本	jp	Amazon.co.jp

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-keyword-by-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、searchTerms（単一のシードキーワード文字列）。

API 呼び出しを作成する際の原則

1. マーケットプレイスの対応付け：ユーザーが「米国マーケットプレイス」と言った場合は us、「日本マーケットプレイス」の場合は jp、「ドイツマーケットプレイス」の場合は de を使用します。指定がない場合はデフォルトで us を使用します
2. シードキーワード：ユーザーが指定したキーワードをそのまま渡します（英語の小文字が望ましい）。単一のキーワードのみ対応しています
3. 結果数：デフォルトで返される結果数には上限があります。ユーザーがより多くの結果を必要とする場合は、needCount を設定します
4. 並べ替えの選択：デフォルトでは完全一致検索ボリュームの降順（-monthly_search_volume_exact）で並べ替えます。ユーザーの意図に応じて並べ替えフィールドを切り替えます
5. フィルター条件：min/max パラメーターを十分に活用して結果の範囲を絞り込み、無関係で質の低いキーワードが返されるのを避けます

よくあるクエリのシナリオ

1. シードキーワードを拡張 — 関連キーワードのリストを取得

{
  "marketplace": "us",
  "searchTerms": "yoga mat"
}

2. ロングテールキーワードを抽出（3 語以上）

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "minWordCount": 3,
  "needCount": 50
}

3. 競争の少ないキーワードを発見

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "maxOrganicProductCount": 200,
  "minMonthlySearchVolumeExact": 1000,
  "sort": "-ease_of_ranking_score"
}

4. 検索ボリュームの多いキーワードを絞り込み

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "minMonthlySearchVolumeExact": 10000,
  "sort": "-monthly_search_volume_exact",
  "needCount": 30
}

5. PPC 入札調査 — 部分一致入札額順に並べ替え

{
  "marketplace": "us",
  "searchTerms": "yoga mat",
  "minMonthlySearchVolumeExact": 500,
  "sort": "ppc_bid_broad",
  "needCount": 30
}

6. ドイツマーケットプレイスで部分一致検索ボリュームの多いキーワード

{
  "marketplace": "de",
  "searchTerms": "yogamatte",
  "minMonthlySearchVolumeBroad": 5000,
  "sort": "-monthly_search_volume_broad"
}

表示ルール

1. 表を優先：キーワード一覧は表で表示し、主な列としてキーワード、正確な検索ボリューム、広範囲の検索ボリューム、月次トレンド、PPCの完全一致入札額、ランキング難易度を含めます
2. 必要に応じて列を絞る：ユーザーの意図に応じて表示する列を決定します。PPC調査では入札額の列を重視し、キーワード拡張では検索ボリュームとトレンドを重視します
3. トレンドの表示：月次トレンドと四半期トレンドが正の値の場合は上昇↑、負の値の場合は下降↓と表示します
4. ランキング難易度の解釈：easeOfRankingScore は、1～3が難しい、4～6が中程度、7～10が簡単です
5. データの洞察：表の後に、高検索ボリュームのキーワードが集中するカテゴリーや、ロングテールキーワードの競争上の優位性など、簡潔なまとめを提示します
6. エラー処理：クエリに失敗した場合は、エラーレスポンスに基づいて原因を説明し、パラメーターの調整を提案します

重要な制限事項

• 1回につき1つのキーワード：searchTerms で指定できるシードキーワードは1つのみです。複数のキーワードを指定する場合は、分割して複数回呼び出す必要があります
• データ期間：検索ボリュームは月平均の推定値であり、リアルタイムデータではありません
• サイトの制限：対象はAmazonの10サイトのみで、オーストラリア、オランダなどは含まれません
• ソート項目は固定：事前定義されたソート項目のみサポートされ、任意の組み合わせによるソートには対応していません

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

適用対象 — キーワード拡張と競合分析：

ユーザーの発言	シナリオ
「このキーワードを拡張してください」	シードキーワードの拡張
「このキーワードに関連するキーワードはありますか」	関連キーワードの発掘
「ロングテールキーワードをいくつか探してください」	ロングテールキーワードの絞り込み（minWordCount ≥ 3）
「競争度の低いキーワードはありますか」	低競争キーワード（ランキング難易度と商品数で絞り込み）
「このキーワードのPPC入札額はいくらですか」	PPC入札データの検索
「検索ボリュームの大きい関連キーワード」	高検索ボリュームキーワードの絞り込み
「ドイツのサイトで関連キーワードはありますか」	米国以外のサイトでのキーワード拡張
「キーワード調査をしてください」	総合的なキーワード調査

適用対象外 — キーワード拡張の範囲外：

• キーワードの過去の検索ボリュームの推移（keyword-history ツールが必要です）
• ABA検索語のランキング（ABAツールが必要です）
• 商品検索またはリスティング分析
• Amazon以外のプラットフォームのキーワードデータ
• ASINからのキーワード逆引き

適用範囲の判断：「キーワード」「キーワード拡張」「キーワード調査」とユーザーが言い、シードキーワードを指標付きの関連キーワード一覧に拡張したい場合は、このスキルを適用します。単一キーワードの検索ボリュームの過去の推移を時系列で確認したい場合は、代わりに keyword-history スキルを使用します。

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

動的なルールに基づいて課金されます。計算リソースの消費量 = 実際のクエリページ数 × 63.75。

重要：このスキルのサービス料金は倍率に応じて動的に計算されるため、一度に大量の計算リソースを消費する可能性があります。必ずユーザーに通知し、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md の指定に従って Feedback API を呼び出します。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境ECスキルについては、LinkFox Skillsをご覧ください。