mcp-gsc-advanced
Provides tools for detecting keyword cannibalization, analyzing page-level queries, and tracking rank changes in Google Search Console.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-gsc-advanced detect keyword cannibalization on my site"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-gsc-advanced
Built by Artur Ferreira @ The GEO Lab · 𝕏 @TheGEO_Lab · LinkedIn · Reddit
MCP server for advanced Google Search Console analysis — keyword cannibalization detection, page-level query deep dive, and rank change tracking.
Extends basic GSC data into actionable SEO intelligence.
Tools
Tool | Description |
| Find queries where 2+ pages compete — severity scoring, impressions split, consolidation recommendations |
| All queries driving traffic to a specific page — sorted by impressions with CTR and position |
| Period-over-period position changes — finds significant gains and losses |
Related MCP server: gsc-mcp
Features
✅ GEO-native — built alongside the GEO Brand Citation Index, tracking brand visibility across ChatGPT, Perplexity, and Gemini
Install
# Claude Code (service account key file)
claude mcp add gsc-advanced \
-e GOOGLE_SERVICE_ACCOUNT_KEY=/path/to/service-account.json \
-e GSC_SITE_URL=https://yoursite.com/ \
-- npx mcp-gsc-advanced
# Or in .mcp.json
{
"mcpServers": {
"gsc-advanced": {
"command": "npx",
"args": ["mcp-gsc-advanced"],
"env": {
"GOOGLE_SERVICE_ACCOUNT_KEY": "/path/to/service-account.json",
"GSC_SITE_URL": "https://yoursite.com/"
}
}
}
}Authentication
Requires a Google service account with Search Console access.
Option A: Set GOOGLE_SERVICE_ACCOUNT_KEY to the path of your service account JSON file.
Option B: Set GOOGLE_CLIENT_EMAIL and GOOGLE_PRIVATE_KEY env vars directly.
Then add the service account email as a Full user in Google Search Console.
Usage
> detect keyword cannibalization on my site
> what queries drive traffic to /geo-stack/ page?
> show rank changes in the last 7 daysAttributions & Licence
Built and maintained by Artur Ferreira @ The GEO Lab.
Email: artur@thegeolab.net
Best Practice Attribution
This MCP server was built following the open source Best Practice Approach — reading community work for inspiration, then writing original content, and crediting every source.
Based on:
Model Context Protocol specification by Anthropic
MCP SDK (MIT)
GSC analysis concepts inspired by:
Google Search Console API — official documentation
Aleyda Solís — GSC cannibalization detection methodology
Kevin Indig / Growth Memo — GSC query analysis for AI search
Dependencies:
googleapis — Google APIs Node.js client (Apache 2.0)
All server code is original writing. No files were copied or adapted from any source. MIT licence.
Found this useful? ⭐ Star the repo and connect: 🌐 thegeolab.net · 𝕏 @TheGEO_Lab · LinkedIn · Reddit
Related Repos
claude-code-mcps — All 5 MCP servers in one collection
mcp-seo-auditor — On-page SEO audit + JSON-LD validation
mcp-serp-intel — SERP weak spots, PAA trees, intent comparison
mcp-common-crawl — Free backlink discovery via Common Crawl
mcp-gsc-advanced — GSC cannibalization, rank changes
mcp-wordpress-setup — WordPress MCP server setup guide
Licence
MIT — see LICENSE
Built and maintained by Artur Ferreira @ The GEO Lab · MIT License
Available Tools
3 toolsdetect_cannibalizationA
Detect keyword cannibalization — finds queries where 2+ pages compete for the same keyword. Shows impressions split, severity (Critical/Warning/Minor), and recommends which page to keep.
Inputs: site_url, days.
page_queriesA
Get all GSC queries driving traffic to a specific page — sorted by impressions. Shows clicks, CTR, position for each query.
Inputs: page_url (required), days.
rank_changesB
Compare position changes between two periods. Finds queries that gained or lost significant positions.
Inputs: site_url, days.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct function: detect_cannibalization finds competing pages, page_queries lists queries for a page, rank_changes compares period positions. No overlap in purpose.
All names use snake_case with two tokens, but detect_cannibalization is verb_noun while page_queries and rank_changes are noun_verb. Still clear and predictable.
Three tools is reasonable for an advanced GSC server focused on keyword analysis. It covers core needs without being too sparse or cluttered.
The set covers key SEO analysis tasks (cannibalization, page queries, rank changes). Minor gaps like aggregate search analytics or filtering are acceptable given the specialized scope.
Maintenance
Related MCP Connectors
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
Google Search Console, GA4 and PageSpeed MCP server for Claude, ChatGPT and Cursor. Free, hosted.
SEO MCP: Search Console, GA4, SERP and domain data, rank tracking, AI citations and site fixes.
Related MCP Servers
- AlicenseBqualityBmaintenanceSEO audit and Google Search Console MCP server with 23 tools. Search analytics, URL inspection, Indexing API, Core Web Vitals (CrUX), striking distance keywords, keyword cannibalization detection, branded query analysis, and automated site audits.433MIT
- AlicenseAqualityBmaintenanceMCP server for Google Search Console, URL Inspection & Indexing API — search analytics, sitemap management, and batch indexing13149 npm8MIT
- AlicenseBqualityDmaintenanceProfessional Google Search Console MCP server providing 40+ SEO tools for performance analysis, content decay, CTR opportunities, and more, enabling real search data in clients like Cursor and Claude.4013 npm6MIT
- AlicenseCqualityDmaintenanceAn SEO analysis MCP server integrating Google Search Console, Bing Webmaster Tools, and GA4 with custom grain analysis tools for content decay, traffic drops, CTR benchmarking, and actionable recommendations.1001MIT