Skip to main content
Glama
mcp-gsc-advanced

mcp-gsc-advanced

by arturseo-geo

mcp-gsc-advanced

Built by Artur Ferreira @ The GEO Lab · 𝕏 @TheGEO_Lab · LinkedIn · Reddit

Version Licence Claude Code

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

detect_cannibalization

Find queries where 2+ pages compete — severity scoring, impressions split, consolidation recommendations

page_queries

All queries driving traffic to a specific page — sorted by impressions with CTR and position

rank_changes

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 days

Attributions & 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:

GSC analysis concepts inspired by:

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

Licence

MIT — see LICENSE


Built and maintained by Artur Ferreira @ The GEO Lab · MIT License

Available Tools

3 tools
detect_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

    A3.6/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    Three tools is reasonable for an advanced GSC server focused on keyword analysis. It covers core needs without being too sparse or cluttered.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      SEO 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.
      43
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Google Search Console, URL Inspection & Indexing API — search analytics, sitemap management, and batch indexing
      13
      149 npm
      8
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Professional 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.
      40
      13 npm
      6
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      An 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.
      100
      1
      MIT