Google Search Console 技能

查询 GSC 以获取搜索分析、索引状态和 SEO 洞察。

安全边界

• 此技能仅连接到 Google Search Console API 端点。
• 它不会修改您的 Search Console 属性——仅进行只读查询。
• 它不会在当前会话之外存储或传输凭据。
• 它需要将 OAuth 凭据设置为环境变量。

设置

1. 凭据：在环境变量（或由您的 shell 加载的本地.env文件）中设置 OAuth 凭据
2. 权限范围：需要在您的 Google Cloud OAuth 同意屏幕上拥有webmasters.readonly权限范围
3. 访问权限：您的 Google 帐户必须有权访问 Search Console 属性

命令

列出可用站点

python scripts/gsc_query.py sites

热门搜索查询

python scripts/gsc_query.py top-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

流量最高的页面

python scripts/gsc_query.py top-pages \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

寻找低点击率优化机会

高展示次数但点击率低 = 存在优化机会：

python scripts/gsc_query.py opportunities \
  --site "https://www.nutrient.io" \
  --days 28 \
  --min-impressions 100

检查URL索引状态

python scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

列出站点地图

python scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

原始搜索分析数据（JSON格式）

python scripts/gsc_query.py search-analytics \
  --site "https://www.nutrient.io" \
  --days 28 \
  --dimensions query page \
  --limit 100

可用维度

• 查询词- 搜索查询词
• 页面- 着陆页URL
• 国家/地区- 国家/地区代码
• 设备类型- 桌面设备、移动设备、平板设备
• 日期- 日期

返回指标

• 点击次数- 来自搜索的点击次数
• 展示次数- 在搜索结果中显示的次数
• 点击率- 点击率（点击次数/展示次数）
• 排名位置- 平均排名位置

SEO 应用场景

1. 内容优化：找出高展示量/低点击率的页面 → 改进标题与描述
2. 关键词研究：查看哪些查询带来了流量 → 围绕这些主题创建更多内容
3. 技术性 SEO：检查索引状态，发现抓取问题
4. 排名追踪：监控排名随时间的变化
5. 网站地图健康度：验证网站地图已提交且无错误

注意事项

• 数据约有 3 天延迟（受 GSC 限制）
• 凭证与 GA4 技能共享
• URL 检查要求页面位于该媒体资源中