最后更新:2026-11-16(Google Ads API、Anthropic、OpenAI 官方文档均于当天查阅;当前 API 版本 v26.2)
Google Ads 的报表能力都建立在 GAQL(Google Ads Query Language)上:用类 SQL 的语法查询资源、指标、细分维度(GAQL 官方文档)。问题是投手大多不会写 GAQL。现在有了 Google 开源的 Google Ads MCP 服务器,Claude 可以直接替你拼 GAQL、执行、解释结果——这是整个 Google 自动化里最安全、收益最快的一段,因为它只读。
Claude 查数用到的 3 个 MCP 工具
customers_list_accessible_customers:列出当前凭据能直接访问的客户 ID。search_search:根据结构化参数(customer_id、resource、fields、conditions、orderings、limit)构造并执行 GAQL SearchStream 查询。metadata_get_resource_metadata:返回某资源可选、可筛选、可排序的 GAQL 字段,避免写出无效查询。
此外服务器还挂载了 4 个只读参考资源(discovery-document、metrics、segments、release-notes),不受工具开关影响(官方指南)。
5 类最常问的报表问题
| 你问 Claude 的问题 | Claude 生成的 GAQL 要点 | 看什么 |
|---|---|---|
| 昨天哪些系列花费异常? | FROM campaign,segments.date DURING YESTERDAY,cost_micros | 与 7 天均值偏差 |
| 预算为什么花不满? | metrics.search_budget_lost_impression_share、search_rank_lost_impression_share | 预算损失 vs 排名损失 |
| 哪些搜索词在白花钱? | FROM search_term_view,conversions = 0,cost_micros 阈值 | 加否定词候选 |
| 哪个广告组 CTR 掉了? | FROM ad_group,segments.date DURING LAST_14_DAYS + segments.week | 周环比 |
| 某字段能不能和某资源一起查? | metadata_get_resource_metadata | 可选、可筛、可排序字段 |

一个实用技巧:让 Claude 先调 metadata 工具确认字段兼容性,再查数。这样能少踩「字段不能和该资源一起选」这类错误。如果想手写验证,Google 也提供交互式查询构建器。
GAQL 示例:零转化但有花费的搜索词
-- GAQL: search terms with spend but no conversions in the last 30 days
SELECT search_term_view.search_term, campaign.name, ad_group.name,
metrics.cost_micros, metrics.clicks, metrics.conversions
FROM search_term_view
WHERE segments.date DURING LAST_30_DAYS
AND metrics.conversions = 0
AND metrics.cost_micros > 20000000
ORDER BY metrics.cost_micros DESC
LIMIT 200注意 Google Ads API 的金额字段都是 micros(1 个币种单位 = 1,000,000),上面的 20000000 就是 20 个帐户币种单位。让 Claude 在报表里自动除以 1,000,000 再展示。
异常诊断:信号 → 原因 → 下一步
| 异常信号 | 可能原因 | Claude 的下一步查询 | 人工决策 |
|---|---|---|---|
| 花费骤降 | 预算受限、审核拒登、出价策略学习 | 查系列状态与政策摘要字段 | 是否加预算/改素材 |
| CPC 飙升 | 竞争加剧、质量下降、匹配放宽 | 按关键词查平均 CPC 与质量相关字段 | 是否调出价上限 |
| 转化归零 | 追踪断了、落地页故障 | 按转化动作查最近转化时间 | 先排查追踪 |
| 展示份额低 | 预算损失或排名损失 | 两列损失份额分开看 | 加预算还是优化排名 |
| 搜索词漂移 | AI Max/广泛匹配扩量 | search_term_view + 匹配类型 | 加否定词 |

「预算花不满」是出海团队最常问的问题之一。展示份额三列(预算损失、排名损失、搜索量过低)的判读方法见 谷歌搜索广告预算花不满:展示份额三列诊断;Claude 可以按同样逻辑自动跑一遍并给出结论。AI Max 带来的搜索词变化,可配合 AI Max 流量怎么识别:{search_term_matchtype} 一起看。
把它变成每天的只读摘要
第一步,在服务器端开启只读模式,让写入工具根本不注册:
# tools_config.yaml - strictly read-only deployment
# (point GOOGLE_ADS_MCP_TOOLS_CONFIG at this file)
namespaces:
customers: true
search: true
metadata: true
labels: false
assets: false第二步,用 claude -p 无交互运行,并通过 --allowedTools 只放行查询工具(headless 模式):
# read-only morning summary with Claude Code in headless mode
claude -p "Use google-ads to pull yesterday's cost, clicks, conversions and \
search impression share by campaign for customer 1234567890. Compare with the \
7-day average, flag anomalies. Do not change anything." \
--allowedTools "mcp__google-ads__search_search,mcp__google-ads__metadata_get_resource_metadata" \
--output-format json > summary.json需要更稳定的结构化输出或接入 BI,可以改用 google-ads Python 库的 search_stream 直接导出 CSV,由 Codex 写脚本、Claude 只做解读,见 用 Codex 写 Google Ads 日报与搜索词脚本。
配额与数据口径
- 每次查询都消耗 API 操作配额;Explorer 级别对生产帐户每天 2,880 次(
- 配额说明
- )。把多帐户日报合并成少量查询更省。
- 当日数据会有延迟,日报建议查 YESTERDAY。
- 报表口径以 Google Ads 后台为准;让 Claude 在摘要里注明查询的日期范围和过滤条件。
熊猫出海如何用 Claude、Codex 和 Google 广告帐户帮客户提升投放效率
这篇讲的是 Claude,但在实际服务中,熊猫出海会把 Claude、Codex 和 Google Ads 帐户组合起来,帮出海企业更快跑完「开户与转化追踪 → 搭系列 → 写素材 → 看报表与搜索词 → 调预算与否定词」这一整套重复工作,让投手把时间花在策略、出价判断和素材上。
- 广告帐户:使用企业自己的 Google Ads 帐户,或通过熊猫出海开户服务合规开通的帐户;帐户归企业所有,不出租、不共享。需要多帐户管理时,用企业自己的经理帐户(MCC)授权。
- Claude:通过 Google 开源的 Google Ads MCP 服务器用自然语言查数(GAQL)、诊断展示份额和搜索词、写 RSA 标题描述与附加信息初稿,在「先提议、后确认」模式下创建素材和标签。
- Codex:写和维护 google-ads Python 脚本(日报、搜索词清洗、批量建暂停系列、validate_only 预检),在沙盒里运行并接入定时任务或 CI。
- 人工把关:启用系列、提预算、改出价目标都由投手审核后执行;Google Ads 政策与落地页合规由人工最终确认。
这是一项服务能力说明,不涉及任何价格或返点承诺;我们也不是 Google、Anthropic 或 OpenAI 的官方合作伙伴。开户与代投放流程请看 Google 广告开户与投放(熊猫出海服务页)。
常见问题
Claude 写的 GAQL 会不会出错?
会,尤其是字段兼容性。让它先调用 metadata 工具确认字段,再执行查询;结果异常时让它把 GAQL 原文贴出来供人检查。
只读模式下 Claude 还能改东西吗?
在 tools_config.yaml 里关闭 labels 和 assets 命名空间后,写入工具不会注册,Claude 无法调用。
需要 MCC 吗?
不是必须。通过经理帐户访问客户帐户时,设置 GOOGLE_ADS_LOGIN_CUSTOMER_ID 或每次调用传 login_customer_id 即可。
能查多个帐户吗?
可以,先用 customers_list_accessible_customers 列出帐户,再逐个查询;注意配额。
合规说明:本文所有自动化都应只用于企业自有或已获正式授权的 Google Ads 帐户(含经理帐户 MCC 下的客户帐户),通过 Google 官方 Google Ads API、Google 开源的 Google Ads MCP 服务器或 Google Ads 编辑器等官方工具接入,遵守《Google Ads API 条款》、API 配额与《Google Ads 政策》,并在任何会产生花费的动作前保留人工审核。熊猫出海不出售、出租、共享或转让广告帐户、MCC 或 API 凭据,不协助规避广告审核、地区限制、身份验证或付款管控,也不是 Google、Anthropic 或 OpenAI 的官方合作伙伴。Claude 与 OpenAI 服务仅向其支持国家/地区的客户提供,中国大陆与香港不在列表中,请由在支持地区合法设立并真实经营的主体开通并负责。
相关阅读
- Google 广告开户与投放(熊猫出海服务页)
- 海外 AI Token 服务:帐号开通 + API 接入(熊猫出海)
- Claude 操作 Google 广告投放全流程自动化
- 如何将 Claude 链接到 Google 广告(Google Ads MCP 教程)
- 用 Codex 写 Google Ads 日报与搜索词脚本
- Google 开发了 MCP:让 AI 直接操作你的广告投放
- Claude Facebook ads reporting(Facebook 篇,英文)
- 谷歌搜索广告预算花不满:展示份额三列诊断
- AI Max 流量怎么识别:{search_term_matchtype}
- Google Ads 智能出价学习期最长 7 天
联系熊猫出海:Google 广告开户 + AI 自动化投放
告诉我们公司主体所在地、行业、目标国家、落地页链接和预计月预算,以及你想先自动化哪一段(报表、搜索词、素材还是建系列)。我们先做资质与落地页预审,再协助企业合规开通自有 Google Ads 帐户,并把 Claude / Codex 接入到你的投放流程。
WhatsApp:+852 5904 8602Telegram:@PANDA0134微信:szcwh99

官方来源
- Google: Google Ads Query Language (GAQL)
- Google: Google Ads MCP server – developer integration guide
- GitHub: googleads/google-ads-mcp
- Google: API limits and quotas
- Anthropic: Run Claude Code programmatically (claude -p)
- Anthropic: Claude Code permissions
- Google: Python client library (google-ads)
以上官方页面均于 2026-11-16 查阅。API 版本、工具名称与权限要求会变化,请以官方页面为准。

微信扫一扫打赏
支付宝扫一扫打赏
