名称： gsc
描述： 查询 Google Search Console 获取 SEO 数据，包括搜索查询、热门页面、CTR 优化机会、URL 检查及站点地图。适用于分析搜索表现、寻找优化机会或检查索引状态。

Google Search Console 技能

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

设置

1. 凭证：使用与 GA4 技能相同的 OAuth 凭证（存储在 .env 文件中）。
2. 权限范围：需要在 Google Cloud OAuth 同意屏幕上配置 webmasters.readonly 权限。
3. 访问权限：您的 Google 账户必须拥有相应 Search Console 资源的访问权限。

命令

列出可用站点

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py sites

热门搜索查询

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py top-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

按流量排序的热门页面

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py top-pages \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

寻找低点击率优化机会

高展示量但低点击率通常意味着存在优化空间：

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py opportunities \
  --site "https://www.nutrient.io" \
  --days 28 \
  --min-impressions 100

检查 URL 索引状态

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

列出站点地图

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

原始搜索分析数据 (JSON 格式)

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py search-analytics \
  --site "https://www.nutrient.io" \
  --days 28 \
  --dimensions query page \
  --limit 100

可用维度

• query - 搜索查询词
• page - 着陆页 URL
• country - 国家代码
• device - 设备类型 (DESKTOP, MOBILE, TABLET)
• date - 日期

返回指标

• clicks - 来自搜索的点击次数
• impressions - 在搜索结果中展示的次数
• ctr - 点击率 (clicks/impressions)
• position - 平均排名位置

SEO 应用场景

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

注意事项

• 数据存在约 3 天的延迟（GSC 系统限制）。
• 凭证与 GA4 技能共享。
• URL 检查要求该页面已包含在相应资源中。