Data & analysis

Google Search Console

Try it

Query Google Search Console data from the CLI for search analytics and indexing checks.

What it does

A read-only CLI wrapper around the Google Search Console API. It runs queries for search analytics, URL indexing status, and sitemaps, supports dimensions like query, page, country, device, and date, and returns clicks, impressions, CTR, and average position. Use it to surface low-CTR pages, top queries, and sitemap health. It does not modify the property, and OAuth credentials are not stored beyond the current session.

When to use it

  • Surface high-impression, low-CTR pages worth optimizing
  • List the search queries driving traffic to a site
  • Inspect a URL's crawl and indexing status
  • Check submitted sitemaps for errors

The skill document

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

Related skills

Join meeting

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

AdMapix

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Productivity

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Git

Run Git operations — commits, branches, merges, rebases, conflict resolution, and recovery — with safety rules enforced.

by Iván535 installs31 stars

More from jdrhyne

Browse all skills

jira

Natural-language Jira interaction that reads, drafts, creates, and updates issues.

by Jonathan Rhyne311 installs16 stars

context-recovery

Reconstruct missing conversation context after compaction or truncation using channel and session APIs.

by jdrhyne207 installs3 stars

google-ads

Query and audit Google Ads accounts via browser automation or the Google Ads API, including keyword pauses.

by jdrhyne257 installs14 stars

nudocs

Upload documents to Nudocs.ai for rich editing and pull back the results as docx, md, or pdf.

by jdrhyne92 installs1 stars

Nutrient OpenClaw

Convert, OCR, extract, redact, watermark, and sign PDF and Office documents inside OpenClaw via the Nutrient DWS plugin.

by jdrhyne125 installs4 stars

todo-tracker

Persistent TODO scratch pad for tracking tasks across sessions. Use when the user asks to add, list, complete, remove, or summarize tasks in a portable workspace Markdown file. Uses stable task IDs and exact matching; heartbeat reporting is opt-in and count-only.

by jdrhyne325 installs1 stars