Google Search Console

核心用法

google-search-console 是一个托管式 OAuth API 网关技能，允许开发者通过 Maton 平台无缝调用 Google Search Console API。用户无需自行处理复杂的 OAuth 2.0 授权流程，Maton 自动注入和管理访问令牌。核心功能包括：

• 站点管理：列出和管理已验证的 Search Console 站点
• 搜索分析查询：获取查询词、页面、设备、国家、日期等多维度数据，支持点击数、展示次数、CTR、平均排名等关键 SEO 指标
• 站点地图操作：提交、删除和监控 sitemap 状态

使用方式为先通过 ctrl.maton.ai 管理 OAuth 连接，获得 connection_id 后，在 gateway.maton.ai 发起请求，路径直接映射原生 Google API。

显著优点

1. 零 OAuth 配置负担：开发者无需注册 Google Cloud 项目、配置 OAuth 同意屏幕或管理 token 刷新，大幅降低接入门槛
2. 原生 API 体验：路径参数完全对齐官方 API，便于迁移和查阅 Google 官方文档
3. 多连接支持：可为多个 Google 账号创建独立连接，通过 Maton-Connection 头部灵活切换
4. 丰富查询能力：支持日期范围过滤（最长16个月）、多维度分组、关键词过滤、分页等高级功能
5. 多语言示例：提供 JavaScript 和 Python 完整代码片段，便于快速上手

潜在缺点与局限性

• 供应商锁定：完全依赖 Maton 平台，若服务中断或策略变更将直接影响可用性
• 数据延迟：Search Console 数据本身有 2-3 天延迟，无法获取实时数据
• 分页限制：单次请求最多 25,000 行，大数据量需手动分页（startRow）
• 速率限制：每秒 10 请求/账户，高频率场景需自行限流
• 环境变量陷阱：curl 管道到 jq 时可能遇到 API key 未正确展开的问题
• 无数据修改能力：仅支持查询和 sitemap 管理，无法直接修改索引状态或提交重新审核请求

适合人群

• SEO 分析师和数据工程师：需要程序化获取搜索表现数据
• 小型团队/独立开发者：缺乏 DevOps 资源处理 OAuth 基础设施
• 多站点运营者：需要统一接口管理多个 Search Console 账号
• 内容平台/ CMS 集成商：希望嵌入搜索分析仪表板

常规风险

1. API 密钥泄露：MATON_API_KEY 若暴露，他人可滥用配额并访问连接的 Google 数据
2. 权限范围风险：OAuth 授权时需确认 Maton 请求的权限范围，避免过度授权
3. 数据隐私合规：通过第三方网关传输搜索查询数据，需评估 GDPR/CCPA 等合规要求
4. 连接状态监控：OAuth token 可能过期或 revoked，需建立连接健康检查机制
5. 供应商依赖风险：Maton 作为中间层，其稳定性、安全实践和隐私政策直接影响数据安全

核心用法

google-search-console skill 是一款纯文档型集成工具，帮助用户通过 Maton API 网关 访问 Google Search Console 官方 API。核心流程包括：

1. 获取 Maton API Key：在 maton.ai 注册并生成密钥，设置环境变量 MATON_API_KEY
2. 建立 OAuth 连接：通过 ctrl.maton.ai/connections 创建 Google 授权连接，浏览器完成 OAuth 授权
3. 调用 API：向 gateway.maton.ai/google-search-console/{api-path} 发送请求，网关自动注入 OAuth Token

主要功能模块：

• Sites 管理：列出现有网站、获取站点详情
• 搜索分析：查询点击量、展示量、CTR、平均排名，支持按 query/page/country/device/date 维度分析
• 站点地图：提交、列出、删除 sitemap 文件

数据查询限制：日期范围最长 16 个月，单次最多 25,000 行，数据延迟 2-3 天。

---

显著优点

| 优势 | 说明 |

|:---|:---|

| **简化 OAuth** | 无需自建 OAuth 应用，Maton 托管认证流程，降低接入门槛 |

| **原生 API 透传** | 直接映射 Google Search Console REST API，功能完整无阉割 |

| **多语言示例** | 提供 curl、JavaScript、Python 完整代码，开箱即用 |

| **多连接管理** | 支持多个 Google 账号同时授权，通过 `Maton-Connection` 头切换 |

| **凭证安全** | 代码示例均使用环境变量管理 API Key，无硬编码风险 |

---

潜在缺点与局限性

1. 第三方依赖风险：所有数据流经 maton.ai 服务器，用户无法直接控制数据中转环节
2. 额外成本：需注册 Maton 服务，可能涉及付费（文档未明确定价）
3. 速率限制：10 req/sec 的账号级限速，大规模数据抓取受限
4. 网络依赖：必须授权网络访问权限，无法离线使用
5. 数据延迟：Search Console 数据本身有 2-3 天延迟，非本 skill 特有

---

适合人群

• SEO 分析师：需要程序化获取搜索表现数据，制作自动化报表
• 营销团队：追踪关键词排名、页面表现，评估内容策略效果
• 开发者：为内部工具集成 Search Console 数据，避免重复造 OAuth 轮子
• 中小网站运营者：无企业级 Google Cloud 资源，希望低成本接入 API

不适合：对数据隐私极度敏感、要求数据不经第三方中转的合规严格场景（如金融、医疗行业）。

---

常规风险

| 风险类别 | 等级 | 说明 |

|:---|:---|:---|

| 第三方服务信任 | 中 | Maton 作为 T3 来源可信度，需用户自行评估其数据安全策略 |

| API 密钥泄露 | 低 | 若用户未妥善保管 `MATON_API_KEY`，可能导致账号被滥用 |

| 数据过度授权 | 低 | OAuth 授权时 Google 会展示权限范围，用户需确认仅授予必要权限 |

| 服务商可用性 | 中 | Maton 服务中断将直接影响 API 调用，无 fallback 机制 |

| 隐私合规 | 中 | 数据出境/中转需符合 GDPR、个人信息保护法等法规要求 |

缓解建议：将 API Key 存储于 .env 文件并排除在版本控制外；定期审查 Maton 安全认证状态；对敏感数据评估直接调用 Google API 的替代方案。