mcpField
A
amazon-ads

amazon-ads

github.com/hyperfx-ai营销与增长107181 次安装2 天前更新
代码仓库

关于 amazon-ads

amazon-ads 是用于管理 Amazon Ads Sponsored Products 广告活动的策略技能,指导研究、产品确认、活动设置、报告分析和围绕 ACoS 目标的优化。新建活动会保持暂停状态,待用户批准后再启用。

主要功能

  1. 01查找广告档案并检查集成状态
  2. 02创建和管理 Sponsored Products 活动
  3. 03设置关键词和商品定向
  4. 04配置预算规则
  5. 05查看报告和竞价建议
  6. 06以暂停状态创建活动

适用场景

  1. 01研究并准备 Sponsored Products 活动
  2. 02为现有活动添加定向
  3. 03自动化管理活动预算
  4. 04分析 ACoS 和搜索词表现

MCP 相关

使用 Hyper MCP 提供的 Amazon Ads 工具。需要连接 Hyper MCP 和 Amazon Ads 集成,并可通过 MCP 客户端或 Hyper CLI 调用工具。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/hyperfx-ai/marketing-skills --skill amazon-ads

安装后在 Claude Code 中输入/amazon-ads确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
budget-rules.md
campaign-creation.md
discovery.md
reporting.md

详细介绍

Amazon Ads

管理 Amazon Ads Sponsored Products 广告活动的战略指南。先进行研究,验证产品,并针对 ACoS 目标优化。

要求

如果 search("amazon_ads_profiles_list") 未找到 amazon_ads_profiles_list,请停止并告知用户启用 Hyper MCP 并连接 Amazon Ads。

如何运行此技能中的工具

此技能中的每个工具都使用其规范工具名称。请通过当前界面提供的调用方式运行:

界面查找工具运行工具
MCP 客户端(Claude、Cursor、Codex、ChatGPT)search("<what you want to do>"),然后 describe("<name>")call("<name>", {...})
Hyper CLIhyperai search "<what you want to do>",然后 hyperai describe <name>hyperai call <name> --json '{...}'

如果未找到某个工具,说明其集成尚未连接或未在工作区启用:请停止并告知用户需要连接哪个集成。

不在本技能范围内——请转交给其他技能

  • 创意生成(产品图片、文案)→ ad-creative-generation / image-generation。
  • 跨平台广告活动发布 → 在 Amazon 上使用本技能,然后分别调用 meta-ads / google-ads。

工具一览

工具用途
amazon_ads_profiles_list、amazon_ads_health_check发现广告档案并检查集成健康状态。
amazon_ads_campaigns_list、amazon_ads_campaigns_create、amazon_ads_campaigns_update广告活动生命周期管理。
amazon_ads_ad_groups_create、amazon_ads_product_ads_create创建广告组和商品广告。
amazon_ads_keywords_create、amazon_ads_negative_keywords_create、amazon_ads_campaign_negative_keywords_create关键词定向。
amazon_ads_product_targets_create、amazon_ads_negative_product_targets_create商品(ASIN/类别)定向。
amazon_ads_budget_rules_create、amazon_ads_budget_rules_list预算自动化。
amazon_ads_reports_create、amazon_ads_reports_status_get效果报告。
amazon_ads_bid_recommendations_get基于主题的出价建议。

关键规则

关键:关键词、否定关键词、商品广告和商品定向操作都需要同时提供 ad_group_id 和 campaign_id。省略 campaign_id 会导致验证错误。

关键:同一广告组中不能同时使用关键词和商品定向。每个广告组只能选择一种定向类型。

关键:AUTO 广告活动只允许使用否定关键词和否定商品定向。系统会拒绝正向关键词和商品定向。

关键:广告活动日期使用 YYYY-MM-DD 格式。预算规则日期使用 YYYYMMDD 格式。请勿混淆。

关键:创建广告活动时,状态设为 "PAUSED"。未经用户审核,切勿启动实时投放。

关键:否定商品定向仅支持 ASIN_SAME_AS 和 ASIN_BRAND_SAME_AS 表达式。不支持排除类别。

关键:所有枚举值都必须使用大写:PAUSED、ENABLED、BROAD、PHRASE、EXACT、NEGATIVE_EXACT、NEGATIVE_PHRASE、MANUAL、AUTO。

重要:供应商账户的 Portfolio 操作会返回 404。请改用广告活动级管理。

重要:即使成功创建预算规则,规则列表也可能为空。请记录创建响应中的规则 ID。

重要:所有预算金额单位均为美元(不是美分,也不是微单位)。每日预算为 25 美元时,填写 25。

核心流程

发现 → 调研(产品 + 关键词)→ 制定策略(自动或手动)→ 审批摘要 → 创建(PAUSED)→ 添加关键词/产品 → 添加否定项 → 测试(1–3 天)→ 优化 → 仅在用户批准后激活。

所有参考文件均位于 references/ 目录中。 请在 references/<file> 处读取(例如 references/discovery.md)。

路由表

用户想要……请先阅读这些文件
发起 Sponsored Products 广告活动references/discovery.md → references/campaign-creation.md
向现有广告活动添加关键词/否定关键词/商品定向references/campaign-creation.md
自动管理预算(排期或效果规则)references/budget-rules.md
分析效果/ACoS/搜索词references/reporting.md
获取竞价建议references/reporting.md
跨市场运营(多个配置文件)references/reporting.md
目标尚不明确references/discovery.md — 通过需求梳理明确目标

广告活动状态

  • PAUSED:已创建,但尚未投放(安全的默认状态)。
  • ENABLED:正在投放并消耗预算。
  • ARCHIVED:已删除(无法恢复)。

已知限制

问题解决方法
广告组合操作返回 404(供应商问题)使用广告活动级分组和命名约定。
预算规则列表可能为空根据创建响应记录规则 ID。
类别建议可能失败(500)使用人工调研或控制面板。

安全规则

切勿:

  • 臆测 ASIN 或关键词——务必先询问。
  • 跳过调研/审核阶段。
  • 未经明确批准创建广告活动。
  • 未经用户同意将广告活动设为 ENABLED。
  • 在提供竞价建议时忽略 ACoS 目标。
  • 添加用户尚未确认的商品。
  • 在同一广告组中混用关键词和商品定向。
  • 在关键词/商品操作中省略 campaign_id。

评论

支持 Markdown