基于 Google 官方 Search Console API 的 SEO 数据分析工具，帮助用户获取搜索查询、页面表现、索引状态等关键指标，优化网站搜索可见性。
说明：
## 核心用法
Google Search Console Skill 是一款面向 SEO 从业者和网站运营者的数据分析工具，通过调用 Google 官方 Search Console API 获取网站搜索表现数据。用户需先配置 Google Cloud OAuth 凭据并获取 `webmasters.readonly` 权限，即可通过命令行查询多维度的 SEO 数据。
该技能支持七大核心功能：列出可访问站点、获取热门搜索词、分析高流量页面、识别低 CTR 优化机会、检查 URL 索引状态、管理站点地图以及导出原始搜索分析数据。数据维度涵盖查询词、落地页、国家、设备和日期，核心指标包括点击数、展示次数、点击率和平均排名位置。
## 显著优点
**官方数据源可靠性**：直接对接 Google Search Console API，数据权威准确，无第三方数据污染风险。
**只读权限设计**：仅需 `webmasters.readonly` 范围，无法修改任何网站配置或数据，从根本上杜绝误操作风险。
**场景化查询模板**：内置低 CTR 机会识别、URL 索引检查等 SEO 高频场景命令，降低使用门槛。
**灵活的数据导出**：支持 JSON 格式原始数据输出，便于对接 BI 工具或自定义分析流程。
## 潜在缺点与局限性
**数据延迟问题**：GSC 数据存在约 3 天的固有延迟，无法获取实时搜索表现。
**外部脚本依赖**：核心功能依赖未随包分发的 Python 脚本，用户需自行确保脚本来源可信且版本兼容。
**硬编码路径风险**：命令示例中包含 `/Users/admin/clawd/skills/gsc//` 等绝对路径，跨环境部署需手动调整。
**凭据配置门槛**：需用户独立完成 Google Cloud 项目创建、OAuth 同意屏幕配置等流程，对非技术用户不够友好。
## 适合的目标群体
– **SEO 专员与顾问**：需要定期产出搜索表现报告、识别优化机会
– **内容运营团队**：基于真实搜索查询数据指导内容选题与优化
– **技术 SEO 工程师**：批量检查索引状态、监控站点地图健康度
– **独立站长与开发者**：低成本获取专业级搜索分析能力
## 使用风险
**性能风险**：大规模数据查询（如全站历史数据）可能触发 Google API 速率限制，建议合理设置 `–limit` 参数并分页处理。
**依赖项风险**：`google-api-python-client` 库版本迭代可能导致兼容性问题，建议锁定依赖版本。
**凭据泄露风险**：`.env` 文件若权限配置不当或误提交至版本控制，可能导致 OAuth 凭据泄露，需严格遵循最小权限原则并定期轮换密钥。
**数据解读风险**：GSC 的 “position” 指标为平均值，极端排名波动可能被平滑，重大决策建议结合其他工具交叉验证。
会员专属
