Google Search Console

核心用法

Google Search Console技能通过Maton AI网关提供对Google Search Console API的托管式OAuth访问，主要功能包括：

1. 搜索分析查询：获取关键词排名、点击量、展示量、CTR和平均排名数据，支持按查询词、页面、设备、国家、日期等维度分析
2. 站点管理：列出和管理已验证的Search Console站点
3. 站点地图操作：提交、查询和删除站点地图文件
4. 性能监控：追踪网站在Google搜索中的表现趋势

使用流程：获取Maton API Key → 在ctrl.maton.ai创建Google OAuth连接 → 通过gateway.maton.ai代理调用原生Search Console API。

显著优点

• 零OAuth基础设施：无需注册Google Cloud项目、配置OAuth客户端或处理token刷新
• 原生API兼容：直接透传Google Search Console API请求，保持官方接口语义
• 多连接管理：支持同一账户下的多个Google身份切换
• 多语言示例：提供Python、JavaScript、curl等完整代码示例
• 数据维度丰富：支持query/page/country/device/date五维分析

潜在局限

• 数据延迟：Search Console数据通常有2-3天延迟，非实时
• 查询限制：单次最多25,000行，日期范围限制16个月
• 速率限制：10请求/秒/账户
• 第三方依赖：核心功能依赖Maton AI网关的可用性和持续运营
• URL编码要求：站点URL需手动URL编码，增加使用复杂度

适合人群

• SEO分析师和数字营销人员
• 需要程序化获取搜索性能数据的开发者
• 希望避免OAuth复杂配置的技术团队
• 需要定期生成SEO报告的内容运营者

常规风险

• 密钥泄露风险：MATON_API_KEY泄露可能导致Search Console数据被未授权访问
• 供应链风险：Maton网关服务中断将直接影响数据获取能力
• OAuth权限范围：需授权Google账户对Search Console的访问权限，存在过度授权可能
• 数据隐私：搜索查询数据可能包含敏感信息，通过第三方网关传输需评估合规性

核心用法

该 Skill 是 Google Search Console API 的代理网关集成，通过 Maton 托管服务 (gateway.maton.ai) 实现对 Google Search Console 的标准化访问。用户需先在 Maton 平台获取 API 密钥并建立 OAuth 连接，即可通过 RESTful API 查询搜索分析数据、管理站点列表、提交或删除站点地图。

典型工作流：
1. 获取 Maton API Key 并设置环境变量 MATON_API_KEY
2. 在 ctrl.maton.ai 创建 Google Search Console 连接，完成 OAuth 授权
3. 通过 gateway.maton.ai/google-search-console/{api-path} 调用原生 API
4. 支持指定多连接场景下的特定连接 ID（Maton-Connection 头部）

主要功能模块：

• 站点管理：列出授权站点、获取站点详情
• 搜索分析：按查询词、页面、设备、国家、日期等多维度分析点击、展示、CTR、排名
• 站点地图：提交、列出、删除站点地图
• 连接管理：创建、查询、删除 OAuth 连接

显著优点

• 托管 OAuth 简化授权：无需自行处理 Google OAuth 2.0 流程，Maton 平台集中管理令牌生命周期
• 原生 API 透传：完全兼容 Google Search Console API 路径和参数，学习成本低
• 多语言示例完备：提供 Python、JavaScript、bash/curl 的完整调用示例
• 多连接支持：适合代理管理多个客户站点的 SEO 服务商场景
• 纯文档型零依赖：无需安装额外包，标准 HTTP 客户端即可调用

潜在缺点与局限性

• 第三方网关依赖：所有流量经过 Maton 服务器，存在服务可用性、隐私政策合规审查需求
• 速率限制：账号级别 10 req/s，大数据量场景需分页处理（startRow + rowLimit ≤ 25000）
• 数据延迟：搜索分析数据有 2-3 天延迟，非实时
• 查询范围限制：日期范围最多 16 个月历史数据
• URL 编码繁琐：站点 URL 需手动 URL 编码（如 https://example.com → https%3A%2F%2Fexample.com）
• 环境变量易错：curl 管道场景下环境变量可能无法正确展开，需用 Python/JS 示例规避

适合人群

• SEO 分析师和数字营销团队，需程序化获取搜索表现数据
• 多站点管理的技术团队，需批量监控多个域名的搜索指标
• 构建内部 SEO 报表系统的开发者
• 需要自动化站点地图提交的技术 SEO 工程师

不适合：追求完全自建基础设施、对第三方数据中转有合规顾虑的企业；需要亚实时数据监控的场景。

常规风险

| 风险类别 | 说明 | 缓解建议 |

|---------|------|---------|

| 第三方服务依赖 | Maton 网关故障或政策变更影响服务连续性 | 关注 Maton 状态公告，设计降级方案 |

| API 密钥泄露 | `MATON_API_KEY` 泄露导致未授权访问 | 定期轮换密钥，使用密钥管理系统，避免硬编码 |

| OAuth 权限过宽 | 授权范围可能超出实际需求 | 审查 Maton 申请的 Google OAuth scope |

| 数据隐私合规 | 搜索查询数据经第三方中转 | 审查 Maton DPA/隐私政策，评估 GDPR/SOC2 符合性 |

| 错误配置连接 | 多连接场景下误用默认连接导致数据混淆 | 显式指定 `Maton-Connection` 头部 |

| 速率限制触发 | 高频调用触发 429 限制 | 实施指数退避重试，合理设置分页参数 |

该 Skill 整体安全评级优秀（S 级），无恶意代码，但用户需充分评估第三方网关架构对自身数据主权和合规要求的影响。