Google Search Console (GSC)

Maintained by Amir Ali.

A Model Context Protocol (MCP) server that connects Google Search Console to AI assistants — query your SEO data, audit indexing, manage sitemaps, and run full site audits through natural language. Works with Claude Code, Claude Desktop, Cursor, Codex CLI, and any other MCP-compatible client.

---

What's Different in This Edition

This fork keeps the full 20-tool GSC API surface from the upstream project and adds 8 new skills plus a master audit skill that cross-references findings across checks instead of reporting them in isolation:

• device-performance-split, country-opportunities, branded-vs-nonbranded — deeper analytics cuts the base tools don't surface on their own
• new-vs-lost-queries, content-decay-report, sitemap-health-check — trend and health checks the original skill set didn't cover
• multi-property-comparison — portfolio-level view across every property in the account
• full-seo-audit — chains indexing, sitemap, cannibalization, content-decay, and lost-query checks together and cross-references the results to point at the actual root cause (e.g. a "decaying" page that's really being cannibalized by a newer page, not losing to competitors)

See Available Skills below for the full list, and SETUP.md for the install walkthrough.

---

Available Tools

All 19 tools covering the full GSC API surface:

Tool	What It Does	What You Need to Provide
get_capabilities	Lists all tools and shows auth status — call this first if unsure	Nothing
list_properties	Shows all your GSC properties	Nothing
get_site_details	Details about a specific site	Site URL
add_site	Add a new property to the account (disabled by default)	Site URL
delete_site	Remove a property from the account (disabled by default)	Site URL
get_search_analytics	Top queries and pages with clicks, impressions, CTR, position	Site URL, time period
get_performance_overview	Summary of site performance with daily trend	Site URL, time period
compare_search_periods	Compare performance between two time periods	Site URL, two date ranges
get_search_by_page_query	Search terms driving traffic to a specific page	Site URL, page URL
get_advanced_search_analytics	Analytics with filters by country, device, query, page	Site URL
inspect_url_enhanced	Detailed crawl/index status for a URL	Site URL, page URL
batch_url_inspection	Inspect up to 10 URLs at once	Site URL, list of URLs
check_indexing_issues	Check multiple URLs for indexing problems	Site URL, list of URLs
get_sitemaps	Lists all sitemaps for a site	Site URL
list_sitemaps_enhanced	Detailed sitemap info including errors and warnings	Site URL
get_sitemap_details	Submitted-vs-indexed breakdown for one sitemap	Site URL, sitemap URL
submit_sitemap	Submit a new sitemap	Site URL, sitemap URL
delete_sitemap	Remove a sitemap (disabled by default)	Site URL, sitemap URL
manage_sitemaps	Submit or delete sitemaps via one action tool	Site URL, action
reauthenticate	Re-run the OAuth browser login (switch accounts)	Nothing

Destructive tools (add_site, delete_site, delete_sitemap) are disabled by default — see Safety.

Tool usage examples

10 sample prompts, each exercising a different tool directly (no skill involved):

Tool	Sample Prompt
list_properties	"List all my GSC properties and tell me which ones I have full access to."
get_site_details	"Show me the verification and ownership details for example.com."
get_search_analytics	"Show me the top 20 search queries for mywebsite.com in the last 30 days, and highlight any with CTR below 2%."
get_performance_overview	"Give me a performance overview of mywebsite.com for the last 28 days, including the daily trend."
compare_search_periods	"Compare mywebsite.com's performance between January and February. What queries improved the most?"
get_search_by_page_query	"What search terms are driving traffic to mywebsite.com/pricing?"
get_advanced_search_analytics	"Show queries with high impressions but position below 10, filtered to mobile traffic in the US."
inspect_url_enhanced	"Do a full crawl and index inspection of mywebsite.com/landing-page."
batch_url_inspection	"Check the indexing status of these 5 pages: [list URLs]."
get_sitemaps	"List all sitemaps submitted for mywebsite.com and flag any with errors."

---

Available Skills

Skills are ready-made workflows that chain the tools above together. They're auto-loaded in Claude Code via .claude-plugin/plugin.json.

Core reports

Skill	What it does
seo-weekly-report	Full 28-day performance summary with period-over-period comparison and top queries
indexing-audit	Batch-inspects top pages and returns a prioritized indexing fix list
cannibalization-check	Finds queries where multiple pages compete; recommends which to consolidate
content-opportunities	Surfaces position 11–20 queries with high impressions and low CTR

Deeper analytics cuts

Skill	What it does
device-performance-split	Compares mobile vs desktop vs tablet performance, flags mobile-specific gaps
country-opportunities	Finds top and under-performing countries/markets
branded-vs-nonbranded	Splits branded vs non-branded queries to reveal true organic growth
new-vs-lost-queries	Finds queries that are brand-new or have completely disappeared, not just declined

Health & trend checks

Skill	What it does
content-decay-report	Finds pages on a 90-day gradual traffic decline — refresh candidates
sitemap-health-check	Audits sitemap errors/warnings and the submitted-vs-indexed gap
multi-property-comparison	Ranks and compares every property in the account side by side

Master audit

Skill	What it does
full-seo-audit	Runs indexing, sitemap, cannibalization, content-decay, and lost-query checks together, then cross-references the findings to point at root cause instead of listing symptoms in isolation

---

Getting Started

Full step-by-step walkthrough (Google Cloud credentials, install, and client config) is in SETUP.md.

Quick summary:

1. Get Google API credentials — OAuth client ID (recommended) or a service account key, from Google Cloud Console.
2. Clone this repo and install dependencies — this fork's extra skills only exist in this repo, so use the clone method, not the uvx/PyPI package (see note in SETUP.md).
3. Point your MCP client at it — Claude Code picks up .mcp.json automatically at the project root; see SETUP.md for Claude Desktop / Cursor configs.
4. Test — ask your assistant "List my GSC properties." If you see your properties, it's working.

---

Environment Variables Reference

Variable	Required	Default	Description
GSC_OAUTH_CLIENT_SECRETS_FILE	OAuth only	—	Absolute path to your OAuth client secrets JSON
GSC_CREDENTIALS_PATH	Service account only	—	Absolute path to your service account JSON key
GSC_SKIP_OAUTH	No	false	Set to "true" to force service account auth and skip OAuth entirely
GSC_DATA_STATE	No	"all"	"all" matches the GSC dashboard. "final" returns only confirmed data (2–3 day lag)
GSC_ALLOW_DESTRUCTIVE	No	false	Set to "true" to enable add_site / delete_site / delete_sitemap

---

Skill Usage Examples

10 sample prompts that trigger the bundled skills (chained tool workflows) instead of a single tool:

Goal	Sample Prompt
Weekly report	"Run the SEO weekly report for example.com"
Full audit	"Run a full SEO audit on example.com"
Cannibalization	"Check for keyword cannibalization on example.com"
Indexing	"Audit indexing for my top pages"
Content ideas	"Find content opportunities for example.com"
Mobile vs desktop	"Compare mobile and desktop performance for example.com"
Lost visibility	"Show me new and lost queries for example.com this month"
Content decay	"Which pages on example.com are losing traffic gradually?"
Sitemap health	"Check sitemap health for example.com"
Multi-site	"Compare performance across all my GSC properties"

---

Safety: Destructive Operations

By default, add_site, delete_site, and delete_sitemap are disabled. To enable them, set:

"GSC_ALLOW_DESTRUCTIVE": "true"

---

Troubleshooting

See the Troubleshooting section in SETUP.md for spawn ENOENT errors, auth failures, and client-specific config issues.

---

License

MIT License — see LICENSE.