linkfox-junglescout-keyword-share-of-voice

Jungle Scout — キーワードの市場シェア Share of Voice

このスキルは、Jungle Scout のデータソースを通じて Amazon キーワードの Share of Voice（SOV）データを照会し、Amazon の 10 のマーケットプレイスにおける検索結果の最初の 3 ページでのブランドの可視性の分布と、検索ボリューム、PPC 入札額の推定値、クリック数・コンバージョン指標が上位の ASIN を返します。

基本概念

Share of Voice は、特定のキーワードの検索結果内でブランドが占める割合を測定します。Jungle Scout は Amazon の検索結果の最初の 3 ページを分析し、次の 3 つの観点から各ブランドの存在感を算出します。

• オーガニック SOV：オーガニック（スポンサー広告ではない）検索結果の掲載順位におけるブランドの可視性
• スポンサー SOV：スポンサー広告の掲載枠におけるブランドの可視性
• 合計 SOV：オーガニック検索結果とスポンサー広告の両方を合わせた、ブランドの全体的な可視性

各観点には、2 つの計算方法があります。

• 基本 SOV：単純な商品数の比率 — ブランドの商品数 ÷ 3 ページ内の全商品数
• 加重 SOV：上位の掲載順位や Amazon's Choice バッジなどを考慮して、上位の掲載順位により大きな重みを付けた比率です。競合分析ではこちらの指標がより有用です

このツールは、次の情報も返します。

• 過去 30 日間の正確な検索ボリューム：過去 30 日間の推定検索総数
• PPC 入札額の中央値：広告費用の推定に役立つ、このキーワードの推奨入札額の中央値
• 上位 3 件の ASIN のクリック数・コンバージョンデータ：クリック数上位 3 件の ASIN と、クリック数、コンバージョン数、コンバージョン率

データフィールド

brands（ブランド別 SOV 内訳）

フィールド	API 名	説明	例
ブランド名	brand	検索結果に表示されるブランド名	Anker
オーガニック商品数	organicProducts	最初の 3 ページに掲載されているオーガニック商品の数	5
スポンサー商品数	sponsoredProducts	スポンサー広告商品の数	3
合計商品数	combinedProducts	商品の合計数（オーガニック＋スポンサー広告）	8
オーガニック基本 SOV	organicBasicSov	オーガニックの単純比率（0–1）	0.083
オーガニック加重 SOV	organicWeightedSov	オーガニックの掲載順位加重比率（0–1）	0.112
スポンサー基本 SOV	sponsoredBasicSov	スポンサー広告の単純比率（0–1）	0.15
スポンサー加重 SOV	sponsoredWeightedSov	スポンサー広告の掲載順位加重比率（0–1）	0.18
合計基本 SOV	combinedBasicSov	合計の単純比率（0–1）	0.133
合計加重 SOV	combinedWeightedSov	合計の掲載順位加重比率（0–1）	0.152
オーガニック平均掲載順位	organicAveragePosition	オーガニック検索結果での平均掲載順位	12.4
スポンサー平均掲載順位	sponsoredAveragePosition	スポンサー広告での平均掲載順位	5.0
合計平均掲載順位	combinedAveragePosition	すべての検索結果での平均掲載順位	9.5
オーガニック平均価格	organicAveragePrice	オーガニック商品の平均価格	29.99
スポンサー平均価格	sponsoredAveragePrice	スポンサー商品の平均価格	25.99
合計平均価格	combinedAveragePrice	すべての商品の平均価格	28.49

topAsins（クリック数・コンバージョン数上位 3 件の ASIN）

フィールド	API 名	説明	例
ASIN	asin	Amazon 標準識別番号	B09V3KXJPB
商品名	name	商品タイトル	Anker Portable Charger...
ブランド	brand	商品ブランド	Anker
クリック数	clicks	クリック数（30 日間）	15200
コンバージョン数	conversions	コンバージョン数（30 日間）	4560
コンバージョン率	conversionRate	コンバージョン率（0–1）	0.30

トップレベルのサマリーフィールド

フィールド	API 名	説明	例
ID	id	リソース識別子	—
タイプ	type	固定値	share_of_voice
30 日間の検索ボリューム	estimated30DaySearchVolume	30 日間の正確な検索ボリューム	125000
PPC 入札額の中央値	exactSuggestedBidMedian	推奨 PPC 入札額の中央値（USD）	1.25
商品数	productCount	最初の 3 ページにある商品の合計数	60
更新日時	updatedAt	データの鮮度を示すタイムスタンプ	2026-04-10T00:00:00
上位 ASIN の開始日	topAsinsModelStartDate	クリック／コンバージョンデータの対象期間の開始日	2026-03-11
上位 ASIN の終了日	topAsinsModelEndDate	クリック／コンバージョンデータの対象期間の終了日	2026-04-10
コストトークン	costToken	この呼び出しで消費されるトークン数	1

対応マーケットプレイス

us（アメリカ）、uk（イギリス）、de（ドイツ）、in（インド）、ca（カナダ）、fr（フランス）、it（イタリア）、es（スペイン）、mx（メキシコ）、jp（日本）

デフォルトのマーケットプレイスは us です。ユーザーがマーケットプレイスを指定しない場合は、us を使用してください。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-keyword-share-of-voice-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）。
• レスポンス本文が 8 KB 以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します。
• レスポンス本文が 8 KB を超える場合：ファイルに保存した後、stdout にはサマリーのみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）。
• --inline を付けると、完全な内容を stdout に強制的に出力します（同様にファイルにも保存します）。

データの読み取りに関する推奨事項：まずサマリーを確認して、十分な情報があるか判断してください。具体的なフィールドが必要な場合は、JSON 全体をコンテキストに読み込むのを避けるため、保存された JSON ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出してください。

認証と計算リソースの問題を解決する

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」または同様の意味の内容が含まれている場合。

クエリの作成方法

必要なパラメーターは marketplace と keyword の 2 つだけです。

API 呼び出しの作成原則

1. マーケットプレイスの対応付け：「アメリカのマーケットプレイス」→ us、「日本のマーケットプレイス」→ jp、「ドイツのマーケットプレイス」→ de。指定がない場合は us を使用してください。
2. キーワード：ユーザーのキーワードをそのまま渡してください（英語の場合は小文字を推奨）。
3. 1 回の呼び出しにつき 1 キーワード：各リクエストで分析するキーワードは 1 つです。複数のキーワードを比較する場合は、個別に呼び出してください。

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

1. ブランドの優勢状況を確認する — このキーワードを支配しているのはどのブランドですか？

{
  "marketplace": "us",
  "keyword": "portable charger"
}

検索結果ページでどのブランドが優勢かを確認するには、combinedWeightedSov に注目してください。

2. PPC 競合分析 — このキーワードに入札する価値はありますか？

{
  "marketplace": "us",
  "keyword": "wireless earbuds"
}

費用対効果を見極めるため、exactSuggestedBidMedian とキーワードの検索ボリュームを比較してください。競合が広告にどれほど投資しているかは、sponsoredWeightedSov で確認してください。

3. 上位 ASIN のコンバージョン効率

{
  "marketplace": "de",
  "keyword": "kopfhörer kabellos"
}

topAsins 配列を調べて、クリック数上位の商品がどの程度コンバージョンにつながっているかを確認してください。クリック数が多くコンバージョン率が低い場合は、機会がある可能性を示します。

4. 市場の隙間を特定する — 十分に対応されていない掲載位置はありますか？

{
  "marketplace": "jp",
  "keyword": "ヨガマット"
}

combinedWeightedSov が 0.15 を超えるブランドが 1 つもない場合、そのキーワードは分散しており、参入しやすい可能性があります。検索ボリュームと組み合わせて、市場規模を評価してください。

5. オーガニックとスポンサー広告の掲載状況を比較する

{
  "marketplace": "uk",
  "keyword": "running shoes"
}

sponsoredWeightedSov が高く organicWeightedSov が低いブランドは、広告に大きく依存しています。この情報は競争戦略の策定に役立ちます。

表示ルール

1. ブランドテーブル：combinedWeightedSov の降順でブランドテーブルを表示し、すぐに把握できるように上位 5 ブランドを強調表示します
2. SOV をパーセンテージで表示：SOV の値に 100 を掛けてパーセンテージで表示します。例：0.152 → 15.2%
3. コンテキストヘッダー：テーブルの前に、キーワードの 30 日間検索ボリューム（estimated30DaySearchVolume）と PPC 入札額の中央値（exactSuggestedBidMedian）をコンテキスト情報として表示します
4. 上位 ASIN セクション：上位 3 件の ASIN のテーブルを分けて表示し、クリック数、コンバージョン数、コンバージョン率を示します
5. 競合状況の概要：データの後に、少数のブランドがキーワードを独占しているのか、競争が分散しているのかを簡潔にまとめます。また、オーガニックとスポンサー枠の露出に大きな差があれば、その点も記載します
6. エラー処理：クエリが失敗した場合、エラーレスポンスに基づいて理由を説明し、パラメーターの調整を提案します

重要な制限事項

• 対象範囲：Amazon 検索結果の最初の 3 ページのみを分析します（通常、約 48～60 件の商品）
• 単一キーワード：API 呼び出し 1 回につき 1 キーワードです。複数キーワードを比較するには、個別に呼び出す必要があります
• SOV はスナップショット：データは特定時点のクロール結果であり、過去の傾向を示すものではありません
• 過去の SOV は取得不可：このツールでは、SOV の経時的な変化は取得できません。検索ボリュームの傾向を確認するには、キーワード履歴ツールを使用してください

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

該当するケース — Amazon の検索結果におけるブランドの市場シェアと競合分析：

ユーザーの発言	シナリオ
「这个词谁占的份额最大」	ブランドの優位性分析
「这个关键词竞争激不激烈」	競争状況の評価
「广告位都被谁占了」	スポンサー枠の SOV 分析
「有没有品牌垄断这个词」	独占状態の検出
「这个词的PPC出价大概多少」	PPC 入札額の推定
「搜索结果里哪些品牌排前面」	ブランドの露出順位
「这个词的转化率高不高」	上位 ASIN のコンバージョン分析

該当しないケース — キーワードのシェア・オブ・ボイスの範囲外：

• 過去の検索ボリュームの傾向（キーワード履歴ツールを使用してください）
• キーワードの候補表示／キーワードの発掘（ABA またはキーワードエクスプローラーツールを使用してください）
• 商品単位の売上推定やレビュー分析
• 商品リスティングの最適化やコピーライティングのアドバイス
• Amazon 以外のプラットフォームのデータ

適用範囲の判断：「竞争分析」「品牌分析」「市场格局」といったユーザーの意図が、特定のキーワードの検索結果ページをどのブランドが占めているか（シェア・オブ・ボイス／ブランドの分布）を知ることであれば、このスキルが該当します。商品単位の売上データ、利益率、または過去の傾向を求めている場合は該当しません。

算力消耗规则

64 算力を消耗します。

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

フィードバック：

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

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

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

---

高品質で専門的な越境 EC スキルについては、LinkFox Skills をご覧ください。