Skip to content

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. 不负责广告表现分析或广告修改。

references/troubleshooting.md

View on GitHub
# 按失败层排查

先记录错误类型、操作类别、版本和失败阶段;不要复制完整请求、凭据、账户 ID 或原始日志到公开 Issue。

| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 本地代理连接被拒 / 超时 | 实际 HTTP 代理是否运行、地址是否改变 | 核对本机网络设置;区分网络失败与 API 审批 |
| 工具完全不可见 | MCP 注册路径、Python、依赖、STDIO 输出 | 运行本地 `check`,检查可见工具列表;不要把调试输出写入协议 stdout |
| 凭据/作用域失败 | ADC 类型、文件权限、OAuth adwords scope | 按组织流程重新授权;不把普通 gcloud 登录当成 ADC |
| `USER_PERMISSION_DENIED` | 服务账号是否加入 Ads;经理/客户路径是否正确 | 分别核对直接授权、经理权限、目标客户层级 |
| Cloud 项目未批准生产访问 | 凭据所属项目及其当前 API 访问级别 | 在 Cloud 概览核实;本地安装成功不能代替批准 |
| 本地提示 Developer Token 缺失 | 旧启动器或客户端强制校验 | 阅读兼容性说明,隔离升级验证,不直接删凭据 |
| 仅列出经理账户 | 直接访问列表的定义 | 使用 `customer_client` 检查下属账户,而非重新授予所有客户权限 |
| 字段/segment 不兼容 | 当前 API 版本及字段元数据 | 缩减到最小查询,再逐项添加;不要重复同一失败查询 |
| 429 / 配额 / 宿主拒绝 | 错误来自 Google、MCP、网络还是宿主策略 | 普通限流可有界退避并降低并发;真实授权拒绝应遵守策略,不改接口绕过 |
| 查询成功但空结果 | 日期、账户、资源、过滤条件、数据可用性 | 与最小总量查询核对,不能把空列表直接解释成“无花费” |
| 回答或结果被截断 | GAQL LIMIT、工具返回上限、对话截断 | 缩小查询并按不重叠维度拆分,核对控制总量,标注未覆盖范围 |

本地启动器支持 macOS / Linux 的私人文件权限。权限过宽会停止并要求限制为 0600;它不会自动放宽系统权限。组织禁止下载服务账号密钥时,使用组织批准的 OAuth 或无密钥方案,不绕过策略。

公开求助只给最小模拟复现;私人排查仍应避免将完整身份和数据反复写入报告。
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall