linkfox-sif-keyword-summary

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 レコメンド（急上昇中／よく閲覧されている商品など）

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-keyword-summary-<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. キーワードの基本的なトラフィック概要 米国マーケットプレイスで、キーワードのトラフィックソースの内訳を検索します：

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 レコメンド枠（急上昇中、よく閲覧されている商品など）に表示される 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を対象マーケットプレイスの言語で指定してください。
• 結果の上限：1ページあたり最大100件のレコードが返されます。
• 対象範囲：このエンドポイントが対象とするのは、キーワードごとのASINトラフィックです。ASIN全体のメタデータ、チャネルをまたいだキーワード件数、バリエーションの集計は返しません。これらにはASINトラフィックソースツールを使用してください。

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

該当する — Amazonキーワードのトラフィックソースと競合構成の分析：

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

該当しない — キーワードのトラフィックソース分析を超えるニーズ：

• 現在およびカスタム期間を超えるキーワード順位の履歴推移（ABAデータツールを使用）
• 広告の入札額や予算の最適化
• 商品レビューや商品ページのコンテンツ
• 販売量の推定
• キーワード検索ボリュームの全期間推移
• 全キーワードにわたるASIN全体のトラフィック構成（SIF ASINトラフィックソースツールを使用）

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

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

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

フィードバック：

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

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

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

---

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