How do I install the Gsc skill?

Run npx skillmds@latest add majiayu000/gsc-2 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.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. 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.

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

Gsc by majiayu000 — Agent Skill

Name: Gsc
Rating: 4.5 (4 reviews)
Author: majiayu000

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.

majiayu000 Updated Sep 9, 2026 567 repo stars

File contents

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 in the workspace root)
Scopes: Requires https://www.googleapis.com/auth/webmasters.readonly scope on your Google Cloud OAuth consent screen
Access: Your Google account must have access to the Search Console properties
Virtual Environment: This skill uses a Python virtual environment to manage its dependencies. To run commands, use venv/bin/python3 scripts/gsc_query.py.

Commands

List Available Sites

venv/bin/python3 scripts/gsc_query.py sites

Top Search Queries

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

Top Pages by Traffic

venv/bin/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:

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

Inspect URL Indexing Status

venv/bin/python3 scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

venv/bin/python3 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: gsc-2description: 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 1. **Credentials**: Uses same OAuth credentials as GA4 skill (stored in `.env` in the workspace root) 2. **Scopes**: Requires `https://www.googleapis.com/auth/webmasters.readonly` scope on your Google Cloud OAuth consent screen 3. **Access**: Your Google account must have access to the Search Console properties 4. **Virtual Environment**: This skill uses a Python virtual environment to manage its dependencies. To run commands, use `venv/bin/python3 scripts/gsc_query.py`. ## Commands ### List Available Sites ```bash venv/bin/python3 scripts/gsc_query.py sites ``` ### Top Search Queries ```bash venv/bin/python3 scripts/gsc_query.py top-queries \ --site "https://www.nutrient.io" \ --days 28 \ --limit 20 ``` ### Top Pages by Traffic ```bash venv/bin/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: ```bash venv/bin/python3 scripts/gsc_query.py opportunities \ --site "https://www.nutrient.io" \ --days 28 \ --min-impressions 100 ``` ### Inspect URL Indexing Status ```bash venv/bin/python3 scripts/gsc_query.py inspect-url \ --site "https://www.nutrient.io" \ --url "/sdk/web" ``` ### List Sitemaps ```bash venv/bin/python3 scripts/gsc_query.py sitemaps \ --site "https://www.nutrient.io" ``` ### Raw Search Analytics (JSON) ```bash 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

Frequently asked questions

Gsc