谷歌搜索控制台查询

技能简介

该技能连接Google Search Console API，支持查询网站搜索表现数据、分析关键词流量、发现CTR优化机会、检查页面索引状态及管理站点地图。

业务背景

帮助SEO运营人员系统监控网站搜索表现，替代手工登录后台导出数据的工作模式。通过自动抓取关键词排名、页面流量及CTR指标，快速识别内容优化机会，支撑数据驱动的搜索策略调整。

落地案例：内容团队每周需评估博客文章的搜索效果。运营人员配置站点参数后，脚本自动拉取近28天的热门查询词及对应点击数据，输出高展现低CTR的页面清单。编辑据此优先优化标题和描述，提升自然搜索流量的转化效率。

能做什么

• 列出可访问的Search Console站点列表
• 获取热门搜索查询及点击数据
• 查看流量最高的着陆页排名
• 识别高展现低点击的优化机会
• 检查具体URL的索引收录状态
• 查询已提交的站点地图信息
• 导出原始搜索分析JSON数据

使用说明

前置条件

1. 配置OAuth凭证：与GA4技能共用.env文件存储凭据
2. 添加权限范围：在Google Cloud OAuth同意屏幕添加webmasters.readonly范围
3. 确认访问权限：Google账号需拥有目标Search Console资源的访问权

安装指令

# 克隆技能仓库
git clone https://github.com/openclaw/skills.git
# 进入技能目录
cd skills/jdrhyne/gsc
# 创建并配置环境变量
cp .env.example .env
# 编辑.env填入GOOGLE_CLIENT_ID和GOOGLE_CLIENT_SECRET

常用命令示例

加载环境并查询站点列表：

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

查询某站热门搜索词（近28天）：

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

查找CTR优化机会（展现≥100次但点击率低）：

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py opportunities \
  --site "https://www.example.com" \
  --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.example.com" \
  --url "/target-page"

输入与输出

见下方输入与输出表格。

风险提示

• GSC数据存在约3天延迟，非实时数据
• URL检查功能要求页面已在资源范围内
• 频繁API调用可能触发Google配额限制
• OAuth凭证泄露可能导致搜索数据被非法访问
• 需定期刷新token避免授权过期

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jdrhyne/gsc/SKILL.md
来源类型：GitHub开源仓库