核心用法
本 skill 提供通过 Maton 网关代理访问 Google Search Console API 的能力,采用托管 OAuth 模式简化认证流程。用户通过 MATON_API_KEY 进行身份验证,在 ctrl.maton.ai 管理 Google 账户连接,完成 OAuth 授权后即可调用原生 Search Console API。
主要功能模块:
- 站点管理:列出已验证站点、获取站点详情
- 搜索分析(Search Analytics):查询点击量、展示量、CTR、平均排名等核心 SEO 指标,支持按关键词、页面、国家、设备、日期等多维度分析
- 站点地图管理:提交、查看、删除 sitemap
调用方式:所有请求发送至 https://gateway.maton.ai/google-search-console/{native-api-path},网关自动注入 OAuth token,无需自行处理 Google 认证流程。
显著优点
1. 零 OAuth 开发成本:Maton 托管 OAuth 流程,用户仅需在浏览器完成一次授权,无需搭建 OAuth 服务器或处理 token 刷新
2. 原生 API 透传:完全兼容 Google Search Console API 接口,支持所有官方功能(搜索分析、站点管理、站点地图)
3. 多连接支持:可同时管理多个 Google 账户,通过 Maton-Connection 头部指定连接
4. 多语言示例完善:提供 Bash、Python、JavaScript 完整代码示例,降低接入门槛
5. 数据维度丰富:支持 5 种维度(query/page/country/device/date)和 4 项核心指标,满足 SEO 分析需求
潜在缺点与局限性
1. 数据延迟:Search Console 数据存在 2-3 天延迟,不适合实时场景
2. 查询限制:单次最多返回 25,000 行,日期范围限制 16 个月,历史数据获取需分页处理
3. 依赖第三方网关:所有流量经过 Maton 网关,存在单点依赖;若 Maton 服务不可用则无法访问
4. URL 编码要求:站点 URL 需手动 URL 编码,易因格式错误导致请求失败
5. 速率限制:10 req/sec 的账户级限流,大规模数据抓取需控制频率
6. curl 特殊限制:含方括号的参数需加 -g 禁用 glob,环境变量在管道中可能无法正确展开
适合人群
- 网站运营/SEO 专员:需要定期监控搜索表现、分析关键词效果
- 数据分析师:将 Search Console 数据整合至内部报表或 BI 系统
- 开发者:构建 SEO 监控工具、自动化报告系统,希望避免 OAuth 开发成本
- 多站点管理者:需要统一管理多个网站的搜索表现数据
常规风险
1. 凭证泄露风险:MATON_API_KEY 泄露将导致账户级访问权限暴露,需妥善保管
2. 数据权限边界:OAuth 授权后 Maton 网关拥有对 Search Console 的读取(及写入,如提交 sitemap)权限,需确认连接管理页面的权限范围
3. 第三方信任链:数据流经 Maton 基础设施,需评估对其隐私政策和服务可用性的信任
4. Google API 变更:原生 API 更新后网关若未及时同步可能导致兼容性问题
5. 误操作风险:DELETE sitemap 等写操作不可逆,生产环境需谨慎测试