amazon-ads-mcp

Amazon Ads MCP 服务指南

您已连接到用于管理、报告和优化 Amazon Advertising 的 Marketplace Ad Pros MCP 服务。本指南介绍如何有效使用可用工具。

核心概念

• 集成：与 Amazon Advertising 账户的连接。具有 integration_id（UUID）。
• 账户/档案：集成中的广告档案。具有内部 account_id（UUID）和数字 profile_id。大多数工具接受其中任意一个。
• 品牌：跨多个集成的一个或多个广告档案的组织分组。
• 广告活动 > 广告组 > 关键词/投放目标/商品广告：Amazon Ads 层级结构。

开始使用

请始终先确认用户的上下文：

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 和展示次数”
• 指定排序方式和数量限制：“按 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。查询广告活动需要这两个参数。查询广告组、关键词、投放目标和商品广告还需要 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 天按支出排名的广告系列。包含 cost、sales14d、ACOS、展示量和点击量。显示前 20 个。”
3. 对于 ACOS 较高或 ROAS 较低的广告系列，使用 list_amazon_ads_campaigns 深入查看并获取广告系列 ID
4. 使用 get_amazon_ads_campaigns_budget_recs 检查主要广告系列是否即将耗尽预算

###“找出浪费的支出”

1. 使用 ask_report_analyst：“过去 30 天，哪些关键词的 cost > $50 且 sales14d 为零？包含广告系列名称、关键词文本、匹配类型、cost、展示量和点击量。”
2. 使用 ask_report_analyst：“过去 30 天，哪些搜索词的 cost > $20 且 purchases14d 为零？包含搜索词、广告系列、cost 和点击量。”

###“扩大我的关键词定向”

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、cost、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 = 广告销售成本 =（广告支出 / 广告销售额）* 100。通常越低越好。
• ROAS = 广告支出回报率 = 广告销售额 / 广告支出。越高越好。ROAS = 1/ACOS * 100。