核心用法
Google Search Console 技能通过 Maton 平台提供对 Google Search Console API 的托管式访问，无需开发者自行处理复杂的 Google OAuth 2.0 流程。用户只需获取 Maton API Key，即可通过 REST API 查询网站搜索表现数据、管理站点地图、执行 URL 检测等操作。
关键操作流程：
1. 注册 Maton 账户并获取 MATON_API_KEY
2. 创建 Google Search Console 连接，完成浏览器端 OAuth 授权
3. 使用 Authorization: Bearer $MATON_API_KEY 头调用 API
4. 多账户场景下通过 Maton-Connection 头指定特定连接
主要 API 能力：
- 站点管理：列出/获取已验证站点信息
- 搜索分析：查询点击量、展示量、CTR、平均排名，支持按 query、page、device、country、date 维度拆解
- 站点地图：提交、获取、删除 sitemap
- 数据特性：16 个月历史数据、2-3 天延迟、单次最多 25,000 行
显著优点
1. OAuth 托管简化：完全省去 Google Cloud Console 项目配置、OAuth 客户端设置、令牌刷新维护等工作
2. 标准化代理：Maton 统一处理认证注入，开发者只需关注业务逻辑
3. 多语言示例完善：提供 Python、JavaScript、Bash 等可直接运行的代码片段
4. 连接管理灵活：支持多 Google 账户切换，通过连接 ID 精确控制访问范围
潜在缺点与局限性
1. 第三方依赖风险：核心功能依赖 Maton 服务可用性，若 Maton 平台故障则完全不可用
2. 数据延迟固有：Google Search Console 本身存在 2-3 天数据延迟，非本技能可解决
3. 请求限制：Rate limit 为 10 req/sec 每账户，大规模数据抓取需分页处理
4. 环境变量陷阱：文档特别指出 curl 管道到 jq 时环境变量可能无法正确展开
5. 无实时数据：不适合需要即时搜索表现的场景
适合人群
- SEO 分析师：需要程序化获取搜索表现数据用于报告自动化
- 开发者/技术团队：希望快速集成 GSC 数据到内部 BI 或监控系统的团队
- 多站点运营者：管理多个网站且需切换不同 Google 账户查看数据
- 无服务器/边缘计算场景：不方便持久化存储 OAuth 令牌的环境
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 密钥泄露 | `MATON_API_KEY` 泄露可导致账户数据被访问 | 使用密钥管理服务，避免硬编码 |
| 误操作写入 | 站点地图删除等操作不可逆 | 文档明确要求写操作前用户确认 |
| 权限过度 | OAuth 授权范围可能超出实际需求 | 定期审计 Maton 连接权限 |
| 供应商锁定 | 深度依赖 Maton 代理架构 | 保留直接调用 GSC API 的迁移能力 |
| 数据合规 | 搜索查询数据可能包含敏感信息 | 确保符合 GDPR 等数据保护法规 |