介绍
# Google Search Console Skill
查询 GSC 以获取搜索分析、索引状态和 SEO 洞察。
## 设置
1. **凭据**：使用与 GA4 技能相同的 OAuth 凭据（存储在 `.env` 中） 2. **范围**：需要在您的 Google Cloud OAuth 同意屏幕上配置 `webmasters.readonly` 范围 3. **权限**：您的 Google 账户必须拥有 Search Console 媒体资源的访问权限
## 命令
### 列出可用站点 ```bash source /Users/admin/clawd/skills/gsc/.env && \ python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py sites ```
### 热门搜索查询 ```bash 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 ```
### 按流量排名的热门页面 ```bash 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) 机会 高展示量但低点击率 = 优化机会： ```bash 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 索引状态 ```bash 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" ```
### 列出站点地图 ```bash source /Users/admin/clawd/skills/gsc/.env && \ python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py sitemaps \ --site "https://www.nutrient.io" ```
### 原始搜索分析 (JSON) ```bash 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 检查要求页面必须在媒体资源中