Amazon広告レポート取得Skill（LinkFox）
認証済み店舗のSP・SB・SD広告レポートをLinkFox Skillで取得。必要な権限、検索語句の項目、待機処理と分析へのつなぎ方を解説します。
- 作成者
- LinkFox
- ライセンス
- MIT
- 検証レベル
- 出典確認済み
- 最終検証日
- 2026-09-15
できること
LinkFoxの linkfox-amazon-ads-report は、利用者が認証したAmazon広告アカウントのレポートを取得します。Pythonスクリプトがレポート作成、状態確認、ダウンロード、展開を順に処理します。確認した参照ファイルはSponsored Products、Sponsored Brands、Sponsored Displayに対応しています。
担当するのは分析前のデータ取得です。PPC戦略を自動で完成させたり、他の出品者の非公開広告データを取得したりする機能ではありません。本項目は出典を確認したもので、実店舗の接続やダウンロードは検証していません。
使う場面
毎週同じ広告キャンペーンや検索語句レポートを手動で出力している出品者、運用代行者に向いています。LinkFoxの認証済み接続と、ローカルでPythonを実行できるAgentが必要です。すでにCSVがある場合は、PPCレポート分析Skillから始められます。
入力
- 認証済みAmazon Adsアカウントとマーケットプレイス。同じ国に複数店舗がある場合は対象を選びます。
- レポート種別の参照資料に沿った日付、集計方法、列の一覧。
linkfox-amazon-ads-auth、提供元の認証情報、書き込み可能なローカルフォルダー。- 比較に使うアトリビューション期間と通貨。異なる条件を混ぜないようにします。
出力
reportId、処理状態、保存先パス。- ダウンロードと展開後の構造化レポートデータ。
- 有効にした場合の一時的なローカルダウンロードリンク。リンクには期限があるため、後続分析には保存済みファイルを使います。
実行例
以下は未実行の例です。米国のSponsored Products検索語句を2026年9月1日から7日まで取得する場面を想定します。
- 認証用Skillで店舗を確認し、対応する
profileIdを取得します。 spSearchTerm、SPONSORED_PRODUCTS、groupBy: [searchTerm]、SUMMARYを選びます。- 固定版の列定義で、
searchTerm、impressions、clicks、cost、sales7d、startDate、endDateが使用可能か確認します。 - 依頼内容と料金を確認した後、レポート作成と状態確認を開始します。
STILL_PROCESSINGが続く場合はreportIdを保持し、待機を延長するか決めます。ローカル側の待機終了はAmazon側の拒否を意味しません。- 保存された行と期間を確認し、オフラインHTML広告レポートSkillに渡します。
対応Agentとセットアップ
出典ではClaude Codeでの利用を説明しており、Python、補助スクリプト、参照ファイルが必要です。レポートSkillと認証用Skillを一緒に読み、作者のリポジトリに従って環境を準備してください。SKILL.md だけでは実行できません。他のクライアントは個別検証が必要です。本サイトではインストールやアカウント認証を試していません。
アカウント・API・権限
LinkFoxアカウント、そのAPI認証情報、Amazon Adsの認証が必要です。Ecommerce Data APIキーでは代用できません。ネットワーク、リモートレポートの作成、認証情報、ローカルファイルを扱います。また、原文には提供元への自動フィードバック送信が含まれています。内容を確認し、フィードバックや業務データの送信は承認後に行うよう指定してください。
コードは MITライセンスです。外部サービスには別途料金がかかる可能性があります。確認版にはクレジット消費に関して矛盾する説明があるため、現在の料金を提供元に確認してください。掲載の価格区分は無料取得の保証ではありません。
制限
- 列、保存期間、指定可能な日数は種類ごとに異なります。確認版の
spSearchTermは最大31日、保存65日と記載されています。過去データを要求する前に最新の定義を確認してください。 - 検索語句レポートは広告クリックがない表示を含みません。表示全体の分布として扱わないでください。
- 空の結果は広告実績がない場合もあります。直近の数値はアトリビューション遅延で変わり得ます。
- DSP、Sponsored Television、Brand Analytics、Retail Analyticsは対象外です。レポート作成と入札変更は別の操作です。
- 権限、保存ファイル、リンクの共有範囲を確認します。失敗時に無限再試行したり、プロンプトにキーを書いたりしないでください。
Ecommerce Data APIとの連携
自社の広告レポートから検索語句を抽出し、キーワード調査やトラフィック分析で市場の背景を補います。公開市場データでは、自社の広告費、注文、アトリビューションを代替できません。
追加の市場調査をする場合にEcommerce Data APIキーを作成します。Amazon PPC Skill一覧から次の分析手順を選ぶこともできます。
出典の確認
Skills.shから発見し、2026年9月15日にコミット 38fef046 のSkill、列定義、補助スクリプト、ライセンスを確認しました。独立した紹介記事であり、Amazonの推薦やインストール・安全性の認証ではありません。