核心用法
该技能通过 Maton 网关代理访问 Google Search Console API，提供托管式 OAuth 认证解决方案。用户无需自行处理 Google OAuth 流程，仅需 Maton API Key 即可调用完整的 Search Console 功能。
主要功能模块：
1. 站点管理 - 列出已验证站点、获取站点详情
2. 搜索分析查询 - 获取查询词、页面、设备类型、国家等维度的点击量、展示量、CTR 和排名数据，支持 16 个月内的时间序列分析
3. 站点地图管理 - 提交、列出、删除 XML 站点地图
4. 连接管理 - 通过独立控制面板 ctrl.maton.ai 创建、查看、删除 Google OAuth 连接，支持多账户切换
典型工作流：
- 设置
MATON_API_KEY环境变量 → 调用连接管理 API 创建 OAuth 连接 → 浏览器完成 Google 授权 → 通过gateway.maton.ai代理调用任意 Search Console API 端点
显著优点
- 零 OAuth 开发成本：完全托管的 OAuth 流程，无需处理 token 刷新、授权回调等复杂逻辑
- 原生 API 兼容性：直接透传 Google Search Console API，支持所有官方端点和参数
- 多账户支持：可同时管理多个 Google 账户的连接，通过 header 切换
- 多语言示例：提供 Python、JavaScript、cURL 完整代码片段
潜在缺点与局限性
- 数据延迟：Search Console 数据存在 2-3 天延迟，不适合实时决策
- 查询限制：单次最多 25,000 行，日期范围限 16 个月，大规模历史分析需分页处理
- 速率限制：10 请求/秒/账户，高频场景需自行限流
- 第三方依赖：核心功能依赖 Maton 服务可用性，存在供应商锁定风险
- URL 编码要求：站点 URL 必须手动 URL 编码，易出错
- 环境变量敏感：
MATON_API_KEY泄露将导致账户级别风险
适合人群
- SEO 分析师与营销团队，需程序化获取搜索表现数据
- 开发者构建内部 SEO 监控工具，希望跳过 OAuth 集成复杂度
- 数据工程师整合搜索数据至 BI 系统或数据仓库
常规风险
- 凭证泄露：API Key 需妥善保管，避免硬编码或日志泄露
- 权限范围：OAuth 授权时 Google 会展示具体权限范围，用户应确认仅授予 Search Console 相关权限
- 数据隐私：搜索查询数据可能包含敏感用户信息，需符合 GDPR 等合规要求
- 服务连续性：Maton 为商业服务，免费套餐可能有功能限制或数据保留期