🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Google Search Console
πŸ¦€ ClawHub

Google Search Console

by @jdrhyne

Query Google Search Console for SEO data - search queries, top pages, CTR opportunities, URL inspection, and sitemaps. Use when analyzing search performance,...

Versionv1.2.2
Downloads6,995
Stars⭐ 23
Comments2
#database#seo#legal#travel
TERMINAL
clawhub install gsc

πŸ“– About This Skill

name: gsc description: Query Google Search Console for SEO data - search queries, top pages, CTR opportunities, URL inspection, and sitemaps. Use when analyzing search performance, finding optimization opportunities, or checking indexing status. homepage: https://developers.google.com/webmaster-tools metadata: { "openclaw": { "emoji": "πŸ”", "requires": { "anyBins": ["python3", "python"], "env": ["GOOGLE_CLIENT_ID", "GOOGLE_CLIENT_SECRET", "GOOGLE_REFRESH_TOKEN"], }, }, }

Google Search Console Skill

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

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

    • βš™οΈ Configuration

    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

    πŸ“‹ Tips & Best Practices

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