SuperAPI AI 工具集

google-ads-mcp

智能体与模型

查看项目

更新于 10-16 06:19

技能介绍

用途:将 Google Ads 账户接入支持 MCP 的客户端,实现实时读写操作。

主要能力:提供 29 个工具。读取类 9 个,包括列出可访问客户、账户、执行 GAQL、广告系列/关键词/广告/搜索词效果、预算汇总与关键词建议;审计类 7 个,包括竞价洞察、变更历史、设备/地域表现、推荐、Performance Max 与展示份额;写入类 11 个,包括预算、广告系列/广告组状态、关键词出价、增删关键词与否定词、创建广告系列与广告组、切换出价策略及原始 mutate,写入默认 dry-run,需传 confirm=True 执行;文档类 2 个,提供 GAQL 参考与工作流指南。

使用方式:运行 pip install git+https://github.com/itallstartedwithaidea/google-ads-mcp.git 安装;通过环境变量或 .env 配置 GOOGLE_ADS_DEVELOPER_TOKEN、GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_REFRESH_TOKEN、GOOGLE_ADS_LOGIN_CUSTOMER_ID,或用 GOOGLE_ADS_CREDENTIALS 指向 google-ads.yaml;运行 python -m ads_mcp.server;在项目根放 .mcp.json 可被 Claude Code 自动发现,Claude Desktop 则写入 claude_desktop_config.json。

适用场景:账户审计、绩效分析、关键词与搜索词研究、预算与出价调整等。

限制:需自行申请开发者令牌与 OAuth 凭据;基础访问约 15K 次操作/天,需用 LIMIT 与过滤;常见错误包括凭据过期、权限不足、令牌未批准与限流。具体收费与平台兼容细节暂未提供。