Gsc

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.From its SKILL.md

Install

npx -y skills add jdrhyne/agent-skills --skill gsc

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

reads credentialsReads from 1 credential source: `.env`.
runs commandsInstructs the agent to run 7 commands, including `source .env && python3 scripts/gsc_query.py sites` and 6 more.

SKILL.md

2.8 KB, 672 tokens by cl100k_base, as published. Nobody here has run it

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

What ships with it: 4 files

15.6 KB alongside SKILL.md, 2 of them executable

.clawhub/

origin.json135 B

scripts/

gsc_auth.pyruns2.9 KB
gsc_query.pyruns12.5 KB

_meta.json122 B