linkfox-junglescout-keyword-by-asin

Jungle Scout — ASIN によるキーワード逆引き

このスキルは、Jungle Scout のデータソースを通じて、指定された ASIN に関連するキーワードを検索し、10 の Amazon マーケットプレイスにおけるキーワードの検索ボリューム、競合指標、PPC 入札額、ランキング順位、関連度スコアを返します。1 回の呼び出しで最大 10 個の ASIN に対応します。

コアコンセプト

Jungle Scout ASIN キーワード逆引きツールは、競合または対象の ASIN を入力すると、Amazon の検索結果に表示されるそれらの ASIN のキーワードすべてと詳細指標を取得します。販売者はこのツールを次の用途に活用できます。

• 競合キーワード分析：競合がどのキーワードで自然検索／広告のランキングを獲得しているかを確認します
• キーワードの拡張：既知の ASIN から、潜在力の高いキーワードを逆引きします
• 広告出稿の参考：キーワードの PPC 入札額（完全一致／部分一致）と SP ブランド広告の入札額を取得します
• 競合状況の評価：Ease of Ranking Score と競合のランキングデータから、キーワードの競争難易度を判断します
• トラフィック構造の分析：ASIN のトラフィックがどのキーワードから来ているか、各キーワードの検索ボリュームとランキングを確認します

データの指標：各レコードは 1 つのキーワードを表し、検索ボリューム、トレンド、ランキング、入札額、競合度などの指標一式が含まれます。

データフィールド

出力フィールド

フィールド	API 名	説明	例
キーワード	name	検索キーワード	yoga mat
マーケットプレイス	country	市場コード	us
完全一致検索ボリューム	monthlySearchVolumeExact	月間完全一致検索ボリューム	85420
部分一致検索ボリューム	monthlySearchVolumeBroad	月間部分一致検索ボリューム	125000
月次トレンド	monthlyTrend	前月比トレンド（%）	15.5
四半期トレンド	quarterlyTrend	四半期トレンド（%）	8.2
主要カテゴリ	dominantCategory	キーワードの主要カテゴリ	Sports & Outdoors
関連度	relevancyScore	キーワードと ASIN の関連度（0～100）	92
ランキング難易度	easeOfRankingScore	ランキングの上がりやすさ（0～100。高いほど容易）	45
自然検索ランキング	organicRank	ASIN の自然検索ランキング	5
広告ランキング	sponsoredRank	ASIN の広告ランキング	3
総合ランキング	overallRank	総合ランキング順位	4
自然検索結果数	organicProductCount	自然検索結果の商品総数	2000
広告結果数	sponsoredProductCount	広告枠の商品総数	48
PPC 完全一致入札額	ppcBidExact	完全一致 PPC の推奨入札額（USD）	1.25
PPC 部分一致入札額	ppcBidBroad	部分一致 PPC の推奨入札額（USD）	0.95
SP ブランド広告入札額	spBrandAdBid	SP ブランド広告の推奨入札額（USD）	2.10
推奨プロモーション数	recommendedPromotions	推奨プロモーション数	5
主要 ASIN	primaryAsin	このキーワードで最も高いランキングを持つ ASIN	B0XXXXXXXX
自然検索の相対位置	relativeOrganicPosition	検索対象 ASIN の自然検索ランキングの相対位置	0.12
広告の相対位置	relativeSponsoredPosition	検索対象 ASIN の広告ランキングの相対位置	0.08
自然検索ランキング ASIN 数	organicRankingAsinsCount	自然検索ランキングを持つ検索対象 ASIN の数	3
広告ランキング ASIN 数	sponsoredRankingAsinsCount	広告ランキングを持つ検索対象 ASIN の数	2
競合の平均自然検索ランキング	avgCompetitorOrganicRank	検索対象 ASIN の平均自然検索ランキング	12.5
競合の平均広告ランキング	avgCompetitorSponsoredRank	検索対象 ASIN の平均広告ランキング	8.3
バリエーションの最良自然検索ランキング	variationLowestOrganicRank	バリエーション内の最良自然検索ランキング	3
バリエーションの最良広告ランキング	variationLowestSponsoredRank	バリエーション内の最良広告ランキング	2
競合の自然検索ランキング詳細	competitorOrganicRank	各 ASIN の自然検索ランキング配列	[{asin, organicRank}]
競合の広告ランキング詳細	competitorSponsoredRank	各 ASIN の広告ランキング配列	[{asin, sponsoredRank}]
更新日時	updatedAt	データの最終更新日時	2026-04-10
消費トークン数	costToken	今回の呼び出しで消費したトークン数	10

対応マーケットプレイス

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

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

呼び出し方法

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

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

• 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-junglescout-keyword-by-asin-<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 キーが未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高が不足しているというレスポンス：メッセージに「计算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值」、または類似の意味を持つ内容が含まれています。

クエリの作成方法

必須パラメーターは marketplace と asins です。その他のパラメーターはすべて、結果を絞り込むための任意のフィルターです。

API 呼び出しの構築原則

1. マーケットプレイスのマッピング：ユーザーが「米国マーケットプレイス」と言った場合は us、「日本マーケットプレイス」は jp、「ドイツマーケットプレイス」は de に対応します。指定がない場合は、デフォルトで us を使用します
2. ASIN の形式：標準的な10桁の Amazon ASIN（B0 で始まるもの）を配列で渡します。最大10個です
3. 検索ボリュームによる絞り込み：ユーザーが「検索ボリュームが1万を超える」と言った場合は minMonthlySearchVolumeExact: 10000、「検索ボリュームが1000から5000」と言った場合は min: 1000, max: 5000 を指定します
4. 並べ替えの選択：デフォルトでは、正確な検索ボリュームの降順（-monthly_search_volume_exact）で並べ替えます。ユーザーが「関連度順」と指定した場合は sort: -relevancy_score を指定します
5. 結果数：ユーザーが「上位50件を表示して」と言った場合は needCount: 50 を指定します。指定がない場合は、状況に応じて適切な数（例：30～100）を設定できます
6. バリエーションを含める：ユーザーがバリエーションのトラフィックを確認したい場合は、includeVariants: true を設定します

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

1. 競合 ASIN の主要なトラフィックキーワードを確認する

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "needCount": 50,
  "sort": "-monthly_search_volume_exact"
}

2. 複数の ASIN に共通するキーワード（競合比較）

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX", "B0YYYYYYYY", "B0ZZZZZZZZ"],
  "needCount": 100,
  "sort": "-relevancy_score"
}

3. 検索ボリュームが多く、競争が少ないキーワードを絞り込む

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "minMonthlySearchVolumeExact": 5000,
  "maxOrganicProductCount": 500,
  "needCount": 50,
  "sort": "-ease_of_ranking_score"
}

4. ロングテールキーワードを探す（複数語の組み合わせ）

{
  "marketplace": "us",
  "asins": ["B0XXXXXXXX"],
  "minWordCount": 3,
  "minMonthlySearchVolumeExact": 500,
  "needCount": 80,
  "sort": "-monthly_search_volume_exact"
}

5. 日本マーケットプレイスで競合の広告キーワードを分析する

{
  "marketplace": "jp",
  "asins": ["B0XXXXXXXX"],
  "needCount": 50,
  "sort": "-ppc_bid_exact"
}

6. バリエーションを含むすべてのキーワードを抽出する

{
  "marketplace": "de",
  "asins": ["B0XXXXXXXX"],
  "includeVariants": true,
  "needCount": 200,
  "sort": "-monthly_search_volume_exact"
}

表示ルール

1. 表形式での表示を基本とする：キーワード一覧は表形式で表示します。主要な列は、キーワード、正確な検索ボリューム、オーガニック順位、広告順位、関連度、PPC 入札額です
2. 必要に応じて列を絞り込む：ユーザーの意図に応じて表示する列を選びます。競合分析では順位と検索ボリュームを重視し、広告分析では PPC 入札額と広告順位を重視します
3. 順位の強調表示：オーガニック順位が上位10位以内、広告順位が上位5位以内のキーワードに印を付け、主要なトラフィックキーワードをすばやく見分けられるようにします
4. 傾向の表示：月次または四半期の傾向がプラスの場合は増加、マイナスの場合は減少と表示します
5. 競合比較：複数の ASIN が入力された場合は、各 ASIN のキーワードごとの順位を比較して表示します
6. エラー処理：クエリが失敗した場合は、エラーレスポンスに基づいて理由を説明し、パラメーターの調整を提案します

重要な制限事項

• ASIN 数の上限：1回のクエリにつき、ASIN は最大10個です
• データの鮮度：データは定期的に更新され、updatedAt フィールドに最終更新日時が記録されます
• 検索ボリュームの種類：完全一致と部分一致の2種類の検索ボリュームが提供されます
• 必須パラメーター：marketplace と asins の両方が必要です
• 順位データ：順位は、該当するキーワードの検索結果における ASIN の位置を示すもので、リアルタイムデータではありません

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

適用対象 - ASIN によるキーワードの逆引きと拡張：

ユーザーの発言	シナリオ
「このASINにはどんなトラフィックキーワードがありますか」	単一 ASIN のキーワード逆引き
「競合はどんなキーワードを使っていますか」	競合キーワード分析
「これらのASINのキーワードを比較してください」	複数 ASIN のキーワード比較
「この商品はどんなキーワードで検索すると見つかりますか」	ASIN の逆引き検索語句の照会
「検索ボリュームが多く、競争が少ないキーワードを探してください」	検索ボリュームが多く、競争が少ないキーワードの絞り込み
「このASINの広告キーワードは何ですか」	ASIN の広告キーワード分析
「キーワードを拡張してください」	ASIN に基づくキーワード拡張

適用対象外 - ASIN によるキーワード逆引きの範囲外：

• キーワード検索ボリュームの過去の傾向（キーワードの過去の検索ボリュームを調べるツールが必要です）
• ABA 検索語句ランキング（ABA ツールが必要です）
• 商品販売数の推定、出品情報の最適化提案
• キーワード広告の出稿実行（入札の参考データのみ提供します）
• Amazon 以外のプラットフォームのキーワードデータ

適用範囲の判断：ユーザーが「キーワード」「トラフィックキーワード」「検索語句」と言い、特定の ASIN を提示して、その ASIN がどのキーワードでランクインしているかを知りたい場合、このスキルが適用されます。テキストからキーワードを検索したい場合や、検索ボリュームの過去の傾向を確認したい場合は、他のスキルが適しています。

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

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

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

フィードバック：

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

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

references/api.md に記載されている手順に従って Feedback API を呼び出してください。ユーザーの操作を妨げないでください。

---

越境EC向けの高品質で専門的なスキルをさらにご覧になるには、LinkFox Skills にアクセスしてください。