Token导航 LogoToken导航TokenDH.com
Google Ads Copilot logo
开发工具未说明官方级别未说明来源级核验

Google Ads Copilot

MCP Server

Google Ads Copilot是一款AI代理工具,通过分析搜索行为建立意图地图,优化广告结构并生成可审核的修改建议,适用于Google Ads账户管理。

工具数

17

提示词数

0

GitHub Stars

189

资源数

0
ShellAI代理开发工具

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

TheMattBerman

提供方

TheMattBerman

最后核验

2026/5/17 20:21

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

详细介绍

谷歌广告复制品

公共Alpha--生成器预览 我构建了一个OpenClaw代理,通过意图分析而不是出价自动化来管理谷歌广告账户。所有三层——阅读→ 草稿→ 应用-是实时的,并在真实账户上进行测试。对于想要尝试意图优先方法的建筑商和机构来说,这是一个早期版本。

大多数谷歌广告问题不是竞价问题。 他们是 意图混合问题.

你的账户正在购买不同类型的搜索——买家、比较购物者、研究人员、求职者、赠品猎人——并将它们混合在一起。当这种情况发生时,出价会针对噪音进行优化,注册系统管理人会获得通用性,好的流量会补贴坏的流量,每个预算决策都会被扭曲。

Google Ads Copilot是一个人工智能代理,可以读取搜索行为,构建持久的意图图,发现浪费,隔离信号,并将帐户正在学习的内容转化为结构、复制和规模决策。每一条建议都被分为可审查的草案。没有你的批准,什么都不会改变。

不是仪表板。不是出价优化工具。不是通用的审计清单。

有记忆力的战略家。

______________________________________________________________________

运作原理

READ  →  DRAFT  →  APPLY
发生了什么
阅读通过谷歌官方推送真实账户数据 google-ads-mcp MCP服务器(只读)。或者使用手动CSV导出——无论哪种方式都是相同的分析引擎。
草稿每一个可操作的发现都变成了一个具体的建议——具体的负面因素、结构变化、预算变动、RSA方向——供人类审查。
应用对已批准的草稿进行受控回写。实时范围: 添加负面关键字, 暂停关键字/广告组,以及 活动每日预算变化 通过舱单支撑的护栏。模拟运行、明确确认、每次操作验证、完整审计跟踪、即时撤销。

建筑.md 了解完整的设计、安全模型和路线图。

______________________________________________________________________

运行它的两种方法

连接模式(推荐)

将MCP服务器与OAuth+开发人员令牌连接,代理会自动提取实时数据——搜索词、关键字、转换、预算,一切都通过GAQL。

您将获得:实时帐户数据、自动帐户发现、稀疏帐户的日期范围回退、针对目标关键字的交叉引用搜索词以及开箱即用的健康检测。

设置: ./install.sh auto/google-ads connect setup → 你活着。看 data/mcp-config.md 了解详情。如果您的主持人使用非默认技能路径,请用以下内容覆盖它 CLAUDE_TARGET=...OPENCLAW_TARGET=....

导出模式(零点设置)

从谷歌广告中粘贴CSV。分析引擎是一样的——你只需手动输入即可。适用于您还没有API访问权限的一次性审核或帐户。

这两种模式产生的分析和草稿质量相同。

______________________________________________________________________

它能做什么

三层共15项技能。完整的操作员工作流程在 操作员手册.md.

运行帐户

命令发生了什么
/google-ads connect设置、健康检查、选择帐户
/google-ads daily今天重要的是——流血的竞选、浪费、机会
/google-ads audit对所有层面进行全面的战略审查
/google-ads draft-summary查看排队的内容、优先级以及映射的依赖关系

分析

命令发生了什么
/google-ads search-terms查找浪费、信号、消息线索、路由问题。对于PMax繁重的帐户,当经典搜索词行不可用时,会回退到查询行可见性模式
/google-ads intent-map构建账户的持久意图模型
/google-ads negatives带有范围、风险和抵押品注释的具体负面信息
/google-ads tracking该帐户是否足够值得信赖以进行优化?
/google-ads structure活动/广告组重组建议
/google-ads rsasRSA指示来自实际买家语言
/google-ads budget基于信号质量的预算/缩放决策
/google-ads plan从头开始规划或重建帐户架构
/google-ads pmax通过意图污染透镜进行PMax分析
/google-ads landing-review登录页面诊断——跟踪、用户体验与两者

法案

命令发生了什么
/google-ads apply [draft]执行批准的草案——试运行、确认、验证、记录
/google-ads undo [rev-id]立即反转任何应用的操作
/google-ads apply log对所有应用内容的完整审计跟踪

______________________________________________________________________

为什么存在

大多数谷歌广告工具都会报告指标、执行通用最佳实践或自动出价。他们谁也没想过这个账户是什么 *实际购买*.

Google Ads Copilot从搜索意图开始——人们键入了什么,他们的意思是什么,以及帐户结构是否反映了这一现实。

这意味着什么
意图优先读取搜索行为,而不仅仅是指标
记忆跨课程复合学习——永远不要从头开始
以决策为导向每个输出都以“做什么”结尾,而不是“发生了什么”
起草阶段您可以阅读、批准或拒绝的具体提案
循环中的人类没有您的明确确认,任何事情都不会改变
安全写入最小爆炸半径优先,完整审计跟踪,即时撤销
适用于任何地方实时API或手动导出-相同的引擎

______________________________________________________________________

入门指南

5分钟内试用(导出模式)

  1. ./install.sh auto
  2. 从Google Ads导出搜索词(过去30天,CSV)
  3. /google-ads search-terms → 粘贴你的数据
  4. 检查 workspace/ads/drafts/ 因为它发现了什么

完整设置(连接模式)

  1. 配置MCP服务器: data/mcp-config.md
  2. ./install.sh auto
  3. 从提交的模板创建本地凭据/env文件:

cp data/google-ads-adc-authorized-user.template.json data/google-ads-adc-authorized-user.json cp data/google-ads-mcp.test.env.example.sh data/google-ads-mcp.test.env.sh

  1. 填写你的真实价值观,然后 source data/google-ads-mcp.test.env.sh
  2. ./scripts/test-mcp.sh 验证连接
  3. /google-ads connect setup → 发现您的帐户,选择一个,编写工作区
  4. /google-ads daily/google-ads audit → 实时数据流自动
  5. 对于PMax繁重的帐户,请使用 ./scripts/test-search-terms.sh 验证查询可见性和回退行为
  6. 审阅草稿→ 批准→ 应用→ 验证

该仓库不提供任何真实的凭据或实时测试文件。仅提交模板。

从发布捆绑包安装

您可以像往常一样从仓库安装,也可以从打包的捆绑包安装:

./install.sh auto
./install.sh /path/to/google-ads-copilot-0.2.0.tar.gz auto
./install.sh /path/to/google-ads-copilot-0.2.0 openclaw

发布包由以下组件构建 ./scripts/package/build-release.sh .

演示工作流.md 了解整个周期的指导性演练。

环境变量:

变量必填备注
GOOGLE_APPLICATION_CREDENTIALSOAuth/ADC凭据JSON路径
GOOGLE_CLOUD_PROJECT谷歌云项目ID
GOOGLE_ADS_DEVELOPER_TOKEN谷歌广告开发者令牌
GOOGLE_ADS_LOGIN_CUSTOMER_ID如果MCC经理帐户ID(无破折号)

______________________________________________________________________

工作空间内存

每节课都很复杂。代理人写信给 workspace/ads/ --在运行之间生存的持久知识库:

文件目的
account.md帐户配置文件和设置
goals.md业务目标和关键绩效指标
intent-map.md持久的搜索行为模型
queries.md查询模式和集群
negatives.md排除历史
winners.md什么有效,为什么有效
tests.md主动测试和假设
findings.md分析说明
change-log.md什么时候发生了变化
learnings.md这个账户教会了我们什么
drafts/分阶段行动建议
audit-trail/应用会话日志+反向注册表

使用草稿文件名 YYYY-MM-DD-[account-slug]-[type].md多草案审计也会产生 _batch-YYYY-MM-DD-[account-slug].md 作为一个持久的审计数据包,同时 _summary.md 仍然是实时优先级积压快照。

______________________________________________________________________

包结构

google-ads-copilot/
├── README.md                    # This file
├── ARCHITECTURE.md              # Three-layer design doc
├── APPLY-LAYER.md               # Apply layer design (safety, reversibility, audit)
├── OPERATOR-PLAYBOOK.md         # Full operator workflow loop
├── CHANGELOG.md                 # Release history
├── LICENSE
├── install.sh
│
├── google-ads/                  # Orchestrator skill
│   ├── SKILL.md
│   └── references/              # Strategic playbooks
│
├── scripts/                     # Helper scripts + apply layer CLI
│   ├── apply-layer/             # Write-path CLI (bash + curl + jq)
│   └── list-customers.sh        # Account discovery
│
├── skills/                      # Analytical skills (15 skills)
│   ├── google-ads-apply/
│   ├── google-ads-audit/
│   ├── google-ads-budget/
│   ├── google-ads-connect/
│   ├── google-ads-daily/
│   ├── google-ads-draft-summary/
│   ├── google-ads-intent-map/
│   ├── google-ads-landing-review/
│   ├── google-ads-negatives/
│   ├── google-ads-plan/
│   ├── google-ads-pmax/
│   ├── google-ads-rsas/
│   ├── google-ads-search-terms/
│   ├── google-ads-structure/
│   └── google-ads-tracking/
│
├── data/                        # Data layer (MCP config, GAQL recipes)
├── drafts/                      # Draft templates per action type
├── examples/                    # Sanitized example outputs
├── evals/                       # Eval suite
└── workspace-template/          # Blank workspace for new accounts

______________________________________________________________________

适用范围

行动状态风险撤销
添加活动级别的负面关键字✅ LiveLow删除负片
添加广告组级别的负面关键字✅ 就绪删除负极
暂停关键字✅ 就绪重新启用关键字
暂停广告组✅ 就绪中等重新启用广告组
设置活动每日预算✅ 实时(清单支持)中等恢复之前的状态 amount_micros

预算仅适用于活动日常预算,需要 ## Apply Manifest JSON块加硬护栏:每个动作最多30%,最小有意义增量,7天冷却,跟踪置信度门,待定跟踪草稿块,预算中性默认值,以及 confirm budgets 确认。

仍被排除在外: 共享预算、投标策略更改、活动创建、RSA编辑、启用暂停实体、删除。

______________________________________________________________________

接下来是什么

这是一个公开的alpha。分析引擎和应用层是可靠的——在真实货币的真实账户上进行了测试。当前下一步:

  • 预算申请后扩大写作行动
  • 更多来自真实(匿名)帐户的示例演练
  • 更广泛的决策质量和写路径回归评估覆盖范围
  • 包装和发布自动化,以实现更广泛的分销

如果你为客户或自己的企业运行谷歌广告,试试看。打破它。告诉我缺少了什么。

______________________________________________________________________

许可证

许可证.

目录标签

目录标签

ShellAI代理开发工具本地部署广告优化意图分析GoogleAds自动化工具

接入字段

传输方式(transport,传输协议)

未说明

鉴权方式(authType,认证方式)

oauth

工具数量(toolCount,工具数)

17

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

未说明oauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

仍需确认:installCommand

来源信息

继续浏览同类 MCP