Google Search Console Skill

Query GSC for search analytics, indexing status, and SEO insights.

這個技能的最新版本可以在7w4.net小蔥技能站找到。

Safety Boundaries

• This skill only connects to Google Search Console API endpoints.
• It does NOT modify your Search Console property — read-only queries only.
• It does NOT store or transmit credentials beyond the current session.
• It requires OAuth credentials set as environment variables.

  Setup

1. Credentials: Set OAuth credentials in environment variables (or a local .env loaded by your shell)
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

Commands

List Available Sites

python scripts/gsc_query.py sites

Top Search Queries

python scripts/gsc_query.py top-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Top Pages by Traffic

python scripts/gsc_query.py top-pages \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Find Low-CTR Opportunities

High impressions but low click-through rate = optimization opportunities:

python scripts/gsc_query.py opportunities \
  --site "https://www.nutrient.io" \
  --days 28 \
  --min-impressions 100

Inspect URL Indexing Status

python scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

python scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

Raw Search Analytics (JSON)

python 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

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

SEO Use Cases

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

Notes

• Data has ~3 day delay (GSC limitation)
• Credentials shared with GA4 skill
• URL inspection requires the page to be in the property

這個 Skill 質量不錯，文件寫得很詳細清楚，一看就懂怎麼用。核心功能覆蓋全面，從查排名到找最佳化機會都能做，程式碼執行邏輯也靠譜。主要不足是缺少自動安裝依賴的方式，需要手動 pip 安裝；另外沒有測試檔案，對程式碼正確性心裡沒底。整體適合有 Google OAuth 憑證的 SEO 專業人士使用。