官方 SEO 数据一站式分析

官方 Google Search Console API 封装工具，提供 SEO 数据分析、索引状态检查与优化机会挖掘，数据权威但存在约3天延迟。

基本信息

• 技能名称?Google Search Console
• 中文名称?官方 SEO 数据一站式分析
• 作者?jdrhyne
• 分类?专业技能
• 版本?1.2.2
• 标签?seo, analytics, google-search-console, data-analysis, api-client, read-only

使用方法

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