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 转化事件的关联
- 统一的预算分配建议
如何连接(快速入门)
- 添加连接器 URL(
https://connector.get-ryze.ai/mcp)在 AI 助手的 Connectors 界面中(Claude Desktop、Claude Code、ChatGPT、Cursor、Windsurf、n8n 等)。 - 登录使用拥有 Google Ads/GA4 资源的 Google 账户或拥有 Meta 广告账户的 Facebook 账户。服务器处理 OAuth 2.1 + PKCE;不需要开发者令牌或 API 密钥。
- 批准写入 – 任何更改广告活动、预算或创意的操作都会先暂存,必须通过 Ryze 界面批准后才发送至底层 API。
- 开始提示 – 要求助手列出广告活动、创建新广告、提取 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 界面的逐步连接指南。
相关
- 项目
- 项目
- 项目
- 项目
- 项目