Ads Uploader — Meta Ads MCP

Ads Uploader — Meta Ads MCP

Ads Uploader 的 Meta Ads MCP 服务可帮助你通过 Claude、ChatGPT、Cursor 和 Codex 创建并管理 Meta（Facebook 和 Instagram）广告。

---

Ads Uploader 可将你正在投放的现有广告设置转换为可重复使用的模板，并以此批量创建全新广告——替换媒体、文案、CTA 和定向。它还可以按帖子复制现有广告，以保留社交证明。将 AI Agent 接入后，只需描述你想要的广告即可。

Agent 辅助与完全 Agent 驱动。 对于 Agent 辅助的广告投放，我们建议让 Agent 组装一个已保存的构建方案，而不是在没有人工介入的情况下创建广告——该方案可在 Ads Uploader 网页应用中查看、编辑和启动，因此你可以在精致的界面中保留人工审核和启动步骤。

需要已有付费 Ads Uploader 账户并拥有 MCP 访问权限，同时还需连接具备必要权限的 Meta 账户。试用版不包含 MCP 访问权限。

此存储库包含公开文档和连接器配置。Ads Uploader 是专有产品；其应用程序、后端和 MCP 服务实现不在此处提供。有关可复用权限范围，请参阅许可证。

功能

• 根据模板构建广告 — 复制任意现有广告的设置，然后替换媒体、文本、CTA、链接和定向。
• 批量创建 — 在一次任务中跨多个广告系列和广告组创建大量广告，并为每个广告设置不同的文本和创意选项。
• 按帖子复制 — 根据主页帖子 ID 克隆现有广告，让原帖的赞、评论和分享保留在新广告系列中。
• 合作伙伴（品牌内容）广告 — 以合作伙伴身份与创作者或品牌一起投放广告，可使用自己上传的媒体或导入的 Instagram 帖子，并为所有广告共享赞助商，也可按广告或广告组设置赞助商。（见下文。）
• 媒体工作流 — 从公开 URL、Google Drive 文件夹或本地文件导入创意素材。
• 启动前预览 — 解析规格、检查 Meta 权限，并准确查看将创建的内容。
• 多账户支持 — 列出并使用你有权访问的所有 Meta 广告账户、主页和已连接的 Instagram 账户。

为什么选择 Ads Uploader

Ads Uploader 基于十年亲自投放 Meta 广告的经验，为 Agent 提供目前最深入、最完整的 Meta（Facebook & Instagram）广告创建工作流——涵盖端到端实际投放广告系列所需的一切：

• 从任意在线广告创建模板——复制已验证广告的确切设置，然后在此基础上使用新素材、新文案和新定向重新创建。
• 真正的批量操作——在单个任务中跨多个广告系列和广告组创建多个广告，并为每个广告和广告组设置文案。
• 合作 / 品牌内容广告——支持上传素材的合作广告（Facebook + Instagram）和导入的 Instagram 创作者帖子，并可设置共享或按广告 / 广告组配置的赞助方及标题模式。
• 复制并保留社交证明——按帖子克隆，让点赞、评论和分享延续到新广告系列中。
• 丰富的创意功能——轮播、灵活格式、多媒体、动态优化、创意增强、Advantage+ 定向、行动号召和 URL 标记。
• 以人为参与流程为设计核心——仅验证预览和已保存的构建结果，让你在 Web 应用中完成后续操作。

由一支大规模投放 Meta 广告的团队打造，并深受管理大量 Meta 广告预算的效果营销人员和代理商信赖。

安装

Claude Code

claude mcp add --transport http ads-uploader https://adsuploader.com/api/mcp

Claude 桌面版 / Claude.ai

设置 → 连接器 → 添加自定义连接器 → 粘贴 URL，然后在浏览器中完成登录和授权：

https://adsuploader.com/api/mcp

ChatGPT

设置 → 连接器（自定义 MCP）→ 添加服务 URL https://adsuploader.com/api/mcp → 按提示登录。

Cursor

将 Ads Uploader 添加到 Cursor

此仓库包含 Agent Plugins 的 plugin.json 和 mcp.json，以及一个用于目录发现的 .mcp.json 兼容文件。该插件连接到托管服务；身份验证在浏览器中进行。

添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "ads-uploader": {
      "url": "https://adsuploader.com/api/mcp"
    }
  }
}

添加服务后，完成 Ads Uploader 登录并同意授权提示。让 Agent 列出你的广告账户，以检查连接。

Grok

打开 Grok 连接器，选择 新建连接器 → 自定义，然后输入 https://adsuploader.com/api/mcp。按照身份验证提示操作。有关前提条件和提示词示例，请参阅 Grok 连接指南；此主机连接仍待端到端测试。

Codex

添加到 ~/.codex/config.toml：

[mcp_servers.ads-uploader]
command = "npx"
args = ["mcp-remote", "https://adsuploader.com/api/mcp"]

本地 stdio 包

适用于需要直接从磁盘上传文件的主机。需要 Node.js 18+。

npm install -g @adsuploader/cli @adsuploader/mcp
ads login

{
  "mcpServers": {
    "ads-uploader": {
      "command": "ads-mcp"
    }
  }
}

托管服务通过浏览器中的 OAuth 进行身份验证——无需复制令牌。本地包会读取 ads login 保存的凭据。让 Agent 列出我的广告账户，以确认连接。

工具

每个工具都带有显示标题以及只读／破坏性操作提示，供宿主显示适当的防护措施。

账户与发现（只读）

工具	功能
ads_whoami	显示此会话以哪个 Ads Uploader 用户身份通过身份验证
ads_list_accounts	列出你可使用的 Meta 广告账户
ads_list_campaigns	列出广告账户中的广告系列（可按名称／状态筛选）
ads_list_adsets	列出广告系列中的广告组
ads_list_ads	列出广告组中的广告
ads_get_ad	获取一条广告及其创意详情
ads_list_pages	列出 Facebook 公共主页及其关联的 Instagram 账户
ads_search_targeting	搜索用于构建的 Meta 定向值

预设与已保存的构建

工具	功能
ads_list_presets / ads_get_preset	浏览已保存的 API 和广告文案预设
ads_save_preset	将现有广告保存为可重复使用的预设
ads_list_builds / ads_get_build	浏览已保存的上传器构建
ads_save_build / ads_update_build	创建或编辑可长期保存的构建
ads_fork_build	从已保存的构建派生新的草稿
ads_delete_build	删除已保存的构建

媒体

工具	功能
ads_upload	从 URL、Google Drive 文件夹或磁盘上传媒体
ads_upload_finalize	完成预签名上传批次
ads_list_uploads / ads_get_upload	列出批次或轮询导入任务

创建与复制

工具	功能
ads_create	根据完整的 AdSpec 或已保存的构建创建广告，包括合作伙伴广告
ads_preview	解析规范、检查 Meta 权限和合作伙伴赞助方，但不创建任何内容
ads_duplicate_by_post	按公共主页帖子 ID 复制广告，并保留社交证明
ads_duplicate_by_post_preview	预览按帖子 ID 进行的复制
ads_get_job / ads_get_duplication	轮询或恢复正在运行的任务
ads_cancel_job	取消创建或导入任务

完整的参数参考（Agent 应遵循）请参阅 SKILL.md。

合作伙伴（品牌内容）广告

ads_create 和 ads_preview 支持通过两种方式投放合作伙伴广告：

• 使用你自行上传的媒体，在 Facebook 或 Instagram 上创建合作伙伴广告——按公共主页和／或 Instagram 账户选择合作伙伴（第二身份），将其应用于整个投放或按广告／广告组分别应用，并选择标题栏模式（双方身份、仅合作伙伴或动态）。支持仅使用 Instagram 的合作伙伴。
• 导入现有的 Instagram 创作者帖子，可通过 URL、短代码、来源 ID 或广告代码导入，并按广告、按广告组或统一设置赞助方和文案。

预览会报告每条广告实际使用的赞助方，并在创建任何内容之前检查第一身份的合作伙伴授权。不支持导入 Facebook 帖子、混合帖子／上传批次，以及在导入帖子上投放 Threads 广告。

示例提示词

• “使用我的 Sales 广告组中的任意广告作为模板，投放这 100 个创意素材，并为每个素材撰写独特的标题和主要文案。”
• “以我效果最好的销售广告为基础，制作 20 个变体，采用不同的主要文案开头，并在新的广告组中全部暂停。”
• “根据这些创意素材和文案整理一个已保存的构建，然后把 Ads Uploader Web 应用中供我审核和投放的链接发给我。”
• “将此 Facebook 帖子对应的广告复制到我的 Retargeting 广告组，以保留点赞和评论。”
• “将此 Instagram 创作者帖子作为合作伙伴广告导入，以我们的品牌为赞助方，并在创建前预览赞助方。”
• “上传此 Google Drive 文件夹中的创意素材，然后在新的广告组中据此构建广告，并为每款产品撰写独特的开头。”
• “在任何内容上线之前，预览从我已保存的构建 ‘Q4 Prospecting’ 中将会创建的内容。”
• “搜索 ‘home fitness’ 的兴趣定向，并将最匹配的结果添加到我的构建中。”

工作原理

• 先起草 / 预览。 ads_preview 通过只读和仅验证调用解析帖子、媒体和权限 — 它不会创建广告或存储代码。
• 交由 Web 应用处理。 Agent 无需无头启动，而是可以组装一个已保存的构建并向你提供链接 — 它会在 Ads Uploader Web 上传器中加载（已打开的标签页会自动获取），让你在完整界面中审核并启动。
• 长时间运行的任务仍可保持响应。 托管服务会在约 60 秒后返回带有 jobId 的 still_running，使工具调用保持在代理截止时间内；使用 ads_get_job 恢复。
• 使用 OAuth，而非令牌。 托管服务会在你的浏览器中通过 OAuth 2.1 (PKCE) 进行身份验证。

了解更多

• 文档： https://adsuploader.com/docs/ad-configuration/mcp
• 网站： https://adsuploader.com/meta-ads-mcp
• 安全： SECURITY.md · 隐私： PRIVACY.md

支持

有疑问或遇到问题：[email protected]

许可证

LICENSE 中明确列出的文档、示例和连接器配置采用 MIT 许可证。你可以复用和改编这些文件，但须保留许可证和版权声明。plugin.json 中的 license 字段仅适用于此公开连接器包以及该许可证涵盖的文件。

Ads Uploader 仍为专有产品。 托管产品、应用程序和后端源代码、MCP 服务实现、API / CLI 实现，以及单独分发的 npm 包（包括 @adsuploader/mcp 和 @adsuploader/cli）均不属于此许可证的范围。链接到某个包或服务并不意味着其实现也获此许可证授权。服务使用仍受你的订阅、权限和服务条款约束。

assets/ 目录、徽标、品牌艺术作品和商标不在 MIT 许可证范围内。被排除材料的所有权利均由各自所有者保留。此处不授予任何暗示关联或背书的权利。