官方 Google Search Console API 封装工具，提供 SEO 数据分析、索引状态检查与优化机会挖掘，数据权威但存在约3天延迟。
说明：
## 核心用法
本 Skill 通过 Python 脚本封装 Google Search Console API，提供六大核心功能：
1. **站点列表查询** – 列出账号下可访问的所有 Search Console 属性
2. **搜索查询分析** – 获取带来流量的关键词及排名数据
3. **热门页面统计** – 分析流量最高的着陆页表现
4. **低 CTR 机会挖掘** – 识别高曝光低点击的优化空间（核心 SEO 价值功能）
5. **URL 索引检查** – 实时查询特定页面的收录状态
6. **站点地图管理** – 查看已提交的 sitemap 状态
所有查询均通过 OAuth 2.0 认证，支持 `query/page/country/device/date` 五个维度组合分析，返回 `clicks/impressions/ctr/position` 四项核心指标。
## 显著优点
– **官方数据源直连**：直接调用 Google 官方 Search Console API，数据权威性无可比拟
– **只读安全设计**：明确声明不修改任何 Search Console 配置，仅执行查询操作
– **SEO 场景覆盖完整**：从关键词研究、内容优化到技术 SEO 检查形成闭环
– **低 CTR 机会识别**：自动化计算高曝光低转化页面，这是 manual 分析难以批量完成的
– **凭证复用机制**：与 GA4 Skill 共享 Google OAuth 凭证，降低多工具配置成本
## 潜在缺点与局限性
– **数据延迟硬伤**：GSC 固有约3天数据延迟，无法用于实时监控突发流量变化
– **Python 环境依赖**：需要本地 Python 运行时，且依赖 `google-api-python-client` 等库
– **OAuth 配置门槛**：需提前在 Google Cloud Console 创建项目、配置同意屏幕、获取 refresh token
– **权限范围受限**：仅支持 `webmasters.readonly` 权限，无法执行提交 sitemap、移除 URL 等操作
– **URL 检查前置条件**：Inspect URL 功能要求目标页面必须已存在于该 Search Console 属性中
– **无历史趋势对比**：当前版本未内置跨时间段环比功能
## 适合人群
– **SEO 专员/顾问**：需要批量分析客户站点搜索表现的从业者
– **内容运营团队**：基于真实搜索数据优化标题、描述以提升 CTR
– **技术 SEO 工程师**：排查索引覆盖问题、验证 sitemap 健康度
– **网站管理员**：监控自有站点的 Google 搜索可见性变化
## 常规风险
– **凭证泄露风险**：`GOOGLE_CLIENT_ID/CLIENT_SECRET/REFRESH_TOKEN` 以环境变量形式管理，若终端历史记录或 `.env` 文件未妥善保护可能导致账号接管
– **API 配额消耗**：Search Console API 存在每日查询配额，高频调用可能触发限制
– **数据解读误区**：平均排名位置（position）为展示位置的算术平均，非真实排名分布，易被误读
– **归因局限**：GSC 数据无法区分品牌词与非品牌词，自然流量增长分析需结合其他工具
