Google Search Console

核心用法

该技能通过 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 为商业服务，免费套餐可能有功能限制或数据保留期

核心用法

Google Search Console 技能是一套纯文档型 API 集成指南，通过 Maton 网关代理访问 Google Search Console API。用户需先在 maton.ai 获取 MATON_API_KEY，然后在 ctrl.maton.ai 管理 OAuth 连接完成授权。

主要功能包括：

• 站点管理：列出授权站点、获取站点信息
• 搜索分析：查询搜索查询词、页面表现、设备分布、每日趋势等多维度数据
• 网站地图：提交、列出、删除站点地图

请求需通过 https://gateway.maton.ai/google-search-console/{native-api-path} 发送，自动注入 OAuth Token。支持通过 Maton-Connection 头指定多连接场景。

显著优点

1. 托管 OAuth 免维护：无需自行搭建 OAuth 2.0 流程，Maton 处理令牌刷新和存储
2. 原生 API 全覆盖：完整支持 Search Console API v3，包括搜索分析查询、站点管理、网站地图操作
3. 多语言示例：提供 Python、JavaScript、cURL 等完整代码片段，开箱即用
4. 数据维度丰富：支持 query/page/country/device/date 五维分析，自动返回 clicks/impressions/ctr/position 核心指标
5. 来源可信：由 Maton 官方维护，MIT 开源协议，安全认证达 T2 级别

潜在缺点与局限性

1. 数据延迟：搜索分析数据有 2-3 天延迟，无法获取实时数据
2. 查询限制：单次最多 25,000 行，日期范围限制 16 个月，高频场景需分页处理
3. 依赖第三方网关：所有数据流经 Maton 服务，存在额外的信任假设和可用性依赖
4. 速率限制：10 req/sec 每账户，大规模批量操作需实现退避重试
5. 纯文档无 SDK：无封装好的客户端库，开发者需自行处理 URL 编码、错误处理等细节

适合人群

• SEO 分析师和运营人员需要程序化获取搜索表现数据
• 数据工程师构建站点 SEO 监控看板
• 小型团队无精力维护 OAuth 基础设施，希望快速接入
• 需要将 Search Console 数据同步至内部 BI 系统的开发者

常规风险

1. API 密钥泄露：MATON_API_KEY 泄露可能导致他人滥用 Maton 账户配额，需严格保管
2. 数据中转风险：站点搜索数据经过 Maton 网关，需评估服务商隐私政策
3. OAuth 权限范围：授权时需确认 Google 账号权限范围，避免过度授权
4. URL 编码陷阱：站点 URL 需 URL 编码，容易因编码错误导致 404
5. Shell 环境变量扩展问题：文档特别提示 curl 管道到 jq 时可能出现变量未扩展情况

整体评估为低风险、高实用价值的 SEO 数据接入方案。