irinabuht12-oss/google-ads-meta-ads-mcp

Google Ads MCP server + Meta Ads MCP (Facebook Ads MCP) + Google Analytics MCP (GA4) + Search Console in one hosted remote MCP for Claude, ChatGPT, Cursor & n8n: OAuth login, no API keys, approval-gated writes, 7-day free trial. By Ryze AI.

这个仓库是什么?

google-ads-meta-ads-mcp 是一个远程 Model Context Protocol (MCP) 服务器的源代码,将三个主要的广告和分析 API 公开为“工具”,可供 Claude、ChatGPT、Cursor、n8n、Windsurf 等 AI 助手调用。

  • Google Ads API(广告活动、关键字、出价、报告等)
  • Meta (Facebook/Instagram) Marketing API(广告活动、广告组、创意、受众、报告等)
  • Google Analytics 4 Data API(标准、实时、受众、资源设置等)

服务器实现了开源的 Model Context Protocol,使 LLM 可以通过自然语言提示调用这些工具。Ryze AI 在 https://connector.get-ryze.ai/mcp 托管服务器;仓库包含代码、文档,以及 250 多个可用工具的目录。


谁可能使用它?

角色 重要性
营销人员 / 代理商 从单一聊天式界面管理 Google Ads、Meta Ads 和 GA4,写入访问需经过批准步骤。
LLM 驱动的工作流构建者 将 MCP 端点插入 Claude、ChatGPT、Cursor、n8n、Windsurf 等,以自动化广告创建、预算调整、性能审计和跨平台报告。
AI 代理开发人员 使用 MCP 规范为自定义代理添加丰富的广告工具箱,无需处理 OAuth、API 密钥或单独 SDK。
产品团队 为客户提供托管的“广告即服务”功能,让客户无需自行托管 API 即可进行 AI 驱动的广告活动管理。

核心功能(按 README 所列)

Google Ads(约 150 个工具)

  • 搜索、展示、购物、效果最大化、需求开发、视频、应用的广告活动 CRUD
  • 通过 Keyword Planner 进行关键字研究(流量、CPC、竞争程度)
  • 出价与预算工具、组合策略、出价调整
  • 创意创建(自适应搜索/展示广告、需求开发广告、应用广告)
  • 受众定位(自定义、再营销、客户匹配、组合)
  • 完整性能分析(指标、ROAS、搜索词、否定关键字建议)
  • 附加信息(站点链接、摘要、来电、图片、价格、促销、潜在客户表单)
  • 实验与 A/B 测试
  • 转化跟踪设置与上传

Meta Ads(约 80 个工具)

  • 跨 Facebook 和 Instagram 的广告活动、广告组和创意 CRUD
  • 预算、排期、版位和优化控制
  • 受众工具(自定义、类似、兴趣/行为/人口统计)
  • 潜在客户开发表单和产品目录管理
  • 主页管理(帖子、速推帖子、洞察)
  • 商业账户管理(用户、主页、像素)
  • 详细性能洞察与细分

Google Analytics 4(约 20 个工具)

  • 标准、透视和实时报告
  • 受众、细分和渠道组列表
  • 资源设置(数据流、增强型评估、保留)
  • 归因模型设置
  • 事件与转化管理
  • 集成链接(BigQuery、DV360、搜索广告、Firebase)
  • 资源级注释和元数据查询

跨平台功能

  • Google 和 Meta 广告活动的并排 ROAS 比较
  • 广告支出与 GA4 转化事件的关联
  • 统一的预算分配建议

如何连接(快速入门)

  1. 添加连接器 URL(https://connector.get-ryze.ai/mcp)在 AI 助手的 Connectors 界面中(Claude Desktop、Claude Code、ChatGPT、Cursor、Windsurf、n8n 等)。
  2. 登录使用拥有 Google Ads/GA4 资源的 Google 账户或拥有 Meta 广告账户的 Facebook 账户。服务器处理 OAuth 2.1 + PKCE;不需要开发者令牌或 API 密钥。
  3. 批准写入 – 任何更改广告活动、预算或创意的操作都会先暂存,必须通过 Ryze 界面批准后才发送至底层 API。
  4. 开始提示 – 要求助手列出广告活动、创建新广告、提取 GA4 报告等。助手会将自然语言请求转换为适当的 MCP 工具调用。

README 提供每个助手的设置指南(docs/SETUP_*.md)和各平台的示例提示。


限制与注意事项

  • 托管服务 – 服务器在 Ryze 的基础设施上运行;您必须使用其订阅(付费广告方案每月 $89 美元,7 天免费试用)。代码是开源的,但托管端点是付费产品。
  • 写入控制 – 所有写入操作都需经过批准步骤,以防止意外更改预算。这增加了手动检查点。
  • OAuth 范围 – 连接器只能对登录用户有权管理的账户采取行动。
  • 速率限制 – 底层的 Google 和 Meta API 会执行自己的配额;大量自动化可能需要额外的配额请求。
  • 功能对等 – 虽然列表很广泛,但某些小众的 Google Ads 或 Meta Marketing API 功能可能尚未包装为 MCP 工具。

TL;DR

google-ads-meta-ads-mcp 将 Google Ads、Meta Ads 和 GA4 API 整合到单一远程 MCP 服务器中,AI 助手可以将其作为自然语言工具调用。它消除了对单独 API 密钥、开发者令牌或自行托管服务器的需求,为营销人员和 AI 代理开发人员提供读写访问(需批准)。仓库包含服务器实现、250 多个工具的目录,以及热门 LLM 界面的逐步连接指南。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目