SuperAPI AI 工具集

amazon-ads

智能体与模型

查看项目

更新于 10-16 00:06

技能介绍

用途:通过 Marketplace Ad Pros MCP 服务器管理、报告和优化 Amazon Advertising 账户。

核心概念:Integration 为亚马逊广告账户连接,含 integration_id;Account/Profile 为集成内的广告档案,含内部 account_id 与数字 profile_id;Brand 为跨集成的一个或多个档案分组;层级为 Campaign > Ad Group > Keywords/Targets/Product Ads。

初始步骤:先调用 whoami 确认已认证用户与套餐状态;调用 list_brands 获取品牌及其关联广告档案,这是获取 integration_id 和 account_id 最快方式;若用户有多个品牌/档案,先询问目标;若无品牌但有集成,用 list_amazon_ads_integrations 和 list_amazon_ads_integration_accounts 查找档案。

主要能力:报表与分析使用 ask_report_analyst,可查询历史报表中的指标、花费、销售、ACOS、展示、点击、转化、搜索词等,支持按日期范围、指标、排序、数量及实体类型提问,作用域可传 integration_id+account_id、brand_id、brand_ids、account_ids 或 integration_ids,仅有 question 必填。结构与浏览用 list_resource_types 发现资源类型与过滤模式,再用 list_resources 浏览,常见类型有 sp_campaigns、sp_ad_groups、sp_keywords、sp_targets、sp_product_ads、sb_campaigns、sb_ad_groups、sb_keywords、dsp_advertisers、dsp_campaigns、dsp_ad_groups、dsp_targets、dsp_creatives,结果每页上限 100,用 next_token 分页;DSP 需按层级逐级下钻,且仅 agency 档案可访问。优化建议工具包括 get_amazon_ads_account_recs、get_amazon_ads_ad_group_bid_recs、get_amazon_ads_ad_group_keyword_recs、get_amazon_ads_campaign_budget_rule_recs、get_amazon_ads_campaigns_budget_recs。原生自动化规则通过 list_resources、create_resources、update_resources 管理,资源类型有 sp_budget_rules、sb_budget_rules、sd_budget_rules、sp_optimization_rules、sb_optimization_rules;预算规则仅能提高预算,SP 优化规则仅支持 INCREMENT 增加、无 DELETE,可通过状态暂停,SB 优化规则通过 entityId 限定单个活动。写入操作在启用写权限时可创建和更新 SP、SB、DSP 的活动、广告组、关键词、目标、商品广告和否定关键词,需先调用 list_resource_types 并 include_schemas=true 查看模式;活动状态只能设为 ENABLED 或 PAUSED,不支持 ARCHIVED;执行写入前须与用户确认;商品广告需要广告主拥有的有效 ASIN。

常用场景:账户健康检查、查找浪费花费、按预算或竞价筛选(注意 list_resources 不支持按预算或竞价过滤,需改用 ask_report_analyst)、关键词扩展、商品表现分析。

限制与提示:报表数据约有 2-3 天延迟;指标使用 14 天归因窗口;ACOS=(广告花费/广告销售)×100,ROAS=广告销售/广告花费;多数工具需要 integration_id+account_id,先从 list_brands 获取;用户按品牌思考时可用 brand_id 作用域;多档案时先确认目标。