SuperAPI AI 工具集

google-ads

智能体与模型

查看项目

更新于 10-15 22:15

技能介绍

用途:本技能用于通过 Hyper MCP 规划并创建新的 Google Ads 广告系列,以及对现有账户做报告与分析。适用于启动搜索、展示、Performance Max、视频、Demand Gen、购物、应用等类型广告系列,也用于账户健康、转化跟踪诊断、搜索词浪费等报表。

前置要求:需安装并连接 Hyper MCP(https://app.hyperfx.ai/mcp),并在 https://app.hyperfx.ai/apps 连接 Google Ads 集成。若 search("google_ads_accounts_list") 找不到该工具,应停止并提示用户启用 Hyper MCP 并连接 Google Ads。

主要能力:读取统一用 GAQL(google_ads_gaql_query 覆盖所有资源);写入按资源操作命名 google_ads_<resource>_<create|update|remove>,create/update 接收 (customer_id, body),body 为 snake_case 的裸资源对象。工具包括账户列表、预算创建、广告系列创建/更新/删除、广告组、广告、关键词、地理位置搜索与定位、图片素材上传、YouTube 视频素材关联、PMax 素材组创建、转化操作、用户列表、出价策略、共享集等,另有 google_ads_request 作为原始接口,以及可选的 data_apps_build / data_apps_refresh 数据看板。

运行方式:MCP 客户端先 search("<what you want to do>") 再 describe("<name>"),用 call("<name>", {...}) 执行;Hyper CLI 用 hyperai search、hyperai describe、hyperai call <name> --json '{...}'。

必须遵守的规则:预算用 micros($50/天 = 50,000,000 micros);创建广告系列必须 status="PAUSED",经用户明确批准后才激活;创建前须先汇总完整方案并获批准,按依赖顺序(预算→广告系列→定位→广告组→广告/素材)创建,并用返回的 resource_name 引用;工具会按真实 API schema 与渠道类型规则校验并返回纠正错误,应修正重试而非猜测。不得臆造 URL、预算、位置 ID、关键词或文案,创意只能来自实际站点。GAQL 限制:不得将 ad_group_criterion 与 search_term_view 连接;单批查询子账户不超过 5 个。

范围与限制:不包含实时优化变更(出价调整、暂停关键词、重构现有广告系列),报表可建议但须逐项用户批准;创意生成另见 ad-creative-generation;跨平台投放需对 Google 用本技能,再分别调用 meta-ads / tiktok-ads。详细约束见 references/constraints.md,参考文件位于 references/ 目录,按 references/<file> 读取。