gsc - SKILL.md Agent 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.

Google Search Console Skill

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

Setup

Credentials: Uses same OAuth credentials as GA4 skill (stored in .env)
Scopes: Requires webmasters.readonly scope on your Google Cloud OAuth consent screen
Access: Your Google account must have access to the Search Console properties
Run location: Commands below use relative paths — run them from this skill's directory (cd into it first)

Commands

List Available Sites

source .env && \
python3 scripts/gsc_query.py sites

Top Search Queries

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

Top Pages by Traffic

source .env && \
python3 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:

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

Inspect URL Indexing Status

source .env && \
python3 scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

source .env && \
python3 scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

Raw Search Analytics (JSON)

source .env && \
python3 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

Content Optimization: Find high-impression/low-CTR pages → improve titles & descriptions
Keyword Research: See what queries bring traffic → create more content around them
Technical SEO: Check indexing status, find crawl issues
Ranking Tracking: Monitor position changes over time
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