linkfox-sif-keyword-overview

SIF キーワード概要

このスキルでは、Amazon のキーワード単位の競合データを照会・分析する方法を説明します。販売者が特定のキーワードの市場競争力と需給動向を評価するのに役立ちます。

主な概念

SIF キーワード概要ツールは、Amazon の指定キーワードに関する競合指標を包括的に示します。掲載枠の種類（オーガニック、スポンサー広告、動画広告、ブランド広告など）ごとの競合商品の数、推定週間検索ボリューム、キーワードの人気ランキング、需給比率を返します。

需給比率：検索結果の商品総数 / 月間検索ボリューム で算出します。比率が低いほど競争が少なく、機会が大きいことを示します。これはブルーオーシャンキーワードを特定するための重要な指標です。

キーワード人気ランキング：月間検索ボリュームに基づき、マーケットプレイス内の全キーワードの中でこのキーワードが何位かを示します。数値が小さいほど検索人気が高くなります（1 位が最も人気です）。ユーザーが「ランキングが上がった」と言う場合は数値が下がったことを意味し、「ランキングが下がった」と言う場合は数値が上がったことを意味します。

データフィールド

フィールド	API 名	説明
キーワード	keyword	照会したキーワードのテキスト
キーワード人気ランキング	keywordPopularityRank	全キーワードにおける月間検索ボリュームの順位（数値が小さいほど人気が高い）
推定週間検索ボリューム	estimatedWeeklySearchVolume	Amazon での推定週間検索数
需給比率	supplyDemandRatio	商品数 / 月間検索ボリューム（数値が小さいほど競争が少ない）
検索結果の商品総数	totalSearchResultProductCount	このキーワードの検索結果に表示される商品総数（オーガニック + 広告 + おすすめ）
自然検索商品数	naturalSearchProductCount	オーガニック検索結果の商品数（広告を除く）
スポンサープロダクト（SP）数	sponsoredProductsCount	スポンサープロダクト広告を掲載している商品数
ブランド広告商品数	brandAdProductCount	ブランド広告を掲載している商品数
動画広告商品数	videoAdProductCount	動画広告を掲載している商品数
有料広告商品総数	paidAdvertisingProductCount	PPC 広告商品の合計（SP + ブランド + 動画など）
Amazon's Choice 商品数	amazonChoiceProductCount	Amazon's Choice バッジが付いた商品数
高評価商品数	topRatedProductCount	「高評価」おすすめセクションの商品数
検索おすすめ商品数	searchRecommendationProductCount	検索中に Amazon が推奨する商品数
編集部おすすめ商品数	editorialRecommendationsProductCount	「編集部のおすすめ」セクションの商品数
おすすめ非広告商品数	recNonadProductCount	非広告（オーガニックなおすすめ）に分類されたおすすめ枠の商品数
おすすめ広告商品数	recAdProductCount	広告に分類されたおすすめ枠の商品数
SIF 追跡対象の露出済み ASIN 数	trackedAsinTotalCount	SIF が何らかの露出スコア（自然検索／広告／おすすめ）で追跡した ASIN の重複を除いた数 — 上流フィールド totalAsinNum
マーケットプレイスのキーワード総数	totalMarketplaceKeywordCount	マーケットプレイス内のキーワード総数
データ期間開始日	dataPeriodStartDate	返されるデータの ABA 週の開始日（yyyy-MM-dd）
データ期間終了日	dataPeriodEndDate	返されるデータの ABA 週の終了日（yyyy-MM-dd）
データ更新時刻	keywordDataUpdateTime	このキーワードのデータが最後に更新された日時

対応マーケットプレイス

13 のマーケットプレイス：US（米国）、UK（英国）、DE（ドイツ）、CA（カナダ）、JP（日本）、FR（フランス）、ES（スペイン）、IT（イタリア）、MX（メキシコ）、AU（オーストラリア）、AE（アラブ首長国連邦）、BR（ブラジル）、SA（サウジアラビア）。

デフォルトのマーケットプレイスは US です。ユーザーがマーケットプレイスを指定しない場合は、US を使用します。このリストにないコードは、API のパターンによって拒否されます。

重要：keyword パラメーターには、対象マーケットプレイスの言語を使用するのが理想的です。たとえば、DE にはドイツ語のキーワード、JP には日本語のキーワードを使用します。ユーザーが別の言語でキーワードを指定した場合は、照会する前にマーケットプレイスの現地語に翻訳してください。

呼び出し方法

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

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

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

パラメーターガイド

1. keyword（必須）：分析する検索キーワードです。最適な結果を得るには、対象マーケットプレイスの言語に翻訳してください。最大長：1000 文字。
2. country（任意）：Amazon マーケットプレイスのコードです。デフォルトは US です。有効なコードについては、上記の「対応マーケットプレイス」を参照してください。
3. last7d（任意、ブール値、デフォルトは true）：直近 7 日間を使用します。false の場合、API は startDate／endDate を使用します。
4. startDate（任意、yyyy-MM-dd）：カスタム期間の開始日です。last7d=false の場合に有効になります。
5. endDate（任意、yyyy-MM-dd）：startDate と組み合わせて指定する終了日です。

使用例

1. キーワードの競合状況の基本確認 クエリ：「Amazon US でキーワード『wireless charger』の競争はどの程度激しいですか？」

{"keyword": "wireless charger", "country": "US"}

2. 米国以外のマーケットプレイスでの競争状況の確認 クエリ：「Amazon ドイツで『Handyhulle』の競合は何社ありますか？」

{"keyword": "Handyhulle", "country": "DE"}

3. 商品調査のための需給分析 クエリ：「米国で『yoga mat』の需給比率はどのくらいですか？」

{"keyword": "yoga mat", "country": "US"}

4. 広告競争状況の評価 クエリ：「英国で『dog leash』に広告を出している販売者は何人いますか？」

{"keyword": "dog leash", "country": "UK"}

5. 複数マーケットプレイスの比較（複数回呼び出し） クエリ：「US、UK、DE で『bluetooth speaker』の競争状況を比較してください」

• 呼び出し 1：{"keyword": "bluetooth speaker", "country": "US"}
• 呼び出し 2：{"keyword": "bluetooth speaker", "country": "UK"}
• 呼び出し 3：{"keyword": "Bluetooth Lautsprecher", "country": "DE"}

6. 特定の日付範囲 クエリ：「2026-03-08 から 2026-03-14 までの『yoga mat』の競争状況」

{"keyword": "yoga mat", "country": "US", "last7d": false, "startDate": "2026-03-08", "endDate": "2026-03-14"}

表示ルール

1. データを明確に提示する：クエリ結果は、構造化された表形式で表示します。ユーザーが求めた関連指標をすべて含めてください。
2. 重要な指標を強調する：結果を表示する際は、需要と供給の比率、キーワード人気度ランキング、商品総数を強調してください。これらは特に実用性の高い指標です。
3. ランキングの補足：キーワード人気度ランキングを表示する際は、数値が小さいほど検索人気度が高いことをユーザーに伝えてください。
4. 需要と供給の解釈：需要と供給の比率を表示する際は、その意味を補足してください。1 未満は供給に対して需要が高いこと（機会）を示し、5 を超える値は市場が飽和していることを示します。
5. 広告競争の内訳：ユーザーが広告競争について尋ねた場合は、広告数の合計を構成要素（SP、Brand、Video）に分けて、より詳しく表示してください。
6. エラー処理：クエリが失敗した場合は、msg フィールドに基づいて理由を説明し、クエリパラメーターの調整（例：キーワードのスペルを確認する、別のマーケットプレイスを試す）を提案してください。
7. データの鮮度と期間：必ず keywordDataUpdateTime（最終更新日時）と dataPeriodStartDate ～ dataPeriodEndDate（件数が対象とする ABA の週）を表示してください。期間を明示せずに商品数を表示してはいけません。
8. 主観的な助言を避ける：特に求められない限り、ビジネス上の推奨事項は提示せず、データを客観的に表示してください。

重要な制限事項

• 1 回のリクエストにつきキーワードは 1 つ：各 API 呼び出しでクエリできるキーワードは 1 つです。複数のキーワードを比較する場合は、個別に呼び出してください。
• 応答レコードは 1 件：API は通常、キーワードごとに 1 件のデータレコードを返します（total は通常 1 です）。
• マーケットプレイスの対応状況：Amazon の 13 のマーケットプレイスに対応しています。IN／NL／SE／PL／TR／SG は現在サポートされていません。クエリ対象のマーケットプレイスで見つからないキーワードは、空の結果を返します。
• 期間：デフォルトでは直近 7 日間です。カスタム ABA 週の期間を指定するには、last7d=false に加えて startDate／endDate を渡してください。
• キーワードの言語：最も正確な結果を得るには、キーワードを対象マーケットプレイスの現地語にしてください。

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

該当する -- キーワードレベルの競争状況と市場評価：

ユーザーの発言	シナリオ
「XX キーワードの競争はどの程度ですか」	競争の激しさの確認
「XX の商品はいくつありますか」	検索結果の商品数
「XX の需要と供給の比率はどれくらいですか」	需要と供給の分析
「XX に広告を出しているセラーは何人いますか」	広告競争の評価
「XX キーワードはブルーオーシャンですか」	市場機会の評価
「XX キーワードの検索ボリューム」	検索人気度の推定
「Amazon で XX キーワードはどれくらい人気ですか」	キーワード人気度ランキング
「マーケットプレイス間の競争を比較してください」	複数マーケットプレイス間の競争比較
「このキーワードで SIF が追跡している有効な ASIN はいくつありますか」	重複を除いた追跡対象 ASIN 数（trackedAsinTotalCount）
「特定の週におけるこのキーワードの競争状況」	startDate／endDate によるカスタム日付範囲

該当しない -- キーワード競争の概要を超える情報が必要な場合：

• キーワードランキングの経時的な履歴（代わりに ABA Data Explorer を使用）
• ASIN 別のクリックシェアとコンバージョンシェア（代わりに ABA Data Explorer を使用）
• 広告入札戦略と PPC の最適化
• 商品レビュー、商品リスティングの最適化
• ASIN レベルの売上推定
• 数週間／数か月にわたる詳細なキーワード検索トレンド分析

コンピューティングリソースの消費ルール

コンピューティングリソースを 9 消費します。

ユーザーはコンピューティングリソースの消費に応じて料金を支払います。十分にご検討ください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが消費量を十分に把握していない場合は、必ずユーザーに通知し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

より高品質でプロフェッショナルな越境ECスキルを利用するには、LinkFox Skills を設定してください。