How do I install the Gsc skill?

Run npx skillmds add aaaaqwq/gsc in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: WARNING, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gsc?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

aAAaqwq (@aaaaqwq) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gsc by aaaaqwq — Agent Skill

Name: Gsc
Rating: 4.2 (5 reviews)
Author: aAAaqwq

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.

aAAaqwq 91ad831 5 files · 18.4 KB Updated Aug 19, 2026 1 repo stars

File contents

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

Credentials: Set OAuth credentials in environment variables (or a local .env loaded by your shell)
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

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

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

---name: gscdescription: 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 SkillQuery 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.## Setup1. **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 screen3. **Access**: Your Google account must have access to the Search Console properties## Commands### List Available Sites```bashpython scripts/gsc_query.py sites```### Top Search Queries```bashpython scripts/gsc_query.py top-queries \ --site "https://www.nutrient.io" \ --days 28 \ --limit 20```### Top Pages by Traffic```bashpython scripts/gsc_query.py top-pages \ --site "https://www.nutrient.io" \ --days 28 \ --limit 20```### Find Low-CTR OpportunitiesHigh impressions but low click-through rate = optimization opportunities:```bashpython scripts/gsc_query.py opportunities \ --site "https://www.nutrient.io" \ --days 28 \ --min-impressions 100```### Inspect URL Indexing Status```bashpython scripts/gsc_query.py inspect-url \ --site "https://www.nutrient.io" \ --url "/sdk/web"```### List Sitemaps```bashpython scripts/gsc_query.py sitemaps \ --site "https://www.nutrient.io"```### Raw Search Analytics (JSON)```bashpython 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 Cases1. **Content Optimization**: Find high-impression/low-CTR pages → improve titles & descriptions2. **Keyword Research**: See what queries bring traffic → create more content around them3. **Technical SEO**: Check indexing status, find crawl issues4. **Ranking Tracking**: Monitor position changes over time5. **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

Frequently asked questions