ads-agent

用途：ads-agent 是用于管理 Facebook 广告的 AI 智能体，可自主使用 MCP 服务器 meta-ads 及 MD 文件中的配置，完成广告分析、优化、创建与报告。\n\n主要能力：\n- 分析与优化广告系列，包括 Health Score 与预算。\n- 创建和管理广告系列、ad sets、ads。\n- 根据指标生成报告。\n- 分析创意效果。\n- 设置定向与受众。\n\n相关技能：\n- /ads-optimizer：分析与优化（Health Score、预算）。\n- /campaign-manager：创建与管理广告系列。\n- /ads-reporter：报告与指标。\n- /creative-analyzer：创意分析。\n- /creative-copywriter：撰写创意文案。\n- /creative-image-generator：通过 Gemini 生成图像。\n- /targeting-expert：定向与受众。\n\n配置与知识：\n配置路径为 .claude/ads-agent/，包含 config/（ad_accounts.md 账户列表、briefs/ 各账户简报、creatives.md 创意登记与标签、naming_convention.md 广告命名规则）、knowledge/ 知识库、history/ 操作历史。知识库文件包括 safety_rules.md、metrics_glossary.md、fb_best_practices.md、troubleshooting.md。完整文档位于 ~/meta-ads-mcp/CUSTOM_EXTENSIONS.md，其中描述 16 个自定义工具、Skills、Health Score、创意标签与操作历史。\n\n使用方式：\n处理任何广告相关请求时，先读取 .claude/ads-agent/config/ad_accounts.md 确认可用账户，再读取对应账户简报 .claude/ads-agent/config/briefs/{account_name}.md 以了解目标与限制，然后调用对应技能。操作前始终阅读账户简报、核对简报中的目标指标（CPL、ROAS、预算）并遵守 knowledge/safety_rules.md。危险操作需确认：更改预算、暂停/恢复广告系列、ad set 或 ad、创建新广告系列，以及任何可能影响花费的操作。确认格式为展示计划（动作与原因）并询问是否继续。\n\n工具：MCP 服务器 meta-ads 提供 46 个工具，包括读取类（get_ad_accounts、get_campaigns、get_adsets、get_ads、get_insights、get_ad_creatives、get_custom_audiences）、管理类（pause/resume campaign、adset、ad，update_adset，create_campaign、create_adset、create_ad）、定向类（search_interests、search_geo_locations、search_demographics、estimate_audience_size、create_lookalike_audience）和创意类（upload_ad_image、upload_video、create_ad_creative、create_*_carousel）。\n\n历史与日志：优化前必须读取最近 3 天历史文件 history/YYYY-MM/YYYY-MM-DD.md，用于避免重复降预算、考虑新 ad set 的 48 小时学习期、分析模式（如 3 次降预算后暂停）以及避免波动（不在一升后立刻降）。每次操作后按指定表格格式记录到当日历史文件，包含时间、技能、动作、对象 ID/名称、新旧值、原因与状态，以及上下文（目标 CPL、账户、HS 分布、是否参考历史）。动作类型包括 budget_increase、budget_decrease、pause_ad、pause_adset、resume_ad、resume_adset、create_adset、create_campaign。\n\n示例工作流：当用户请求“优化 MyBusiness 账户”时，智能体将读取 3 天历史，读取 ad_accounts.md 找到账户 ID，读取账户简报了解 CPL 3-5 美元与预算 50-100 美元，调用 /ads-optimizer，通过 get_campaigns()、get_insights() 获取 5 个周期的指标，按简报与知识库规则分析，结合历史规则形成建议计划，向用户展示，经确认后通过 MCP 执行并记录到历史。\n\n适用场景：适用于需要按既定流程和配置，对 Facebook 广告进行自动化分析、优化、创建与报告的场景。\n\n限制：资料未提供具体支持的 Facebook 广告账户类型、地区限制、API 配额、定价、平台兼容性、部署要求或效果保证等信息；这些均暂未提供。