A tool to query Google Search Console for SEO data such as queries, top pages, CTR opportunities, URL inspection, and sitemaps.

What data can I access?

Search analytics, top pages, opportunities (high impressions with low CTR), URL indexing status, and sitemap listings.

What are the prerequisites?

OAuth credentials configured in .env, the webmasters.readonly scope, and access to the relevant Search Console properties. URL inspection requires the page to be in the property. Data has ~3 day delay.

Google Search Console

@jdrhyne

npx machina-cli add skill @jdrhyne/gsc --openclaw

Files (1)

SKILL.md

3.0 KB

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

Commands

List Available Sites

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py sites

Top Search Queries

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py top-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Top Pages by Traffic

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/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 /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py opportunities \
  --site "https://www.nutrient.io" \
  --days 28 \
  --min-impressions 100

Inspect URL Indexing Status

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

Raw Search Analytics (JSON)

source /Users/admin/clawd/skills/gsc/.env && \
python /Users/admin/clawd/skills/gsc/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

Source

git clone https://clawhub.ai/jdrhyne/gscView on GitHub

Overview

This skill queries Google Search Console for search analytics, indexing status, and SEO insights. It helps identify optimization opportunities, monitor ranking changes, and verify sitemap health.

How This Skill Works

It reuses the same OAuth credentials as the GA4 skill and uses the webmasters.readonly scope. Commands (top-queries, top-pages, opportunities, inspect-url, sitemaps, search-analytics) query the GSC API to return performance and indexing data for specified sites. Results enable data-driven content optimization and technical SEO checks.

When to Use It

Analyze search performance for a site to understand how it’s performing in Google Search
Find high-impression, low-CTR pages and optimize titles/descriptions
Check indexing status and identify crawl issues for new or updated pages
Validate sitemap health and submission status after site changes
Explore queries to inform content gaps and new topic ideas

Quick Start

Step 1: Load your environment with the same GA4 credentials (.env) and ensure webmasters.readonly scope is granted
Step 2: Run a sample command, e.g., top-queries for your site, to fetch initial data
Step 3: Review the results (queries, pages, CTR opportunities, indexing status) and take optimization actions

Best Practices

Prioritize high-impression pages with CTR gaps and craft targeted title/description improvements
Pair top queries with landing pages to build relevant topic clusters
Regularly verify URL indexing status when publishing new content or making structural changes
Run sitemap checks after site migrations or major updates to catch errors early
Account for ~3-day data delay when tracking trend changes and planning optimizations

Example Use Cases

Identify high-impression, low-CTR pages for Nutrient.io and update meta titles and descriptions to improve clicks
Track ranking changes for top queries over 28 days to assess impact of content updates
Inspect a newly published page's indexing status to ensure it is crawled and indexed promptly
Verify that sitemaps are submitted and error-free after a site migration
Audit queries bringing traffic to a landing page to inform additional related content

Frequently Asked Questions

Add this skill to your agents