用途:在 AdsAgent MCP 服务器之上提供付费搜索的分析与操作框架,把 GAQL 原始数据转化为有依据的行动,覆盖效果诊断、关键词、出价、预算、否定词、广告系列、广告、搜索词、质量得分、地域定向与批量操作。
主要能力:只读分析通过 runScript 调用 ads.gaql() 与 ads.gaqlParallel() 并行执行多条 GAQL 查询;模式发现用 getResourceMetadata、listQueryableResources;专用读取用 searchGeoTargets、getKeywordIdeas、getRecommendations、getChanges、reviewChangeImpact;变更走专用写入工具(如 pauseKeyword、updateBid、createCampaign、bulkAddKeywords),每次返回 changeId,可在 7 天内用 undoChange 撤销。参考文档按需加载,涵盖分析启发式、质量得分框架、出价策略决策树、行业基准、搜索词分析、广告系列结构、会话检查与变更追踪。
使用方式:先按 ../shared/preamble.md 完成 MCP 检测、API 密钥与账户选择;写入前展示当前值、建议值与预期金额影响并等待确认;分析优先用一次 runScript 扇出多条查询;指标以美元和百分比呈现并注明日期范围;每次写入按 references/change-tracking.md 记录。moveKeywords 默认 PHRASE 匹配且不继承来源,必须显式传 matchType。
限制:服务端护栏拒绝出价变动超过 25%、预算变动超过 50%,不可绕过,需拆分到多日执行。业务上下文读取 {data_dir}/business-context.json 与 {data_dir}/personas/{accountId}.json,缺失或超过 90 天建议先运行 /ads-audit。账户基线存于 {data_dir}/account-baseline.json,超过 24 小时需按 session-checks 做异常对比。工具清单以 MCP 服务器 tools/list 为准。