Google Search Console

📊 托管 OAuth 的 SEO 数据中枢

seo-analytics榜 #1

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

收藏
22.2k
安装
6.1k
版本
1.0.4
CLS 安全性认证2026-06-05
点击查看完整报告 >

使用说明

核心用法

本 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 Skill 是一个纯文档型 API 集成指南,帮助用户通过 Maton.ai 托管网关访问 Google Search Console API。用户只需获取 Maton API 密钥,即可查询搜索分析数据、管理站点、操作站点地图,无需处理复杂的 Google OAuth 2.0 流程。

主要功能模块

  • 站点管理:列出已验证站点、获取站点状态
  • 搜索分析:查询点击量、展示量、CTR、排名等核心指标,支持按查询词、页面、国家、设备、日期等维度分析
  • 站点地图:提交、删除、查看站点地图状态

使用流程
1. 注册 Maton.ai 账号并获取 API 密钥

2. 在 ctrl.maton.ai 创建 Google Search Console 连接并完成 OAuth 授权

3. 通过 gateway.maton.ai/google-search-console/{native-api-path} 发送请求

显著优点

1. 零 OAuth 基础设施:无需自建 OAuth 流程,Maton 托管认证大幅降低接入门槛
2. 原生 API 兼容:直接代理 Google Search Console API,请求路径与官方 API 一致

3. 多语言示例:提供 Python、JavaScript、curl 等完整代码示例,即拿即用

4. 多连接管理:支持配置多个 Google 账号,通过 Maton-Connection 头切换

5. 环境变量安全:所有示例均采用环境变量管理密钥,无硬编码风险

潜在缺点与局限性

1. 第三方代理依赖:所有数据流经 Maton 服务器,存在数据隐私和可用性依赖
2. 速率限制严格:10 req/sec 的账号级限速,批量操作受限

3. 数据延迟保留:Search Console 数据本身有 2-3 天延迟,非本 Skill 可解决

4. 查询限制:单次最多 25,000 行,16 个月历史数据限制

5. 跨境传输风险:Maton 服务器位置可能导致数据出境合规问题

适合人群

  • 需要快速获取 Search Console 数据但不想维护 OAuth 的技术团队
  • 营销分析师和 SEO 专员,需要通过 API 自动化报告生成
  • 中小网站站长,希望以低成本方式监控搜索表现
  • 数据工程师构建 SEO 数据管道

常规风险

1. 供应商锁定:完全依赖 Maton 服务,若服务中断或终止将影响业务
2. 隐私合规:搜索查询词、页面 URL 等可能包含敏感信息,需确认 Maton 数据处理条款

3. 密钥泄露:环境变量在管道命令中可能展开失败,存在意外暴露风险

4. 授权范围:需确保仅授予必要的 Search Console 权限,定期审查 OAuth 授权

Google Search Console 内容

手动下载zip · 3.8 kB
LICENSE.txttext/plain
请选择文件