Google Search Console

📊 托管 OAuth 的 SEO 数据中枢

seo-analytics榜 #1

Maton 托管的 Google Search Console API 代理,支持 OAuth 认证、搜索分析查询、站点地图管理和 SEO 数据监控,适合网站运营与流量分析场景。

收藏
22.2k
安装
6.1k
版本
1.0.4
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

本 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 等写操作不可逆,生产环境需谨慎测试

Google Search Console 内容

暂无文件树

手动下载zip · 3.8 kB
contentapplication/octet-stream
请选择文件