核心用法
本 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 数据无法区分品牌词与非品牌词，自然流量增长分析需结合其他工具