核心用法
google-search-console 是一个托管式 OAuth API 网关技能，允许开发者通过 Maton 平台无缝调用 Google Search Console API。用户无需自行处理复杂的 OAuth 2.0 授权流程，Maton 自动注入和管理访问令牌。核心功能包括：
- 站点管理：列出和管理已验证的 Search Console 站点
- 搜索分析查询：获取查询词、页面、设备、国家、日期等多维度数据，支持点击数、展示次数、CTR、平均排名等关键 SEO 指标
- 站点地图操作：提交、删除和监控 sitemap 状态
使用方式为先通过 ctrl.maton.ai 管理 OAuth 连接，获得 connection_id 后，在 gateway.maton.ai 发起请求，路径直接映射原生 Google API。
显著优点
1. 零 OAuth 配置负担：开发者无需注册 Google Cloud 项目、配置 OAuth 同意屏幕或管理 token 刷新，大幅降低接入门槛
2. 原生 API 体验：路径参数完全对齐官方 API，便于迁移和查阅 Google 官方文档
3. 多连接支持：可为多个 Google 账号创建独立连接，通过 Maton-Connection 头部灵活切换
4. 丰富查询能力：支持日期范围过滤（最长16个月）、多维度分组、关键词过滤、分页等高级功能
5. 多语言示例：提供 JavaScript 和 Python 完整代码片段，便于快速上手
潜在缺点与局限性
- 供应商锁定：完全依赖 Maton 平台，若服务中断或策略变更将直接影响可用性
- 数据延迟：Search Console 数据本身有 2-3 天延迟，无法获取实时数据
- 分页限制：单次请求最多 25,000 行，大数据量需手动分页（
startRow） - 速率限制：每秒 10 请求/账户，高频率场景需自行限流
- 环境变量陷阱：curl 管道到
jq时可能遇到 API key 未正确展开的问题 - 无数据修改能力：仅支持查询和 sitemap 管理，无法直接修改索引状态或提交重新审核请求
适合人群
- SEO 分析师和数据工程师：需要程序化获取搜索表现数据
- 小型团队/独立开发者：缺乏 DevOps 资源处理 OAuth 基础设施
- 多站点运营者：需要统一接口管理多个 Search Console 账号
- 内容平台/ CMS 集成商：希望嵌入搜索分析仪表板
常规风险
1. API 密钥泄露：MATON_API_KEY 若暴露，他人可滥用配额并访问连接的 Google 数据
2. 权限范围风险：OAuth 授权时需确认 Maton 请求的权限范围，避免过度授权
3. 数据隐私合规：通过第三方网关传输搜索查询数据，需评估 GDPR/CCPA 等合规要求
4. 连接状态监控：OAuth token 可能过期或 revoked，需建立连接健康检查机制
5. 供应商依赖风险：Maton 作为中间层，其稳定性、安全实践和隐私政策直接影响数据安全