内容
# Google 广告代理 — Buddy
> 最全面的 Google 广告 + 广告自动化插件，适用于 Claude Code。
> 由 [**Ahmeego**](https://www.ahmeego.com) · [`itallstartedwithaidea`](https://github.com/itallstartedwithaidea) · 驱动 **Buddy**
[](https://pypi.org/project/googleadsagent-mcp/)
[](https://www.npmjs.com/package/@googleadsagent/ad-creative-mcp)
[](https://code.claude.com/docs/en/plugin-marketplaces)
[](LICENSE)
---
## 您将获得
- **Buddy** — 旗舰 Opus 驱动的 Google 广告企业代理，拥有实时 API 访问权限
- **6 个专业子代理**（Simba、Nemo、Elsa、Aladdin、Moana、Baymax），涵盖报告、研究、优化、购物/PMax、创意和创意创新
- **2 个 MCP 服务器** — `googleadsagent-mcp`（Google 广告 API）和 `@googleadsagent/ad-creative-mcp`（Cloudinary 支持的创意验证）
- **约 77 个生产技能**，涵盖 Google 广告、AI 代理工程、Claude 神话、软件开发、安全、基础设施、生产力、网页前端、科学研究和媒体创意
- **7 个斜杠命令** — `/analyze`、`/audit`、`/optimize`、`/status`、`/login`、`/logout`、`/switch`
- **安全钩子** — `PreToolUse` GAQL 验证，防止在只读上下文中执行写入操作，`PostToolUse` 审计日志
- **后台异常监视器** — 实时显示 CPA 峰值、CTR 下降和零转换支出
- **Buddy 作为默认代理** — `settings.json` 在插件加载时立即激活 Buddy
> 由一位拥有超过 3.5 億美元 Google、Meta、Microsoft 和 Amazon 广告支出经验的从业者构建。
> 参考架构是 [`ahmeego.com`](https://www.ahmeego.com) 背后的生产系统。
---
## 安装（一条命令）
一旦插件在 Anthropic 社区市场获得批准：
```shell
/plugin marketplace add anthropics/claude-plugins-community
/plugin install googleadsagent@claude-community
```
### 自托管安装（立即可用）
```shell
/plugin marketplace add itallstartedwithaidea/claude-googleadsagent
/plugin install googleadsagent@claude-googleadsagent
```
### 本地开发安装
```bash
git clone https://github.com/itallstartedwithaidea/claude-googleadsagent
claude --plugin-dir ./claude-googleadsagent
```
---
## 身份验证
Google 广告 MCP 服务器需要 OAuth 凭证。复制 `.env.example` 到 `.env` 并填写：
| 变量 | 获取位置 |
|---|---|
| `GOOGLE_ADS_DEVELOPER_TOKEN` | [Google 广告 → 工具 → API 中心](https://ads.google.com/aw/apicenter) |
| `GOOGLE_ADS_CLIENT_ID` | [Google Cloud Console → OAuth 2.0 客户端 ID](https://console.cloud.google.com/apis/credentials) |
| `GOOGLE_ADS_CLIENT_SECRET` | 上述相同 |
| `GOOGLE_ADS_REFRESH_TOKEN` | 运行 `claude-googleadsagent oauth`（参见 wiki） |
| `GOOGLE_ADS_LOGIN_CUSTOMER_ID` | 您的 MCC 账户 ID（无破折号） |
完整演练：[Wiki → 身份验证](https://github.com/itallstartedwithaidea/claude-googleadsagent/wiki/Authentication)
或使用 Ahmeego 托管的 OAuth 流：[ahmeego.com/docs/google-ads-auth](https://www.ahmeego.com/docs/google-ads-auth)
---
## 快速入门
在安装插件后，在 Claude Code 中：
```shell
# 直接与 Buddy 交谈
> 嘿 Buddy，审核我的 Google 广告账户 1234567890，过去 30 天
# 运行斜杠命令
/googleadsagent:audit 我的 MCC，过去 30 天，关注 PMax 广告活动
# 显式调用子代理
> @simba 为花费 >$50 且无转换的广告活动拉取搜索词浪费报告
> @aladdin 哪些购物产品组受预算限制？
> @baymax 调整所有标准 IAB 尺寸的这些展示创意
# 使用特定技能
/googleadsagent:keyword-research 扩展我的“个人伤害律师”关键词列表，并包含高意图变体
```
---
## 包装内容
### 代理（7）
| 代理 | 角色 |
|---|---|
| **Buddy** | 旗舰 Google 广告策略师 — 统筹一切 |
| **Simba** | 报告和分析 |
| **Nemo** | 研究和竞争情报 |
| **Elsa** | 批量优化和写入操作 |
| **Aladdin** | 购物和性能最大化 |
| **Moana** | 视觉广告创意（RDA，需求生成） |
| **Baymax** | 创意调整和格式转换 |
### MCP 服务器（2）
| 服务器 | 源 | 权力 |
|---|---|---|
| `google-ads` | [`googleadsagent-mcp`](https://pypi.org/project/googleadsagent-mcp/) （PyPI） | 实时 Google 广告 API — 读取、分析、创建、修改 |
| `ad-creative` | 捆绑在 `servers/ad-creative-mcp/server.mjs` 中（455KB，依赖内联） — 也发布为 [`@googleadsagent/ad-creative-mcp`](https://www.npmjs.com/package/@googleadsagent/ad-creative-mcp) 在 npm 上 | Cloudinary 支持的创意验证、调整、优化 |
### 技能类别（77 技能）
- **Google 广告（16）** — 审核、分析、写入、数学、mcp、关键词研究、广告文案生成、预算优化、pmax 优化、购物广告、受众目标定位、转化跟踪、质量评分优化、再营销策略、竞争对手分析、着陆页审核
- **AI 代理工程（10）** — 知识库注入、实体内存管理、多模型路由、主动智能、mcp 服务器创建、并行代理编排、内存持久性、持续学习、令牌优化、长视距工作流
- **Claude 神话（10）** — 提示架构、上下文工程、Anthropic 工具掌握、认知脚手架、验证循环、自愈代理、 adversarial 抗性、代理本能系统、会话考古学、多套件可移植性
- **软件开发（8）** — 代码审查、测试驱动开发、系统调试、git 工作树、集思广益、子代理驱动开发、编写计划、执行计划
- **安全（4）** — 代理安全扫描、codeql-semgrep、sandbox 硬化、机密保护
- **基础设施（6）** — cloudflare 工作人员、ci-cd 管道、边缘渲染、 observability、服务发现、配置管理
- **生产力（6）** — 工作流编排、批处理、知识库-rag、ai-chat-studio、低代码生成、助手预设
- **网页前端（6）** — react 最佳实践、react-native 指南、视图转换、边缘部署、组合模式、网页设计指南
- **科学研究（8）** — 数据分析、机器学习、生物信息学、化学信息学、地理空间分析、研究方法论、科学写作、数据库查找
- **媒体创意（3）** — 网页资产生成、程序化视频、ml 模型集成
### 斜杠命令（7）
`/analyze` · `/audit` · `/optimize` · `/status` · `/login` · `/logout` · `/switch`
### 钩子（2）
- **`PreToolUse`** → 在执行前验证 GAQL 查询，以阻止只读上下文中的意外写入
- **`PostToolUse`** → 将每个 Google 广告工具调用记录到审计跟踪中
### 后台监视器（1）
- **`google-ads-anomaly-watch`** → 每 15 分钟轮询一次 CPA 峰值 >20%、CTR 下降 >15%、零转换支出、预算限制的广告活动、未批准的广告
---
## 路线图
- v1.1 — 来自 [MiniAgent](https://github.com/itallstartedwithaidea/MiniAgent) 的 14 个其他平台 MCP（Meta、Microsoft、Amazon、LinkedIn、TikTok、Snap、Pinterest、Reddit、X、Spotify、TradeDesk、Criteo、AdRoll）
- v1.2 — 写作代理 / Ghost Writer 技能（18 个平台格式化器，AI 检测验证）
- v1.3 — ContextOS 认知原语作为内置技能
- v2.0 — LSP 服务器，用于 GAQL 文件、实时广告活动健康仪表盘
---
## 链接
- **插件源** — [github.com/itallstartedwithaidea/claude-googleadsagent](https://github.com/itallstartedwithaidea/claude-googleadsagent)
- **Wiki + 文档** — [github.com/itallstartedwithaidea/claude-googleadsagent/wiki](https://github.com/itallstartedwithaidea/claude-googleadsagent/wiki)
- **主页** — [ahmeego.com](https://www.ahmeego.com)
- **托管工具** — [ahmeego.com](https://www.ahmeego.com/tools) — Buddy AI 代理、审计员、广告活动构建器、关键词分析器
- **作者** — [@itallstartedwithaidea](https://github.com/itallstartedwithaidea) · [LinkedIn](https://www.linkedin.com/in/johnmichaelwilliams) · [Substack](https://itallstartedwithaidea.substack.com)
---
## 许可证
专有 — © 2026 John Williams / Ahmeego。保留所有权利。
参见 [LICENSE](LICENSE)。对于超出运行时授予的商业使用，请联系 `john@itallstartedwithaidea.com`。
---
<sub>Buddy 是 Ahmeego 的注册名称。Claude Code、Anthropic 和 Anthropic 徽标是 Anthropic, PBC 的商标。Google 广告、Performance Max 和相关标志是 Google LLC 的商标。本插件并非由 Anthropic 或 Google 官方认可。</sub>
