linkfox-sif-asin-summary

SIF ASIN サマリー

このスキルでは、ASIN 単位のトラフィックソースデータを照会、分析する方法を説明します。これにより、Amazon のセラーは、あらゆる商品の複数のチャネルにわたる露出とトラフィックの構造を把握できます。

基本概念

SIF（Search Intelligence Framework）ASIN サマリーでは、Amazon における ASIN のトラフィックソースを包括的に分類して確認できます。商品の総露出が、オーガニック検索、スポンサープロダクト広告、ブランド広告、動画広告、Amazon's Choice、編集部おすすめ、および高評価商品おすすめにどのように分配されているかがわかります。これは、競合分析やトラフィック戦略の最適化に欠かせません。

露出スコア：特定のチャネルにおける、すべてのキーワードを対象とした商品の全体的な視認性を示す複合指標です。スコアが高いほど、露出が大きいことを意味します。露出比率の各フィールドには、各チャネルが総露出に占める割合が示されます（値の範囲はフィールドに応じて 0～1 または 0～100 です）。

トラフィックキーワード数：商品が見つかるキーワードの総数をチャネル別（オーガニック検索、SP 広告、ブランド広告、動画広告など）に示します。

データフィールド

フィールド名の接尾辞：*Prev = 前期間の値、*In / *Out = 当期間に流入／流出したキーワード（期間比較用）。 | フィールド | API 名 | 説明 | |-------|----------|-------------| | ASIN | asin | Amazon標準商品識別番号 | | 商品タイトル | productTitle | Amazon上の商品タイトル全文 | | 商品カテゴリー | productCategory | Amazon上の商品カテゴリー | | 商品価格 | productPrice | 現在の掲載価格 | | 商品画像 URL | productImageUrl | メインの商品画像リンク | | 商品の特徴 | productFeatures | 箇条書きの商品特徴リスト | | 顧客評価数 | customerRatingCount | 顧客評価の合計数 | | 商品の星評価 | productStarRating | 商品の星評価（0～5） | | 商品評価スコア | productRatingScore | 商品評価スコア（0～5、Amazon上の表示値） | | バリエーション商品か | isVariantProduct | ASINがバリエーション商品（例：色やサイズ違い）かどうか | | 直近の月間販売数区分 | recentMonthlySalesBucket | 前月の販売数を区分化した値（例："300+"、"1,000+"）— keywordSummary パスでのみ入力 | | 監視対象か | isMonitored | ASINが監視リストに含まれているかどうか | | 監視開始時刻 | monitoringStartTime | ASINが監視対象に追加された日時 | | データ期間の開始日 | dataPeriodStartDate | 返されるデータ期間の開始日（yyyy-MM-dd） | | 総露出スコア | totalExposureScore | すべてのチャネルにおける複合露出スコア | | 前期間の総露出スコア | totalExposureScorePrev | 前期間の総露出スコア | | 総トラフィックキーワード数 | totalTrafficKeywordCount | すべてのチャネルのキーワード合計数 | | 新規／離脱／前期間の総キーワード数 | totalTrafficKeywordCountIn / Out / Prev | 新規／離脱／前期間の値 | | 自然検索露出スコア | naturalSearchExposureScore | オーガニック検索による露出スコア | | 自然検索露出率 | naturalSearchExposureRatio | 総露出に占めるオーガニック検索の割合 | | 前期間の自然検索露出スコア | naturalSearchExposureScorePrev | 前期間のオーガニック露出スコア | | 自然検索キーワード数 | naturalSearchKeywordCount | オーガニック検索結果で見つかったキーワード数 | | 新規／離脱／前期間の自然検索キーワード数 | naturalSearchKeywordCountIn / Out / Prev | 新規／離脱／前期間の値 | | SP広告露出スコア | sponsoredProductsExposureScore | スポンサープロダクト広告による露出スコア | | SP広告露出率 | sponsoredProductsExposureRatio | 総露出に占めるSP広告の割合 | | 前期間のSP広告露出スコア | sponsoredProductsExposureScorePrev | 前期間のSP露出スコア | | SP広告キーワード数 | sponsoredProductsKeywordCount | SP広告が掲載されたキーワード数 | | ブランド広告露出スコア | brandAdExposureScore | ブランド広告による露出スコア | | ブランド広告露出率 | brandAdExposureRatio | 総露出に占めるブランド広告の割合 | | 前期間のブランド広告露出スコア | brandAdExposureScorePrev | 前期間のブランド広告露出スコア | | ブランド広告キーワード数 | brandAdKeywordCount | ブランド広告のキーワード合計数 | | ページ上部のブランド広告キーワード数 | topBrandAdKeywordCount | ページ上部のブランド広告に含まれるキーワード数 | | ページ下部のブランド広告キーワード数 | bottomBrandAdKeywordCount | ページ下部のブランド広告に含まれるキーワード数 | | 動画広告露出スコア | videoAdExposureScore | 動画広告による露出スコア | | 動画広告露出率 | videoAdExposureRatio | 総露出に占める動画広告の割合 | | 前期間の動画広告露出スコア | videoAdExposureScorePrev | 前期間の動画広告露出スコア | | 動画広告キーワード数 | videoAdKeywordCount | 動画広告が掲載されたキーワード数 | | Amazon's Choice露出スコア | amazonsChoiceExposureScore | ACバッジによる露出スコア | | Amazon's Choice露出率 | amazonsChoiceExposureRatio | 総露出に占めるACの割合 | | 前期間のAmazon's Choice露出スコア | amazonsChoiceExposureScorePrev | 前期間のAC露出スコア | | Amazon's Choiceキーワード数 | amazonsChoiceKeywordCount | ACバッジが付いたキーワード数 | | 新規／離脱したACキーワード数 | amazonsChoiceKeywordCountIn / Out | 今期の新規／離脱ACキーワード数 | | 編集者のおすすめ露出スコア | editorialRecommendationsExposureScore | 編集者のおすすめによる露出 | | 編集者のおすすめ露出率 | editorialRecommendationsExposureRatio | 総露出に占めるERの割合 | | 編集者のおすすめキーワード数 | editorialRecommendationsKeywordCount | ERが掲載されたキーワード数 | | 高評価露出スコア | topRatedExposureScore | 高評価のおすすめによる露出 | | 高評価露出率 | topRatedExposureRatio | 総露出に占めるTRの割合 | | 高評価キーワード数 | topRatedKeywordCount | TRが掲載されたキーワード数 | | よく一緒に購入されるキーワード数 | frequentlyBoughtKeywordCount | よく一緒に購入されるおすすめに含まれるキーワード数 | | おすすめ掲載位置の露出スコア | recommendPositionExposureScore | おすすめ掲載位置の露出スコア合計 | | おすすめ掲載位置の広告露出スコア | recommendAdExposureScore | おすすめ掲載位置の露出における広告部分 | | おすすめ掲載位置の非広告露出スコア | recommendNonadExposureScore | おすすめ掲載位置の露出における非広告部分 | | AC枠を除くおすすめ露出スコア | nonAcRecommendExposureScore | AC枠を除いたおすすめ掲載位置の露出 | | おすすめキーワード数 | recommendKeywordCount | おすすめ掲載位置のキーワード合計数 | | おすすめ広告キーワード数 | recommendAdKeywordCount | おすすめキーワードの広告部分 | | おすすめ非広告キーワード数 | recommendNonadKeywordCount | おすすめキーワードの非広告部分 | | PPCトラフィックソース | ppcTrafficSources | 有料広告タイプのリスト（SP、ページ上部のブランド広告、ページ下部のブランド広告、動画広告） | | 自然検索トラフィックソース | naturalSearchTrafficSources | オーガニック検索タイプの識別子 | | Amazonおすすめソース | amazonRecommendationSources | おすすめタイプ（Best Seller、AC、ER、TR、TRFOBなど） | | 販促セールソース | promotionalDealSources | 有効なプロモーション（クーポン、期間限定セール、過去30日間の最安値など） |

対応マーケットプレイス

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

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

呼び出し方法

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

出力ポリシー（スクリプトのデフォルト動作）：

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

パラメーターガイド

searchValue（必須）

カンマで区切った 1 つ以上の ASIN コード。1 回のリクエストにつき最大 10 個の ASIN を指定できます。

• ASIN が 1 つの場合：B0XXXXXXXX
• 複数の ASIN の場合：B0XXXXXXXX,B0YYYYYYYY,B0ZZZZZZZZ

country（省略可）

マーケットプレイスコード。デフォルトは US です。有効なコードについては、「対応マーケットプレイス」セクションを参照してください。

期間（省略可）

• last7d（ブール値、デフォルトは true）：直近 7 日間を使用します。false の場合、API は startDate／endDate を使って期間を定義します。
• startDate（文字列、yyyy-MM-dd）：カスタム期間の開始日です。last7d=false の場合に有効です。省略した場合は、システムの直近の ABA 週が使用されます。
• endDate（文字列、yyyy-MM-dd）：startDate と組み合わせて指定する終了日です。

conditions（省略可）

トラフィックチャネルのフィルターをカンマ区切りで指定します。指定したチャネルの少なくとも 1 つからトラフィックがある ASIN サマリー行のみを返します。有効な値：

• nf — 自然検索
• sp — SP 広告
• sb — SB 通常広告
• sbv — 動画広告（SBV）
• ad — すべての広告トラフィック
• acAd — SP レコメンデーション
• totalPeriod.in — 今期に新たに流入したトラフィックキーワード

sortBy（省略可）

並べ替えフィールドです。空のままにすると、システムのデフォルトが使用されます。有効な値：

totalKeywordNum（キーワード総数）、naturalKeywordNum（自然検索キーワード数）、brandKeywordNum（ブランド広告キーワード数）、vedioKeywordNum（動画広告キーワード数）、acKeywordNum（AC キーワード数）、erKeywordNum（ER キーワード数）、trKeywordNum（TR キーワード数）、sumScore（全キーワードの合計露出数）、totalNfScore（自然検索の合計露出数）、totalSpSocre（SP の合計露出数。綴りに注意）、totalBrandScore（ブランド広告の合計露出数）、totalVedioScore（動画広告の合計露出数）、totalAcScore（AC の合計露出数）、totalTrScore（TR の合計露出数）、totalErScore（ER の合計露出数）。

ページネーション

• pageNum：ページ番号。デフォルトは 1 です
• pageSize：1 ページあたりの結果数。最小値は 10、最大値は 10000、デフォルトは 10000 です

並べ替え

• desc：true（デフォルト）の場合は降順、false の場合は昇順で並べ替えます

使用例

1. 単一ASINのトラフィック内訳

「米国マーケットプレイスで、B09V3KXJPBのトラフィックソースを表示してください」

searchValue = "B09V3KXJPB"、country = "US"でクエリします。

2. 複数ASINの競合比較

「Amazon USで、B09V3KXJPBとB0BN1K7WJPのトラフィック構造を比較してください」

searchValue = "B09V3KXJPB,B0BN1K7WJP"、country = "US"でクエリします。

3. 特定のマーケットプレイスへのクエリ

「Amazon Japanで、B07XJ8C8F5のトラフィックソースを分析してください」

searchValue = "B07XJ8C8F5"、country = "JP"でクエリします。

4. オーガニックと有料トラフィックの分析

「B09V3KXJPBの露出のうち、オーガニック検索と広告の割合はそれぞれどれくらいですか？」

ASINをクエリし、naturalSearchExposureRatioを sponsoredProductsExposureRatio、brandAdExposureRatio、videoAdExposureRatioと比較します。

5. 広告チャネルの詳細分析

「B0BN1K7WJPはSP、ブランド広告、動画広告で、何個のキーワードに広告を出していますか？」

ASINをクエリし、sponsoredProductsKeywordCount、brandAdKeywordCount、topBrandAdKeywordCount、bottomBrandAdKeywordCount、videoAdKeywordCountを表示します。

6. 期間比較

「このASINの総キーワード数は、先週と比べてどう変化しましたか？」

ASINをクエリし、totalTrafficKeywordCount（現在）、totalTrafficKeywordCountPrev（前期間）、totalTrafficKeywordCountIn（今期間に追加）、totalTrafficKeywordCountOut（今期間に除外）を表示します。オーガニック検索のバリエーションについても、naturalSearchKeywordCount*の各項目で同様に表示します。

7. カスタム日付範囲

「2026-03-08から2026-03-14までのB0XXXのトラフィック構造」

searchValue: "B0XXX", country: "US", last7d: false, startDate: "2026-03-08", endDate: "2026-03-14"

8. トラフィックチャネルでフィルターし、SP露出順に並べ替え

「自分の10製品のうち、SPを実施しているASINをSP露出順に表示してください」

searchValue: "B0A,B0B,...,B0J", conditions: "sp", sortBy: "totalSpSocre", desc: true

表示ルール

1. データを明確に表示する：クエリ結果を整理された表にまとめます。商品メタデータ、現在期間のスコア、キーワード数、期間比較の列を論理的なグループに分け、見やすくします
2. パーセンテージ表示：露出比率は、理解しやすいようにパーセンテージで表示します（例：0.45は45.0%）
3. トラフィック構造の要約：ユーザーが単一のASINをクエリした場合、トラフィック構造（例：「オーガニック65%、SP広告25%、ブランド広告10%」）をあらかじめ要約し、全体像をひと目で把握できるようにします
4. 期間の明記：*In／*Out／*Prevフィールドを表示する際は、必ず期間を明記します（例：「過去7日間との比較」、または確定したstartDate ~ endDateの範囲）。比較期間を示さずに期間差を表示しないでください。
5. 競合比較のレイアウト：複数のASINをクエリした場合は、違いがひと目で分かるように横並びの比較表を使用します
6. エラー処理：クエリに失敗した場合は、msgフィールドに基づいて理由を説明し、ASINが有効か、マーケットプレイスの選択が適切か確認するよう提案します
7. バリエーションへの注意：isVariantProductがtrueの場合、そのASINがバリエーションであることを伝え、全体像を把握するために親ASINも確認するよう案内します。

重要な制限事項

• 1リクエストあたりのASIN上限：1回の呼び出しでクエリできるASINは最大10件です
• ページサイズの上限：1ページあたり最大10000件
• マーケットプレイスの対応状況：対応マーケットプレイスは13か所のみです — IN／NL／SE／PL／TR／SGは利用できなくなりました
• スナップショットと期間：デフォルトの期間は直近7日間です（last7d=true）。別の期間をクエリするには、last7d=falseを設定し、startDate／endDateを指定します
• 露出スコアは相対値です：スコアはチャネル間およびASIN間の比較には役立ちますが、トラフィックの絶対量を示すものではありません

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

該当するケース -- Amazon ASIN のトラフィックソースと露出分析：

ユーザーの発言	シナリオ
「この ASIN のトラフィックはどこから来ていますか」	トラフィックソースの内訳
「この商品のオーガニックトラフィックはどのくらいですか」	自然検索の露出分析
「この競合は多くの広告を出していますか」	SP／ブランド／動画広告の露出確認
「これらの ASIN のトラフィック構成を比較してください」	複数 ASIN の競合比較
「この商品には Amazon's Choice が付いていますか」	AC／ER／TR の推薦確認
「この ASIN はどの広告チャネルを利用していますか」	PPC トラフィックソースの特定
「この ASIN は何個のキーワードでランクインしていますか」	トラフィックキーワード数の分析
「この商品は有料トラフィックとオーガニックトラフィックのどちらに依存していますか」	オーガニックと有料トラフィックの内訳
「先週と比べてキーワードはどう変化しましたか」	期間比較（In／Out／Prev）
「この ASIN の新規オーガニックキーワードはいくつですか」	新規キーワード数（naturalSearchKeywordCountIn）
「特定の日付範囲の数値を取得してください」	startDate／endDate によるカスタム期間
「SP 露出で ASIN 10 件を順位付けしてください」	複数件に対する sortBy=totalSpSocre

該当しないケース -- ASIN のトラフィックソースデータ以外の情報が必要な場合：

• 数週間にわたる任意の過去のトレンド曲線（このツールで確認できるのは現在と前の期間のみです。長期トレンドには ABA データを使用してください）
• ASIN のキーワード別検索ボリュームや順位データ（代わりに ABA データまたは ASIN キーワードツールを使用してください）
• 売上推定や収益分析
• 商品リストの最適化やコピーライティング
• 広告入札額や予算の推奨

算力消費ルール

算力を 9 消費します。

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

フィードバック：

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

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

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

---

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