Back to Details

gsc

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Search Console Skill

Google Search Console Skill

Query GSC for search analytics, indexing status, and SEO insights.
通过GSC查询搜索分析数据、索引状态及SEO洞察。

Setup

配置

  1. Credentials: Uses same OAuth credentials as GA4 skill (stored in 
    .env
    )
  2. Scopes: Requires 
    webmasters.readonly
    scope on your Google Cloud OAuth consent screen
  3. Access: Your Google account must have access to the Search Console properties
  1. 凭证：使用与GA4 skill相同的OAuth凭证（存储在
    .env
    中）
  2. 权限范围：需要在Google Cloud OAuth同意屏幕上配置
    webmasters.readonly
    权限范围
  3. 访问权限：你的Google账户必须拥有对应Search Console资源的访问权限

Commands

命令

List Available Sites

列出可用站点

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 sites

Top Search Queries

热门搜索查询

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-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Top Pages by Traffic

按流量排序的热门页面

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
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

Find Low-CTR Opportunities

寻找低CTR优化机会

High impressions but low click-through rate = optimization opportunities:
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
高曝光但低点击率的页面存在优化空间：
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

Inspect URL Indexing Status

检测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 inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

列出站点地图

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

Raw Search Analytics (JSON)

原始搜索分析数据（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
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

Available Dimensions

可用维度

  • query
    - Search query
  • page
    - Landing page URL
  • country
    - Country code
  • device
    - DESKTOP, MOBILE, TABLET
  • date
    - Date
  • query
    - 搜索查询词
  • page
    - 落地页URL
  • country
    - 国家代码
  • device
    - DESKTOP、MOBILE、TABLET
  • date
    - 日期

Metrics Returned

返回指标

  • clicks - Number of clicks from search
  • impressions - Number of times shown in search
  • ctr - Click-through rate (clicks/impressions)
  • position - Average ranking position
  • clicks - 来自搜索的点击次数
  • impressions - 在搜索结果中展示的次数
  • ctr - 点击率（点击次数/展示次数）
  • position - 平均排名位置

SEO Use Cases

SEO应用场景

  1. Content Optimization: Find high-impression/low-CTR pages → improve titles & descriptions
  2. Keyword Research: See what queries bring traffic → create more content around them
  3. Technical SEO: Check indexing status, find crawl issues
  4. Ranking Tracking: Monitor position changes over time
  5. Sitemap Health: Verify sitemaps are submitted and error-free
  1. 内容优化：找到高曝光/低CTR的页面→优化标题和描述
  2. 关键词研究：查看哪些查询词带来流量→围绕这些词创建更多内容
  3. 技术SEO：检查索引状态，发现抓取问题
  4. 排名追踪：随时间监控排名变化
  5. 站点地图健康检查：验证站点地图已提交且无错误

Notes

注意事项

  • Data has ~3 day delay (GSC limitation)
  • Credentials shared with GA4 skill
  • URL inspection requires the page to be in the property
  • 数据存在约3天延迟（GSC限制）
  • 凭证与GA4 skill共享
  • URL检测要求页面属于对应资源