meta-ads

Meta Ads

用于创建和管理 Meta 广告系列、分析效果，以及根据缓存数据构建仪表板的策略指南。除非用户明确要求手动控制，否则默认使用 Advantage+。

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

请求	转交给
竞品或公开广告研究（Meta Ads Library）	meta-ads-library
广告创意生成（图片、文案变体）	ad-creative-generation
Google Ads 广告系列	google-ads
Pinterest / TikTok / Amazon 付费广告系列	pinterest-ads、tiktok-ads、amazon-ads

要求

• 已安装并连接 Hyper MCP。 https://app.hyperfx.ai/mcp
• 已连接 Meta Business 集成（Facebook + Instagram，且至少有一个广告账户和一个 Page），地址为 https://app.hyperfx.ai/apps。
• 已连接 Firecrawl 集成，用于网站研究和截图依据（探索阶段）。

如果 search("meta_ads_adaccount_list") 未找到 meta_ads_adaccount_list，请停止并告知用户启用 Hyper MCP 并连接 Meta Business。

如果怀疑存在连接问题（缺少广告账户、发布 Page 失败或权限错误），请调用 meta_ads_health_check()，并在继续操作前报告诊断结果。

如何运行此技能中的工具

此技能中的每个工具都以其规范工具名称命名。使用你所用界面提供的调用方式运行：

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

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

工具名称

请使用已连接工具列表中的确切工具名称。规范名称为 meta_ads_*（如下所列）。在 Hyper 平台聊天中，旧版 meta_business_* 名称（例如 meta_ads_adaccount_list）和已弃用的复数名称（例如 meta_ads_campaign_create）会通过别名解析到相同工具 — 如果调用失败并提示“tool not found”，请在实时目录中搜索规范名称。

分组	工具
探索	meta_ads_adaccount_list、meta_ads_owned_pages_list、meta_ads_pages_search、meta_accounts_list、meta_ads_instagram_accounts_list
健康检查与同步	meta_ads_health_check、meta_ads_health_get
跟踪资源	meta_ads_ad_pixels_list、meta_ads_ad_pixels_get、meta_ads_custom_audiences_list、meta_ads_lookalike_audiences_list、meta_ads_targeting_search
分步创建（首选）	meta_ads_campaign_create、meta_ads_adset_create、meta_ads_ad_create、meta_ads_ad_images_upload、meta_ads_creative_create
读取与预览	meta_ads_campaign_get、meta_ads_campaigns_search、meta_ads_adset_list、meta_ads_ad_list、meta_ads_ad_get、meta_ads_ad_previews_get
成效数据与仪表板	meta_ads_insights_get、data_apps_build、database_query
启动与编辑	meta_ads_campaigns_activate、meta_ads_campaign_update、meta_ads_adset_update、meta_ads_ad_update
自动化规则	meta_ads_adrule_create、meta_ads_adrule_list、meta_ads_adrule_get、meta_ads_adrule_update、meta_ads_adrule_delete、meta_ads_adrule_history_list
网站研究	firecrawl_branding_extract、firecrawl_screenshots_create

CLI 用户：使用 hyper-cli 技能转换工具名称（hyperai search "<tool name>"）。

---

绝不能忘记的规则

预算以美分为单位：$20.00 = 2000。$5.50 = 550。$100 = 10000。切勿直接传入美元金额。

激活，而非更新：使用 meta_ads_campaigns_activate(campaign_id) 来正式投放。切勿使用 meta_ads_campaign_update(status="ACTIVE")——这会悄悄让广告组和广告保持 PAUSED 状态，导致广告无法投放。

始终从暂停状态开始：创建广告系列时将 status="PAUSED"。未经用户审核，切勿直接上线。

逐步构建：使用各个工具创建广告系列：meta_ads_campaign_create → meta_ads_adset_create → meta_ads_creative_create → meta_ads_ad_create，并从上一步的响应中获取各个 ID。（旧版蓝图工具已移除。）这些工具会在发送前验证请求，包括广告系列目标规则、出价策略与出价金额的搭配、计费事件与优化目标的兼容性、预算一致性；但特定于目标的广告组字段（optimization_goal、promoted_object）由你负责：请使用对应广告系列类型的参考文件，使其与广告系列目标匹配。

受监管的广告主需要设置 special_ad_categories：对于赌博、金融、住房、就业、信贷或政治类广告主，在 meta_ads_campaign_create 中声明类别（例如 special_ad_categories=["ONLINE_GAMBLING_AND_GAMING"]）。

固定投放时段应设置在广告组上：当用户指定投放时长或日期（“投放 7 天”“持续到月底”）时，在 meta_ads_adset_create 上设置 start_time 和 end_time（ISO 8601 格式）。没有 end_time 的每日预算广告组会持续投放，直到手动暂停——用户要求的时间窗口会悄然失效。

以落地页内容为文案依据（先调研）：当需求围绕某个 URL 展开（“为 https://... 创建广告系列”）时，先获取该页面（web_pages_fetch）——在探索和撰写任何文案之前——并根据页面实际内容（产品名称、价值主张、优惠）撰写广告文案。切勿为尚未阅读的页面编造文案；即使用户提供了确切的文案或标题，也要先获取页面，确认落地页与优惠内容相符。

定向欧盟的广告组需要 DSA 字段：如果广告组定向欧盟，请在 meta_ads_adset_create 上设置 dsa_beneficiary 和 dsa_payor（广告的受益方／付款方）——这是《欧盟数字服务法案》的要求，否则投放会受限。

每个落地页广告都要设置 UTM（url_tags）：在每个跳转至落地页的广告素材上设置 url_tags（UTM 参数，例如 utm_source=meta&utm_medium=paid&utm_campaign=...）。下游衡量工具（例如 AppsFlyer 和数据仓库）会基于这些参数关联数据，因此不带 UTM 的广告实际上无法衡量。请使用广告主的标准模板；如果没有，请先询问，不要发布无法追踪的广告。

完整约束请参阅 references/constraints.md。

**所有参考文件都位于 references/ 中。**请在 references/<file> 中读取（例如 references/discovery.md）。这些文件不与此 SKILL.md 位于同一目录。

---

核心流程

每项任务都必须遵循以下顺序。不要跳过步骤。

1. 确定目标——创建、分析，还是两者兼有？
2. 检查路由表，并在调用任何工具之前阅读其中引用的文件
3. 制定书面计划——说明广告系列类型、以美分为单位的预算、优化目标和执行步骤；执行前先展示计划
4. 逐步执行，每个创建步骤都重新检查 references/constraints.md
5. 激活前展示广告预览
6. 仅在用户批准后使用 meta_ads_campaigns_activate() 激活

**自动／计划运行：**如果没有用户可以交互（例如计划任务），则跳过步骤 3 和 6。不要编写计划并等待确认——直接继续。除非任务说明明确要求激活，否则不要激活。

路由表

用户想要……	首先阅读这些文件
创建销售／转化营销活动	references/discovery.md → references/campaigns/sales.md
创建潜在客户营销活动	references/discovery.md → references/campaigns/leads.md
创建流量营销活动	references/discovery.md → references/campaigns/traffic.md
创建品牌认知或互动营销活动	references/discovery.md → references/campaigns/awareness-engagement.md
创建应用推广营销活动	references/discovery.md → references/campaigns/app-promotion.md
创建营销活动（任意目标）	references/discovery.md → 上文对应的 references/campaigns/*.md，然后逐步构建
分析效果／查询洞察	references/analytics.md
审核账户／寻找优化机会	references/account-audit.md
设置自动化规则（自动暂停、预算保护、提醒）	references/automated-rules.md
构建 Meta 仪表板或数据应用	references/analytics.md → references/dashboards.md
分析效果，然后创建营销活动	references/analytics.md → references/discovery.md → 相关营销活动文件
构建漏斗／同时创建多个营销活动（TOF/MOF/BOF）	references/multi-campaign-funnel.md → references/discovery.md → 各层级的营销活动文件
尚未确定目标	references/discovery.md — 通过需求探索明确目标

---

示例

• 完整销售营销活动（电子商务、Advantage+、分步说明）：references/examples/sales-ecommerce.md
• 完整潜在客户营销活动（B2B SaaS、网站像素、分步说明）：references/examples/leads-form.md