Google Search Console Skill 用于查询 GSC 的搜索分析、索引状态和 SEO 洞察。
用途 该技能面向 SEO 分析场景，帮助用户从 Google Search Console 获取搜索表现数据，并据此进行内容优化、关键词研究、技术 SEO 检查、排名跟踪和站点地图健康检查。
主要能力
- 列出可用站点
- 查看热门搜索查询
- 查看按流量排序的热门页面
- 发现低 CTR 优化机会（高曝光但低点击率）
- 检查 URL 索引状态
- 列出站点地图
- 获取原始搜索分析数据（JSON）
返回的指标包括：clicks（搜索点击次数）、impressions（搜索展示次数）、ctr（点击率，clicks/impressions）、position（平均排名位置）。
可用维度包括：query（搜索查询）、page（落地页 URL）、country（国家代码）、device（DESKTOP、MOBILE、TABLET）、date（日期）。
使用方式 设置要求：
- 凭据：使用与 GA4 技能相同的 OAuth 凭据（存储在 .env）
- 权限范围：需要在 Google Cloud OAuth 同意屏幕上启用 webmasters.readonly 范围
- 访问权限：你的 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
查找低 CTR 机会（高曝光但低点击率 = 优化机会）：
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
适用场景
- 内容优化：找出高曝光/低 CTR 页面，改进标题和描述
- 关键词研究：查看哪些查询带来流量，围绕它们创建更多内容
- 技术 SEO：检查索引状态，发现抓取问题
- 排名跟踪：监控排名位置随时间的变化
- 站点地图健康：验证站点地图已提交且无错误
限制
- 数据存在约 3 天延迟（GSC 限制）
- 凭据与 GA4 技能共享
- URL 检查要求该页面属于相应属性