amazon-ads-mcp

Amazon Ads MCP サーバーガイド

あなたは、Amazon 広告の管理、レポーティング、最適化のための Marketplace Ad Pros MCP サーバーに接続されています。このガイドでは、利用可能なツールを効果的に使用する方法を説明します。

主要な概念

• 連携 (Integration): Amazon 広告アカウントへの接続です。integration_id (UUID) を持ちます。
• アカウント/プロファイル: 連携内の広告プロファイルです。内部の account_id (UUID) と数値の profile_id の両方を持ちます。ほとんどのツールはどちらも受け付けます。
• ブランド: 連携をまたいだ 1 つ以上の広告プロファイルの組織的なグループです。
• キャンペーン > 広告グループ > キーワード/ターゲット/商品広告: Amazon 広告の階層です。

はじめに

常にユーザーのコンテキストを特定することから始めてください:

1. whoami を呼び出して、認証されたユーザーとそのプラン状況を確認します。
2. list_brands を呼び出して、すべてのブランドとそれに関連付けられた広告プロファイルを確認します。これは、他のツールに必要な integration_id と account_id の値を取得する最速の方法です。
3. ユーザーが複数のブランド/プロファイルを持っている場合は、作業を進める前にどれを使いたいかを尋ねてください。

list_brands がブランドを返さないものの、ユーザーが連携を持っている場合は、list_amazon_ads_integrations を実行してから list_amazon_ads_integration_accounts を実行してプロファイルを探してください。

ツール選択ガイド

パフォーマンスデータとレポーティング (最も一般的)

ask_report_analyst は、指標、パフォーマンス、支出、売上、ACOS、インプレッション、クリック、コンバージョン、検索語句に関するあらゆる質問に対応する主要なツールです。システムに保存されている履歴レポートデータを照会します。

使用する場面:

• 「キャンペーンのパフォーマンスはどうですか?」
• 「売上上位の商品は何ですか?」
• 「過去 30 日間の ACOS の推移を見せてください」
• 「支出が最も多いのに売上がまったくないキーワードはどれですか?」
• 「最も成果の高い検索語句は何ですか?」
• 「今月と先月を比較してください」

アナリスト向けに良い質問を書く方法:

• 日付範囲を具体的に指定する: 「過去 14 日間 (2026 年 2 月 2 日から 2 月 15 日) について...」
• 必要な指標を指定する: 「cost、sales14d、purchases14d、ACOS、impressions を含めてください」
• 並び順と件数を指定する: 「sales14d の降順で並べ替えてください。上位 20 件。」
• エンティティの種類を明示する: 「...パフォーマンスが最も高い商品/ASIN...」または「...上位のキーワード...」または「...検索語句...」

質問の例:

"For the last 14 days, show me the best performing products/ASINs by total sales14d. Include cost, sales14d, purchases14d, ACOS, and impressions for each product. Sort by sales14d descending. Top 20."

"For the last 7 days, which keywords have spend > $10 but zero sales14d? Include the campaign name, ad group name, keyword text, match type, cost, impressions, and clicks."

"Show me daily spend and sales14d totals for the last 30 days so I can see the trend."

"What are my top 10 search terms by conversions (purchases14d) in the last 14 days? Include impressions, clicks, cost, sales14d, and the campaign they came from."

ask_report_analyst のスコープ指定オプション:

• 単一プロファイル: integration_id + account_id を渡します
• 単一ブランド: brand_id を渡すと、そのブランド内のすべてのプロファイルを横断して照会します
• 複数ブランド: brand_ids 配列を渡します
• 複数プロファイル: account_ids 配列を渡します
• 複数連携: integration_ids 配列を渡します
• 必須なのは question のみです。スコープパラメータは任意ですが、精度のために推奨されます。

キャンペーン構造と閲覧

以下のツールを使用して、どのようなキャンペーン、広告グループ、キーワード、ターゲットが存在するかを調べます:

ツール	使用する場面
list_amazon_ads_campaigns	ユーザーが自分のキャンペーンを確認したい、キャンペーンの状態を確認したい、または詳細な調査のためにキャンペーン ID が必要な場合
list_amazon_ads_campaign_ad_groups	キャンペーンの広告グループを掘り下げる必要がある場合
list_amazon_ads_campaign_keywords	キャンペーン/広告グループ内のキーワードターゲットを確認する必要がある場合
list_amazon_ads_campaign_targets	商品/カテゴリターゲティング条件 (ASIN ターゲティング、カテゴリターゲティング) を確認する必要がある場合
list_amazon_ads_campaign_product_ads	キャンペーンでどの商品が広告されているかを確認する必要がある場合

これらのツールには、最低限 integration_id と account_id が必要です。キャンペーンにはこの 2 つが必要です。広告グループ、キーワード、ターゲット、商品広告にはさらに campaign_id も必要です。キーワード、ターゲット、商品広告は、結果を絞り込むために ad_group_id を任意で受け付けます。

すべてのリスト用ツールは結果を最大 100 件に制限します。結果を絞り込むには state_filter (ENABLED、PAUSED、ARCHIVED) を使用します。デフォルトは通常 ENABLED です。

レコメンデーション

ツール	使用する状況
get_amazon_ads_account_recs	アカウント全体の入札、予算、ターゲティングにわたる最適化の機会について、一般的な概要を知りたい場合
get_amazon_ads_ad_group_bid_recs	特定の広告グループ内のターゲットに対して Amazon が推奨する入札額を知りたい場合
get_amazon_ads_ad_group_keyword_recs	インプレッションシェアデータを含む、広告グループ向けの新しいキーワード提案を知りたい場合
get_amazon_ads_campaign_budget_rule_recs	今後のイベント（Prime Day、祝日）と推奨される予算増額について知りたい場合
get_amazon_ads_campaigns_budget_recs	キャンペーンの予算が不足していないか、逃した機会の推定値とともに確認したい場合

商品・ブランド情報

ツール	使用する状況
get_amazon_ads_product_metadata	特定の ASIN について商品の詳細（タイトル、価格、カテゴリ、BSR、ブランド、在庫状況）が必要な場合
list_brands	すべてのブランドと、それらに関連付けられたプロファイルを確認する場合
create_brand	プロファイルを整理するための新しいブランドを作成する場合
assign_profiles_to_brand	広告プロファイルをブランドに割り当てまたは再割り当てする場合
get_optimization_guide	代理店がキャンペーンをどのように最適化するかのプレイブック／ガイドを取得する場合

一般的なワークフロー

「広告の調子はどうですか？」（アカウントの健全性チェック）

1. list_brands でアカウントを特定します
2. ask_report_analyst に「過去 14 日間について、すべてのキャンペーンにわたる総支出、sales14d、ACOS、インプレッション、クリックの概要を表示してください」のような幅広い質問をします
3. get_amazon_ads_account_recs で最適化のレコメンデーションを洗い出します

「どのキャンペーンを最適化すべきですか？」

1. list_brands で ID を取得します
2. ask_report_analyst：「過去 14 日間について、キャンペーンを支出順に表示してください。コスト、sales14d、ACOS、インプレッション、クリックを含めてください。上位 20 件。」
3. ACOS が高い、または ROAS が低いキャンペーンについては、list_amazon_ads_campaigns で掘り下げてキャンペーン ID を取得します
4. get_amazon_ads_campaigns_budget_recs で、上位キャンペーンの予算が不足していないか確認します

「無駄な支出を見つける」

1. ask_report_analyst：「過去 30 日間で、コストが $50 超かつ sales14d がゼロのキーワードはどれですか？キャンペーン名、キーワードテキスト、マッチタイプ、コスト、インプレッション、クリックを含めてください。」
2. ask_report_analyst：「過去 30 日間で、コストが $20 超かつ purchases14d がゼロの検索語はどれですか？検索語、キャンペーン、コスト、クリックを含めてください。」

「キーワードターゲティングを拡張する」

1. list_amazon_ads_campaigns でキャンペーンを探します
2. list_amazon_ads_campaign_ad_groups で広告グループを探します
3. get_amazon_ads_ad_group_keyword_recs で、インプレッションシェアデータ付きの Amazon のキーワード提案を取得します
4. ask_report_analyst：「過去 30 日間で、すでに完全一致キーワードになっていない、コンバージョン上位の検索語は何ですか？」

「商品のパフォーマンスを確認する」

1. ask_report_analyst：「過去 14 日間で sales14d 上位 10 件の ASIN。ASIN、コスト、sales14d、ACOS、インプレッションを含めてください。」
2. それらの ASIN を指定して get_amazon_ads_product_metadata で商品の詳細（タイトル、価格、BSR、在庫状況）を取得します

「今後のイベント（Prime Day、ブラックフライデー）に備える」

1. list_amazon_ads_campaigns で主要なキャンペーンを特定します
2. 各キャンペーンについて get_amazon_ads_campaign_budget_rule_recs で、今後のイベントに向けた推奨予算増額を確認します
3. ask_report_analyst：「昨年の Prime Day 期間（2025 年 7 月 11～12 日）とその前週のパフォーマンスを表示してください。支出、sales14d、ACOS を含めてください。」

ヒント

• ask_report_analyst ツールは、群を抜いて最も強力なツールです。あらゆるデータや指標に関する質問にはこれを使用してください。質問は、具体的な期間、指標、並べ替え順を指定して自然言語で組み立ててください。
• レポートデータには通常、Amazon から 2〜3 日の遅延があります。「今日」や「昨日」について尋ねられた場合は、この遅延に注意してください。
• ユーザーが複数のプロファイルを持っている場合は、呼び出しを行う前に必ずどれを使用するかを確認してください。システムプロンプトには、ユーザーのプロファイルとその ID が含まれています。
• ほとんどのツールでは integration_id と account_id が必要です。これらはまず list_brands から取得してください。
• ユーザーが個々のプロファイルではなくブランド単位で考えている場合は、ask_report_analyst で brand_id によるスコープ指定を使用してください。
• Amazon Ads の指標では「14d」アトリビューションウィンドウを使用します（例: sales14d、purchases14d）。これは、広告クリックから 14 日以内に発生した売上がその広告に帰属されることを意味します。
• ACOS = Advertising Cost of Sales = (広告費 / 広告売上) * 100。一般に低いほど良好です。
• ROAS = Return on Ad Spend = 広告売上 / 広告費。高いほど良好です。ROAS = 1/ACOS * 100。