google-ads-open-cli
为AI智能体提供Google Ads数据查询与管理的CLI工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:google-ads-open-cli。 它的用途是:为AI智能体提供Google Ads数据查询与管理的CLI工具 完整的 Skill 内容见:https://321skill.com/skills/google-ads-open-cli/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下最近一周所有活跃广告系列的表现数据。”,AI会调用`google-ads-open-cli get-campaign-stats --date-range=LAST_7_DAYS`命令,获取并整理出包含花费、点击、转化等指标的简明报告。或者
对AI说:“检查账户1234567890下的转化跟踪设置是否有问题。”,AI会运行相应的审计命令并列出可能配置异常的转化动作。
介绍
google-ads-open-cli 是一个专为AI智能体(如OpenClaw、Claude Code)设计的命令行工具,它封装了Google Ads API的核心功能,允许通过自然语言指令直接查询和管理Google Ads账户数据。
它解决了营销人员和开发者需要频繁登录Google Ads界面或编写复杂API代码来获取广告表现数据、分析账户结构的问题。通过简单的shell命令,AI助手可以代替用户执行如运行GAQL查询、拉取关键词统计、审计转化跟踪、浏览MCC账户层级等操作,极大提升了数据分析与监控的效率。
该工具特别适合需要将Google Ads数据集成到自动化工作流中的营销专员、数据分析师和全栈开发者。无论是生成每日营销报告、监控广告支出、还是进行竞品广告策略分析,都可以通过AI助手调用此CLI快速完成。
使用前需在Google Ads API中心和Google Cloud Console完成开发者令牌和OAuth2客户端凭证的配置。请注意,此工具提供的是只读权限,适合数据查询与分析,不适合进行广告投放或修改等写操作。对于通过MCC账户访问子账户的场景,需要正确配置login_customer_id。
核心特点
这是首个明确为AI智能体(如Claude Code、Cursor)原生设计的Google Ads CLI工具,通过`npx skills add`命令可直接将技能注入AI工作区,让AI能像调用内置命令一样操作广告数据。与通用API库相比,它提供了开箱即用的高层命令(如`list-campaigns`、`query-gaql`),无需AI自行构建请求体。
注意事项
此工具仅提供对Google Ads API的只读访问权限,不支持创建或修改广告系列、预算等写操作。
常见问题
这个工具需要Google Ads账户吗?
需要。您需要一个Google Ads账户(通常是经理账户/MCC)来获取开发者令牌,并且用于OAuth2授权的Google账号需要有目标广告账户的访问权限。
AI智能体如何调用这个工具?
AI智能体(如OpenClaw)可以直接在终端运行安装命令,之后即可在对话中让AI执行如`google-ads-open-cli list-campaigns --status=ENABLED`这样的命令来获取数据。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/google-ads-open-cli/raw/index.md 读取 google-ads-open-cli 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/google-ads-open-cli/raw/index.md(查看排版版本)