linkfox-sif-keyword-traffic

SIF キーワードトラフィックソースの概要

このスキルでは、Amazon 商品のキーワードトラフィックソースデータを照会・分析する方法を紹介します。出品者が、オーガニック検索、スポンサープロダクト（SP）広告、ブランド広告、動画広告、さまざまな Amazon のレコメンド掲載枠など、キーワードの背後にあるトラフィック構造を把握できるよう支援します。

主な概念

SIF Keyword Summary ツールは、指定したキーワードについて、そのキーワードに表示される ASIN の一覧と、キーワード単位のトラフィック露出の内訳、および商品単位のチャネル横断トラフィック構成を返します。つまり、**このキーワードのトラフィックを獲得しているのは誰で、どのチャネルを通じているのか？**に答えます。

分析対象のトラフィックチャネル：

• 自然検索 — オーガニック検索結果の掲載順位
• SP 広告（スポンサープロダクト） — 有料商品広告の掲載枠（通常枠）
• ブランド広告（SB） — 検索結果ページ上部および下部のブランド広告掲載枠
• 動画広告（SBV） — スポンサーブランド動画の掲載枠
• SP レコメンド枠 — 急上昇中／ソーシャルメディアで話題／お客様がよく閲覧している商品／星4つ以上
• Amazon's Choice（AC） — Amazon's Choice バッジのレコメンド
• 編集者によるおすすめ（ER） — 編集者が選定したレコメンド掲載枠
• 高評価（TR） — 高評価商品のレコメンド掲載枠

2 種類のスコア群（重要 — 混同しないでください）：

1. 商品単位のフィールド（接頭辞なし。例：naturalSearchExposureScore）：すべてのキーワードにおける ASIN 全体の露出度です。
2. キーワード単位のフィールド（keyword… 接頭辞。例：keywordNaturalExposureScore）：今回照会したキーワードのみでの ASIN の露出度です。

パラメーターガイド

必須パラメーター

パラメーター	型	説明
searchKeyword	文字列	分析する検索キーワードです。必要に応じて、対象マーケットプレイスの言語に翻訳してください。最大1000文字です。

オプションのパラメーター

パラメーター	型	デフォルト	説明
country	文字列	US	マーケットプレイスコード（13か所に対応 — 以下の一覧を参照）。
asins	文字列	（なし）	ASIN のカンマ区切りフィルターです。指定しない場合、キーワードに表示されるすべての ASIN を返します。最大1000文字です。
condition	文字列	（なし）	特定のトラフィックソースで絞り込みます。1リクエストにつき1つの値のみ指定できます。以下の「Condition フィルター」を参照してください。
last7d	ブール値	true	直近7日間を使用します。false の場合、API は startDate／endDate を使用します。
startDate	文字列	—	yyyy-MM-dd。last7d=false の場合に有効です。省略すると、システムの直近の完全な週が使用されます。
endDate	文字列	—	yyyy-MM-dd。startDate と組み合わせて使用します。
sortBy	文字列	（デフォルト）	ソートフィールドです。以下の「sortBy」セクションを参照してください。
pageNum	整数	1	ページネーションのページ番号です。
pageSize	整数	100	1ページあたりの結果数です。最小10、最大100です。
desc	ブール値	true	降順でソートします。

対応マーケットプレイス

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

デフォルトのマーケットプレイスは US です。この一覧にないコードは、API のパターンチェックにより拒否されます。

条件フィルター

各リクエストに含められる条件フィルターは1つまでです。フラグ形式：

値	意味
nfPosition	自然検索トラフィックのキーワード
isSpAd	SP 広告のキーワード
isVedioAd	動画広告のキーワード
isBrandAd	ブランド広告のキーワード
isPPCAd	PPC 広告のキーワード（すべての有料広告タイプ）
isSearchRecommend	検索レコメンドのキーワード
acAd	SP レコメンド（「Trending now」／「Customers frequently viewed」など）

期間カウントフィルター（.total は全件／.in は期間内の新規）：

値	意味
totalPeriod.in	期間内に新たに流入したトラフィックキーワード
nfKeywordCnt.total / nfKeywordCnt.in	オーガニック露出がある（新規）キーワード
adKeywordCnt.total / adKeywordCnt.in	広告露出がある（新規）キーワード
allSpKeywordCnt.total / allSpKeywordCnt.in	（新規）SP 広告キーワード（通常＋レコメンド）
spKeywordCnt.total / spKeywordCnt.in	（新規）SP 通常キーワード
recSpKeywordCnt.total / recSpKeywordCnt.in	（新規）SP レコメンドキーワード
allSbKeywordCnt.total / allSbKeywordCnt.in	（新規）SB 広告キーワード
sbKeywordCnt.total / sbKeywordCnt.in	（新規）SB 通常キーワード
sbvKeywordCnt.total / sbvKeywordCnt.in	（新規）SBV キーワード

sortBy

システムのデフォルトを使用する場合は空欄にします。有効な値：

totalKeywordNum（キーワード総数）、naturalKeywordNum、brandKeywordNum、vedioKeywordNum、acKeywordNum、erKeywordNum、trKeywordNum、sumScore（全キーワードの総露出数）、totalNfScore、totalSpSocre（スペルに注意）、totalBrandScore、totalVedioScore、totalAcScore、totalTrScore、totalErScore。

API の使用方法

このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し規約、リクエストパラメーター、レスポンス構造については references/api.md を参照してください。scripts/sif_keyword_traffic.py を直接実行してクエリを実行することもできます。

使用例

1. キーワードトラフィックの基本概要 米国のマーケットプレイスで、キーワードのトラフィックソースの内訳をクエリします：

searchKeyword: "wireless charger", country: "US"

2. オーガニック検索トラフィックのみを絞り込む キーワードの自然検索結果に表示される ASIN のみを確認します：

searchKeyword: "wireless charger", country: "US", condition: "nfPosition"

3. SP 広告の競合状況を分析する キーワードに対して SP 広告を掲載している ASIN を特定します：

searchKeyword: "wireless charger", country: "US", condition: "isSpAd"

4. SP レコメンド枠 SP レコメンド枠（「Trending now」、「Customers frequently viewed」など）に表示される ASIN を特定します：

searchKeyword: "wireless charger", country: "US", condition: "acAd"

5. 米国以外のマーケットプレイスでキーワードを分析する 日本のマーケットプレイスでトラフィックソースを分析します（現地語のキーワードを使用してください）：

searchKeyword: "ワイヤレス充電器", country: "JP"

6. 特定の競合 ASIN に絞り込む 結果を少数の競合 ASIN に絞り込みます：

searchKeyword: "wireless charger", country: "US", asins: "B01NBNDC1T,B09VLJJPL6"

7. カスタムの日付範囲

searchKeyword: "wireless charger", country: "US", last7d: false, startDate: "2026-04-05", endDate: "2026-04-11"

8. 全体的な SP 露出数で ASIN をランク付けする

searchKeyword: "wireless charger", country: "US", sortBy: "totalSpSocre", desc: true

9. 期間内に新たに流入したトラフィックキーワード

searchKeyword: "wireless charger", country: "US", condition: "totalPeriod.in"

表示ルール

1. データを明確に提示する：クエリ結果は、構造化された表で表示してください。比較しやすいように、トラフィックチャネルの露出比率ごとにデータをまとめてください。
2. 商品レベルとキーワードレベルのスコアを区別する：naturalSearchExposureScore（商品全体）とkeywordNaturalExposureScore（このキーワードのみ）を混同しないでください。ユーザーが対象範囲を把握できるよう、列名を付けてください。
3. 主要な比率を強調する：結果を表示する際は、自然検索の露出比率と有料広告の露出比率を強調し、オーガニックと有料のバランスをすばやく判断できるようにしてください。
4. フィールド名を翻訳する：生の API フィールド名ではなく、ユーザーにわかりやすい名称でフィールドを表示してください（例：「自然検索の露出比率」はnaturalSearchExposureRatioの代わりに使用します）。
5. 件数に関する注意：結果が大量にある場合（合計件数が多い場合）は、主要なデータを表示し、ページネーションでさらに結果を確認できることをユーザーに伝えてください。
6. 期間の注記：露出数や件数を比較する際は、確定した期間を表示してください。デフォルトはlast7d、カスタム期間が設定されている場合はstartDate ~ endDateです。また、各行にdataPeriodStartDateも表示してください。
7. エラー処理：クエリに失敗した場合は、msgフィールドに基づいて理由を説明し、クエリパラメーターの調整（キーワードのスペルやマーケットプレイスコードの確認など）を提案してください。
8. パーセンテージの書式：露出比率は、読みやすいようにパーセンテージで表示してください（例：0.45は「45%」）。
9. トラフィックソースの概要：単一の ASIN のデータを提示する場合は、トラフィック構成の概要を簡潔に説明してください（例：「この商品の露出の60%はオーガニック検索、25%はSP広告、15%はブランド広告によるものです」）。ユーザーが特定のキーワードについて尋ねている場合は、キーワードレベルのフィールドを優先してください。

重要な制限事項

• 条件フィルターは1つのみ：1回のリクエストで使用できるcondition値は1つだけです。複数のトラフィックソースを比較するには、リクエストを分けてください。
• マーケットプレイスの対象範囲：対象は13のマーケットプレイスのみです。IN / NL / SE / PL / TR / SG は利用できなくなりました。
• キーワードの言語：最良の結果を得るには、searchKeywordを対象マーケットプレイスの言語で指定してください。
• 結果の上限：各ページで返されるレコードは最大100件です。
• 対象範囲：このエンドポイントは、キーワードごとの ASIN トラフィックに特化しています。ASIN 全体のメタデータ、チャネル横断のキーワード件数、バリエーションの集計は返しません。これらについては、ASIN のトラフィックソースツールを使用してください。

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

適用対象 — Amazon キーワードのトラフィックソースと競合構造の分析：

ユーザーの発言	シナリオ
「このキーワードのトラフィックはどこから来ていますか」	トラフィックソースの内訳
「オーガニックと広告のトラフィックの割合はどのくらいですか」	オーガニック／広告の比率分析
「このキーワードで SP 広告を出しているのは誰ですか」	SP 広告の競合分析（condition=isSpAd）
「SP のおすすめ枠に掲載されている商品はどれですか」	SP おすすめ商品の検索（condition=acAd）
「Amazon's Choice を獲得している商品はどれですか」	AC バッジ分析（amazonsChoiceExposureScore 経由）
「このキーワードは広告に占有されていますか」	広告飽和度の評価
「ブランド広告の競合状況を表示してください」	ブランド広告の全体像分析
「競合他社のキーワードのトラフィック構造」	競合トラフィック分析
「編集者おすすめに掲載されている商品はどれですか」	ER 掲載分析
「このキーワードで 2 つの ASIN を比較してください」	asins="B0A,B0B" による ASIN フィルター
「3 月 8 日の週の、このキーワードのトラフィック」	カスタムの startDate／endDate 期間
「この期間に新たに流入したトラフィックキーワード」	新規流入フィルター（condition=totalPeriod.in）

適用対象外 — キーワードのトラフィックソース分析の範囲を超える要件：

• 現在の期間とカスタム期間を超える、キーワードランキングの過去の推移（ABA データツールを使用してください）
• 広告入札額／予算の最適化
• 商品レビューや出品コンテンツ
• 販売数量の推定
• 時系列でのキーワード検索ボリュームの全推移
• すべてのキーワードにわたる ASIN 全体のトラフィック構造（SIF ASIN トラフィックソースツールを使用してください）

フィードバック：

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

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

references/api.md の指定に従ってフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

大きなレスポンスの処理

エージェントのコンテキストがあふれないよう、レスポンスをディスクに保存し、必要なフィールドだけを抽出してください。

python scripts/response_io.py run --script scripts/sif_keyword_traffic.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git の作業ツリー外（Unix では /tmp/...、Windows では %TEMP%/... など）に指定してください。保存されたレスポンスには、個人を特定できる情報、価格情報、または認証関連の機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、タスク完了後に削除してください。

run はレスポンス全体をファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は特定のフィールドを抽出し、スライスには --limit/--offset、出力形式の指定には --format json|jsonl|csv|table を使用できます。

この方法を優先する場合 — 以下のようなレスポンスの特性に応じて判断してください。

• レコードあたりのフィールド数が多い場合、または不要なフィールドがある場合
• バッチ結果／ページ分割された結果（1 回の呼び出しで複数の項目が返される場合）
• 長文フィールド（説明、レビュー、HTML、時系列データ）
• すぐには使用せず、後続のステップで再利用する出力

小規模で一度しか使わないレスポンスの場合は、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマとサンプルの一部を抜粋したもので、全データではありません。フィールド単位で判断する場合は、保存されたファイルを read で読み込んでください。

---

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