Chanlinnn/google-ads-agent-skills / skills/setup-google-ads
setup-google-ads
Verified配置和排查 Google Ads API 到 AI Agent 的本地只读 MCP 接入。用于新电脑部署、Google Cloud 与 Ads 权限区分、服务账号或 ADC 配置、Codex MCP 注册、可访问账户验证,以及认证、网络、版本和权限错误排查。Set up or troubleshoot a local read-only Google Ads MCP connection. 不负责广告表现分析或广告修改。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.3 KB |
| agents/openai.yaml | config | 263 B |
| assets/codex.example.toml | config | 452 B |
| assets/local.example.json | config | 154 B |
| assets/requirements.txt | manifest | 1.8 KB |
| assets/tools-readonly.json | config | 357 B |
| references/compatibility.md | markdown | 3.0 KB |
| references/setup.md | markdown | 5.6 KB |
| references/troubleshooting.md | markdown | 2.3 KB |
| scripts/manage.py | script | 8.7 KB |
references/compatibility.md
View on GitHub# 版本、旧版接入与能力边界
文档核对日期:2026-11-16。依赖升级前重新检查官方文档和实际安装源码,不把今天的版本写成永久规则。
## 本包基线
- 官方仓库:<https://github.com/googleads/google-ads-mcp>
- 固定提交:`cda852701fb5787dc4d79281f37da795ac09b97d`
- 包版本:`google-ads-mcp 0.0.6`
- 本次隔离环境:Python 3.12;`google-ads 35.1.0`、`fastmcp 4.2.0`、`mcp 2.3.0`
- 完整依赖固定在 [requirements.txt](../assets/requirements.txt)。依赖升级后重新执行离线工具清单验收和用户自己的最小只读查询。
上游源码通过版本化 URL 安装,未随本仓库分发。依赖包数量较多,首次安装需要网络。固定版本提供可检查的基线,不意味着未来无需维护或所有系统均已验证。
## Developer Token 的历史差异
Google 当前迁移文档说明,API 访问管理已在 2026-09-09 转移到 Cloud 项目;新接入使用 Cloud 概览中的访问级别流程,更新后的 MCP / 客户端不再要求 Developer Token。[官方迁移说明](https://developers.google.com/google-ads/api/docs/api-policy/developer-token)
旧客户端、旧启动器或旧示例可能仍在本地强制检查该变量。出现 “missing developer token” 不能只靠删除变量解决:先分辨错误由本地库还是远端 API 返回,核对实际依赖,在隔离环境迁移验证。保留原连接和凭据,待新连接验证通过再按凭据生命周期处理。
本包使用已更新的客户端,启动时不继承旧 `GOOGLE_ADS_DEVELOPER_TOKEN`。这不是要求用户删除已有 Token,也不是对 App Conversion Tracking API 等独立产品作出相同判断。
## Read only、Standard 和 API 级别不是同一概念
Ads 中的 Read only / Standard 是账户角色;Cloud 项目的 API 访问级别决定访问范围、配额和允许用途。MCP 实际实现并启用的工具又是另一层。提高 API 级别不会自动赋予广告编辑角色,赋予编辑角色也不会自动产生缺失的 MCP 工具。
本包只启用查询。官方 MCP 此版本还包含素材创建、视频上传和标签管理,但它们不等于完整 Campaign 创建或自动托管,本包均关闭。[官方 MCP 能力](https://developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server)
## 独立编辑能力与后续扩展
Google Ads API 的创建/修改能力需按广告类型和字段验证。扩展应有独立执行工具,明确目标账户、变更内容、预算范围和用户授权;执行前使用支持的 `validate_only` 校验,并设计幂等、变更前后记录、异常停止和恢复方案。校验通过不代表已写入,也不保证之后的提交一定成功。
这些要求中,`manage-google-ads` 的独立执行器已实现单项启停、非共享日预算修改、计划摘要、校验、状态核对与执行回执;不通过本 Skill 的只读 MCP 写入。其余广告创建和托管能力仍为扩展方向,不能宣称已实现。查看该 Skill 随附流程和本仓库验证记录。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |