meta-ads-mcp 的 Duplication（复制）工具，让 AI 助手用一句自然语言就能一键复制广告计划：整棵 campaign → ad set → ad → creative 投放结构秒级克隆，还能顺手改预算、排期和文案。无需写代码，对话即可克隆，是跑 A/B 实验、活动备份与跨计划迁移的省时利器。本文带你快速上手这套 Meta 广告复制全攻略。

🎯 为什么需要一键复制广告计划？

投放 Meta 广告（Facebook / Instagram）时，你可能经常遇到这些场景：

• A/B 实验：想测试不同定向或文案，但原计划配置太复杂，从零重建费时费力；
• 计划备份：活动结束前，需要保留一份"暂停状态的完整副本"存档；
• 跨计划迁移：把表现好的广告组搬进新计划，或把素材复用到不同广告；
• 批量复刻：换季营销时，基于旧计划快速派生新计划，只改预算和排期。

传统做法要在 Meta 广告后台逐层手动操作。而 meta-ads-mcp 的 Duplication 工具把整个流程压缩成一句对话——告诉 AI"把这个计划复制一份"，它会自动处理四层结构的克隆。

🧩 Duplication 工具支持哪些克隆操作？

Duplication 功能实现在 meta_ads_mcp/core/duplication.py 中，提供 4 个逐层递进的 MCP 工具：

📦 复制计划时能顺手改什么？

以duplicate_campaign为例（参数定义见 duplication.py），常用参数让你"复制即定制"：

• name_suffix：副本名称后缀，默认" - Copy"，一眼区分原版和副本；
• include_ad_sets/include_ads/include_creatives：控制复制到哪一层，默认全部包含；
• new_daily_budget：直接给副本设定新日预算，无需复制后再改；
• new_start_time/new_end_time：调整投放排期（ISO 8601 格式）；
• new_status：副本状态，默认PAUSED（暂停）——先克隆再检查，防止误花钱；
• copy_schedule：是否沿用原计划的预算排期。

复制广告组还支持new_targeting（替换定向）与target_campaign_id（把副本放进指定计划）；复制素材时可用new_primary_text、new_headline、new_cta_type、new_destination_url等参数直接改写文案与落地页。

🚀 如何一键复制广告计划：三步对话式操作

第 1 步：连接远程 MCP（约 2 分钟）

推荐直接使用Hosted 远程 MCP，无需自建服务器、无需开发者 token：

1. 打开常用的 AI 客户端（Claude / ChatGPT / Cursor / Perplexity 均可）；
2. 添加 MCP 集成，填入 meta-ads 远程 MCP 端点（如 Claude 中在Add Integration填入https://meta-ads.mcp.pipeboard.co/）；
3. 按提示登录并关联你的 Facebook 广告账户。

完整接入流程见 README.md 的 "Getting started with Remote MCP" 章节，HTTP 传输配置细节可参考 STREAMABLE_HTTP_SETUP.md。

第 2 步：用一句话发起克隆

连接完成后，直接用自然语言吩咐 AI，例如：

"把计划 1234567890 复制一份，名字加后缀「3月大促版」，日预算改成 50 美元，先保持暂停状态。"

AI 会自动调用duplicate_campaign，传上name_suffix、new_daily_budget、new_status等参数，完成整棵结构的克隆。

第 3 步：检查并激活副本

克隆完成后：

1. 让 AI 列出新计划下的广告组与广告，核对结构是否完整；
2. 确认无误后再让 AI 将副本状态改为ACTIVE开始投放；
3. 副本默认带" - Copy"后缀，方便后续在后台与原版对照。

⚠️ 使用 Duplication 工具的注意事项

• 功能开关：本地部署时，复制工具受环境变量META_ADS_ENABLE_DUPLICATION控制，默认关闭，需显式设置后才会注册（见 duplication.py）。
• 认证要求：复制请求需同时具备 Pipeboard API token 与 Meta 访问凭证，缺少任一都会返回authentication_required错误，按提示连接 Facebook 账户即可。
• 默认暂停是安全设计：新副本默认PAUSED，与整个服务器"写操作需确认"的安全模型一致，避免克隆即扣费。
• 限流处理：遇到 Meta API 频率限制（429）时，工具会返回retry_after建议，稍等片刻重试即可。
• 结构化错误信息：资源不存在（404）、权限不足（403）、需要订阅（402）等场景都会给出明确的error类型与处理建议，便于快速排查。

错误处理逻辑集中在 meta_ads_mcp/core/duplication.py 中，功能与回归测试覆盖见 tests/test_duplication.py 和 tests/README_REGRESSION_TESTS.md。

✅ 小结：克隆 Meta 广告的正确打开方式

用 meta-ads-mcp 的 Duplication 工具，"一键复制广告计划"不再是后台里的繁琐点击，而是一次轻松的 AI 对话。无论是 A/B 实验、活动备份还是跨计划迁移，克隆 Meta 广告从此又快又稳。