核心用法
Google Search Console Skill 是 Maton 提供的 Google Search Console API 代理网关，通过托管 OAuth 简化认证流程，使开发者能够以 API 形式访问搜索分析数据、管理站点地图及监控网站在 Google 搜索中的表现。
主要功能模块：
- 站点管理：列出已验证站点、获取站点详情
- 搜索分析查询：支持按查询词、页面、国家、设备、日期等多维度聚合数据，返回点击量、展示量、点击率、平均排名等核心 SEO 指标
- 站点地图管理：提交、列出、删除 sitemap 文件
典型调用模式：
1. 在 ctrl.maton.ai 创建 Google OAuth 连接并完成授权
2. 使用 Maton API Key 调用 gateway.maton.ai 代理端点
3. 所有请求自动注入用户 OAuth Token，无需自行管理 refresh token
显著优点
1. 零运维 OAuth：托管式连接管理，开发者无需实现 OAuth 2.0 授权码流程或处理 token 刷新
2. RESTful 接口：直接映射 Google 官方 API，学习成本低，现有 GSC API 文档完全适用
3. 多语言友好：提供 JavaScript/Python 示例，支持标准 HTTP 客户端
4. 数据完整性：返回 clicks、impressions、ctr、position 四大核心指标，覆盖 SEO 日常分析需求
潜在缺点与局限性
1. 数据延迟：搜索分析数据存在 2-3 天延迟，无法用于实时监控
2. 查询限制：单次最多 25,000 行，日期范围限制 16 个月，大规模历史数据分析需分页处理
3. 速率限制：10 req/sec 的账户级限流，高并发场景需自行实现退避策略
4. 依赖第三方代理：所有流量经过 Maton 网关，存在单点依赖风险；若服务不可用，数据访问完全中断
5. 权限边界：仅支持已验证站点的数据，无法访问未验证域名或竞争对手数据
适合人群
- SEO 分析师/团队：需要程序化获取排名数据，构建内部报表系统
- 内容运营：追踪关键词表现，评估内容优化效果
- 开发者：为 SaaS 产品集成网站健康度监控功能
- 小型至中型网站：数据量适中，无需突破 25,000 行/次限制的场景
常规风险
1. 认证风险：OAuth 授权存储于第三方平台，需信任 Maton 的连接安全策略；建议定期审查已授权连接
2. 数据隐私：网站搜索表现数据（含查询词）流经代理服务器，敏感行业（金融、医疗）需评估合规性
3. API 变更滞后：Google Search Console API 更新时，代理层可能存在适配延迟
4. 误操作风险：站点地图的 PUT/DELETE 操作直接影响 Google 索引行为，生产环境建议先验证再执行