linkfox-sif-asin-keywords

SIF ASIN キーワード分析

このスキルでは、特定の Amazon ASIN のトラフィックキーワードを検索して分析する方法を説明します。Amazon の販売者が、どのキーワードが商品へのトラフィックを促進しているか、また各キーワードでその商品がどのような順位にあるかを把握するのに役立ちます。

主な概念

SIF ASIN キーワードデータからは、特定の Amazon 商品（ASIN）にトラフィックをもたらすキーワードがわかります。キーワードごとに、商品のオーガニック検索順位、SP 広告順位、検索ボリューム、トラフィックシェア、表示位置の種類、および各種パフォーマンス指標を確認できます。ASIN を逆引きしてキーワードを調べる際に最適なツールです。

単一 ASIN の制限：このツールで一度に検索できる ASIN は 1 つです。複数の ASIN を比較したい場合は、それぞれ個別に検索する必要があります。

順位の仕組み：順位の数値が小さいほど、上位に表示されていることを意味します。順位 1 は、商品が検索結果の最初に表示されることを意味します。「順位が上がった」とは数値が小さくなったことを指し、「順位が下がった」とは数値が大きくなったことを指します。

データ項目

キーワードごとのレコード（data の各要素）

フィールド	API 名	説明	例
キーワード	keyword	トラフィックをもたらす検索キーワード	wireless charger
キーワードの翻訳	translateKeyword	マーケットプレイス向けにローカライズされたキーワードの翻訳	无线充电器
ASIN	asin	検索対象の商品 ASIN	B0XXXXXXXX
オーガニック順位	productNaturalRank	オーガニック検索結果における商品の順位	5
オーガニック順位（表示）	naturalRankDisplay	表示テキストとしてのオーガニック順位	5
広告順位	productAdRank	SP 広告結果における商品の順位	3
広告順位（表示）	adRankDisplay	表示テキストとしての広告順位	3
週間検索ボリューム	weeklySearchVolume	このキーワードの推定週間検索数	125000
キーワード人気度順位	keywordPopularityRank	すべてのキーワードにおける検索ボリュームの順位（数値が小さいほど人気）	203
検索結果の商品総数	totalSearchResultProductCount	このキーワードで表示される商品の総数（オーガニック検索＋広告＋おすすめ）	1280
トラフィックシェア	trafficShare	このキーワードが ASIN にもたらすトラフィックの割合（1 = 100%）	0.05
オーガニックトラフィックシェア	naturalTrafficShare	オーガニック露出スコア／合計スコア	0.62
有料トラフィックシェア	paidTrafficShare	有料広告の露出スコア／合計スコア（SP + SB + SBV + recAd）	0.31
オーガニックトラフィックスコア	naturalTrafficScore	このキーワードにおける ASIN のオーガニック検索露出スコア（0 = なし）	4.2
SP 広告スコア	sponsoredProductsScore	スポンサープロダクトの通常枠のスコア（SP おすすめ枠を除く）	2.1
ブランド広告（SB）スコア	brandAdScore	スポンサーブランドの合計スコア（標準＋動画）	0.8
動画広告（SBV）スコア	videoAdScore	スポンサーブランド動画のスコア	0.3
SP おすすめスコア	sponsoredRecommendationScore	SP おすすめ枠（急上昇中、ソーシャルメディアで話題、よく一緒に閲覧されている商品、星 4 つ以上など）の合計スコア	1.4
SP おすすめの内訳	sponsoredRecommendationBreakdown	SP おすすめ枠ごとの {title, score, scoreRatio} の配列	[{"title":"Trending now","score":0.8,"scoreRatio":0.57}]
ABA TOP3 クリック集中度	clickConcentrationShare	このキーワードのクリックが上位 ASIN に集中しているかどうか（コンバージョン率ではありません）	0.42
クリックから購入へのコンバージョン率	clickToPurchaseConversionRate	キーワード単位の purchaseQty / clickQty	0.037
表示位置の種類	displayPositionTypes	商品の表示位置：natural、ac、sp、top、bottom、er、vedio、tr、trfob	["natural", "sp"]
トラフィック特性マーカー	trafficCharacteristicMarkers	トラフィック特性タグ：isMainKw、isAccurateKw、isAccurateAboveKw、isAccurateTailKw	["isMainKw"]
コンバージョン実績マーカー	conversionPerformanceMarkers	コンバージョンタグ：isPurchaseKw、isQualityKw、isStableKw、isLossKw、isInvalidKw	["isPurchaseKw"]
最終オーガニック順位日時	lastNaturalRankTime	このキーワードで商品が最後に有効なオーガニック順位を獲得した日時	2026-04-20
最終広告順位日時	lastAdRankTime	このキーワードで商品が最後に有効な SP 広告順位を獲得した日時	2026-04-20
期間終了日	periodEndDate	現在の（週次）期間の終了日 = 開始週 + 7 日	2026-04-27
更新日時	updateTime	キーワードデータが最後に更新された日時	2026-04-21

トップレベルのレスポンスフィールド（data と並列）

フィールド	API 名	説明
親 ASIN かどうか	isParentAsin	検索対象の ASIN が親（バリエーションの起点）かどうか
バリエーションの有無	hasVaiants	ASIN にバリエーションがあるかどうか
最新 ABA 週	abaCreateDateWeek	最新 ABA 週次データの基準日

対応マーケットプレイス

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

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

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-sif-asin-keywords-<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 Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高が不足していることを示すレスポンス：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれている場合。

パラメーターガイド

必須パラメーター

• asin（string、必須）：検索対象の Amazon ASIN。1 回のリクエストにつき、ASIN は 1 つのみです。

オプションパラメーター

• country（文字列、デフォルトはUS）：マーケットプレイスコードです。上記の「対応マーケットプレイス」を参照してください。

• keyword（文字列）：このテキストを含むキーワードに結果を絞り込みます。可能な場合は、対象のマーケットプレイスの言語にキーワードを翻訳してください。

• timePieceType（文字列、デフォルトはlatelyDay）：期間の種類です。latelyDay（直近のN日間）、month（特定の月）、week（特定の週）を指定します。

• timePieceValue（文字列、デフォルトは7）：timePieceTypeに対応する値です。

  • timePieceType=latelyDayの場合 → 7または30のみ指定できます
  • timePieceType=monthの場合 → YYYY-MM（例：2026-04）
  • timePieceType=weekの場合 → 週の開始日YYYY-MM-DD（例：2026-04-13）

• conditions（文字列）：条件フィルターをカンマ区切りで指定します。フラグ形式のフィルター：

  • nfPosition -- オーガニックトラフィックのキーワード
  • isSpAd -- SP 広告のキーワード
  • isBrandAd -- ブランド広告のキーワード
  • isVedioAd -- 動画広告のキーワード
  • isAC -- Amazon's Choice のキーワード
  • isAccurateKw -- 正確なトラフィックキーワード
  • isAccurateTailKw -- 正確なロングテールキーワード
  • isPurchaseKw -- 購入につながるキーワード
  • isQualityKw -- 高品質なコンバージョンキーワード
  • isStableKw -- 安定したコンバージョンキーワード
  • isLossKw -- コンバージョンが減少したキーワード
  • isInvalidKw -- 無効なインプレッションのキーワード
  • isMultiVariantKw -- 複数のバリエーションでオーガニック検索順位を獲得しているキーワード
  • isSearchVolUpKw -- 検索ボリュームが前年比で増加したキーワード
  • isSearchVolDownKw -- 検索ボリュームが前年比で減少したキーワード

  期間内の件数フィルター（全件／期間内に新規追加）：

  • 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（文字列）：並べ替えフィールドです。指定できる値：lastRank（オーガニック検索順位）、adLastRank（広告順位）、updateTime（更新日時）、searchesRank（検索人気度順位）、estSearchesNum（月間検索ボリューム）。

• desc（ブール値、デフォルトはtrue）：降順で並べ替えます。昇順にするにはfalseを指定します。

• pageNum（整数、デフォルトは1）：ページネーションのページ番号です。

• pageSize（整数、デフォルトは100、範囲は10-100）：1ページあたりの結果数です。

効果的なクエリの作成

1. マーケットプレイスを必ず指定する：countryに、対応する13種類のコードのいずれかを設定します。
2. 適切な期間を選ぶ：デフォルトは直近7日間です。特定の月を指定するにはtimePieceType=monthとtimePieceValue=YYYY-MMを、特定のABA週を指定するにはtimePieceType=weekとtimePieceValue=YYYY-MM-DDを渡します。
3. キーワードで絞り込む：特定のキーワードに関心がある場合は、keywordパラメーターを渡して結果を絞り込みます。
4. 条件フィルターを適用する：conditionsを使って、特定の種類のキーワードに絞り込みます（例：オーガニックキーワードのみ、購入につながるキーワードのみ、またはspKeywordCnt.inによる新規追加のSPキーワードのみ）。
5. 適切な並べ替えを選ぶ：検索ボリュームが最も多いキーワードを探すにはestSearchesNumで、検索順位が最も高いキーワードを探すにはlastRankで並べ替えます。
6. ページネーションを処理する：APIが返す結果は、1ページあたり最大100件です。合計が100件を超える場合は、pageNumを使って追加のページを取得します。

使用例

1. 米国マーケットプレイスでASINのすべてのトラフィックキーワードを検索する

asin: "B0XXXXXXXX", country: "US"

2. オーガニックトラフィックのキーワードのみを検索する

asin: "B0XXXXXXXX", country: "US", conditions: "nfPosition"

3. 「charger」を含むキーワードを検索ボリュームの昇順で並べる

asin: "B0XXXXXXXX", country: "US", keyword: "charger", sortBy: "estSearchesNum", desc: false

4. コンバージョン率の高いキーワードを検索する

asin: "B0XXXXXXXX", country: "US", conditions: "isPurchaseKw,isQualityKw"

5. 日本のマーケットプレイスでSP広告キーワードを検索する

asin: "B0XXXXXXXX", country: "JP", conditions: "isSpAd", sortBy: "adLastRank", desc: false

6. コンバージョンが安定している、精度の高いロングテールキーワードを検索する

asin: "B0XXXXXXXX", country: "US", conditions: "isAccurateTailKw,isStableKw"

7. 2026年4月に新たにランクインしたSPトラフィックキーワードを検索する

asin: "B0XXXXXXXX", country: "US", timePieceType: "month", timePieceValue: "2026-04", conditions: "spKeywordCnt.in"

8. 検索ボリュームが上昇傾向にあるキーワードを検索する

asin: "B0XXXXXXXX", country: "US", conditions: "isSearchVolUpKw", sortBy: "estSearchesNum", desc: true

表示ルール

1. データのみを提示する：検索結果は、主観的なビジネス上の助言を加えず、分かりやすい表で表示します。
2. ランキングに関する補足：ランキングデータを表示する際は、数値が小さいほど順位が高いことをユーザーに伝えます。
3. シェアの表示形式：trafficShare、naturalTrafficShare、paidTrafficShare、clickConcentrationShareはパーセンテージで表示します（値に100を掛けます）。たとえば、0.05は5%と表示します。
4. クリック集中度の表記：clickConcentrationShareは、キーワードにおける上位ASINへのクリックの集中度を測るものであり、コンバージョン率ではありません。clickToPurchaseConversionRateと混同されないよう、明確に表記してください。
5. 期間の明示：*.in／*.totalフィルターを使った件数や、数値を比較して表示する際は、対象期間を明記します。デフォルトは直近7日間です。timePieceType=monthまたはweekが設定されている場合は、解決された期間（periodEndDate／abaCreateDateWeek）を表示します。
6. マーカーの翻訳：マーカー配列を、ユーザーに分かりやすいラベルに翻訳します。たとえば、["isMainKw", "isAccurateKw"]は「メイントラフィック、精密トラフィック」と表示します。
7. 表示位置の翻訳：位置タイプの配列は、分かりやすいラベルに翻訳します。natural = オーガニック、ac = Amazon's Choice、sp = SP広告、top = トップブランド広告、bottom = ボトムブランド広告、er = 編集者のおすすめ、vedio = 動画広告、tr = 高評価、trfob = 高評価・よく一緒に購入されています。
8. ページネーションの通知：検索結果に複数のページがある場合は、総件数を伝え、追加ページの取得を提案します。
9. エラー処理：クエリに失敗した場合は、msgフィールドに基づいて理由を説明し、クエリパラメーターの調整を提案します。
10. 複数ASINのリクエスト：ユーザーが複数のASINについて尋ねた場合は、それぞれに個別のAPI呼び出しを行い、結果をまとめて提示します。

重要な制限事項

• リクエストごとに指定できるASINは1つ：一度にクエリできるASINは1つだけです。
• ページサイズの上限：1ページあたり最大100件です。
• 期間の粒度：timePieceType=latelyDayでサポートされるtimePieceValueは7または30のみです。任意の日数を指定することはできません。
• マーケットプレイスの対応状況：対応しているマーケットプレイスは13か所のみです。IN／NL／SE／PL／TR／SGは利用できなくなりました。
• キーワードの言語：keywordフィルターには、対象マーケットプレイスの言語を指定することが望ましいです。

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

該当するケース -- 特定の Amazon 商品のキーワード分析：

ユーザーの発言	シナリオ
"この ASIN がランクインしているキーワードは何ですか"	ASIN の逆引きキーワード検索
"B0XXX のトラフィックキーワードを表示してください"	トラフィックキーワード分析
"この商品のオーガニック検索順位は何位ですか"	オーガニック検索順位の確認
"この商品はどのキーワードに広告を出していますか"	広告キーワード分析
"この ASIN のコンバージョン率の高いキーワードを見つけてください"	コンバージョンキーワードの抽出
"この商品の主なトラフィックソースは何ですか"	主なトラフィックキーワードの特定
"コンバージョンが失われたキーワードを表示してください"	コンバージョン損失の診断
"Amazon's Choice バッジが付いているキーワードはどれですか"	AC キーワードの発見
"自分の ASIN のキーワード順位を比較してください"	キーワード順位の分析
"この ASIN が先月獲得した新しい SP キーワードはどれですか"	期間内に新たに獲得したキーワードの発見（spKeywordCnt.in + 月単位の期間）
"検索ボリュームが前年同期比で増加しているキーワード"	検索ボリュームのトレンドフィルター（isSearchVolUpKw）
"このキーワードのクリック集中度は高いですか"	ABA の TOP3 クリック集中度の確認
"キーワードごとのクリックから購入へのコンバージョン率"	キーワードごとのコンバージョン確認

該当しないケース -- 単一 ASIN のキーワード検索を超えるニーズ：

• 特定の ASIN に紐づかない幅広いキーワード調査（代わりに ABA データツールを使用してください）
• 商品レビュー、商品リスティングのコピーライティング
• 売上予測、収益分析
• 広告キャンペーンの管理（入札額、予算）
• 特定の ASIN を対象としない、カテゴリー全体のキーワードトレンド

算力消耗規則

算力を 9 消費します。

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

フィードバック：

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

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

references/api.md に記載されている方法でフィードバック API を呼び出してください。ユーザーの操作を中断しないでください。

---

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