Google Search Console MCP Logo

Google Search Console MCP "Intel Engine" 🚀

PyPI version PyPI Downloads GitHub stars GitHub forks License: MIT

The Authority-Based Visibility Governance Tool for the Evolving Search Landscape.

This is not just a data wrapper. It is a strategic "Intel" engine that transforms raw Google Search Console signals into actionable marketing insights. It is designed for marketers who need to understand their performance in a search landscape increasingly defined by AI Overviews and conversational search. Compatible with any MCP-compliant AI Agent.

PyPI Downloads Breakdown and Trend
Analytics powered by pypi.builditwithai.xyz

🎯 Authoritative "Intel" Tools

Tool Name Actionable Marketing Intel Provided
get_search_appearance_audit Cannibalization Intel. Detects if you are being used as a "Silent Reference" (high visibility but no clicks) in specialized SERP features.
get_intent_segmentation Strategic Audience Intel. Segments traffic into "Searchers" (Traditional Keywords) vs. "Prompters" (Natural Language/AI Prompts).
identify_citation_opportunities Growth Intel. Finds content that satisfies user intent so well that users don't click. Recommends "Click-Triggers."
get_technical_citation_audit Technical Health Overlay. Cross-checks high-visibility pages with the URL Inspection API to find disqualifying crawl errors.
get_brand_visibility_summary Brand Health Intel. Measures your Brand's "Reference Value" vs its "Destination Value."
calculate_intent_efficiency Conversion Intel. Shows which search intent (Informational/Navigational) is most effectively driving site visits.

🚀 Getting Started

1. Google Search Console Setup

Before installing the MCP server, you must configure Google Cloud and Search Console access:

A. Create Service Account:

  1. Go to the Google Cloud Console.
  2. Create a new project and enable the Google Search Console API.
  3. Go to APIs & Services > Credentials and create a Service Account.
  4. Create a JSON Key for the service account and download it (save as gsc-key.json).

B. Grant Access in Search Console:

  1. Open your JSON key file and copy the client_email address.
  2. Go to Google Search Console.
  3. Select your property and go to Settings > Users and Permissions.
  4. Click Add User, paste the service account email, and select Full permissions.

C. Identify Your Property URL:

  • For Domain properties, use the format: sc-domain:example.com
  • For URL-prefix properties, use the full URL: https://example.com/

2. Installation

pip install google-search-console-mcp

3. Configuration (Universal AI Agent)

Add this to your agent's MCP settings file:

{
  "mcpServers": {
    "gsc-search": {
      "command": "gsc-mcp",
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/gsc-key.json",
        "GSC_SITE_URL": "sc-domain:example.com"
      }
    }
  }
}

🛠️ Project Philosophy

This project focuses on high-leverage data analysis for modern search:

  • Simplicity First: Minimum code for maximum insight.
  • Token Efficiency: Server-side aggregation prevents "Context Length" issues.
  • Authoritative Data: We only use official Google Search Console API signals. No speculative "AI SEO" hacks.

Telemetry & Privacy

This server sends anonymous usage telemetry (server version, OS, Python version, MCP client name, tool name, latency, error category) to help improve it. It never collects PII, your Search Console data, credentials, or file paths. Opt out any time by setting DISABLE_TELEMETRY=1, DO_NOT_TRACK=1, NO_TELEMETRY=1, or GSC_MCP_TELEMETRY=false.

License

MIT License

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.10.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for surendranb from gravatar.com surendranb

Credits

Author: Surendran B

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

google_search_console_mcp-0.9.0.tar.gz (18.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

google_search_console_mcp-0.9.0-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file google_search_console_mcp-0.9.0.tar.gz.

File metadata

File hashes

Hashes for google_search_console_mcp-0.9.0.tar.gz
Algorithm Hash digest
SHA256 1a2f76c1bc66380471dad61f6c4934f0599cb37716538f216cd49895e628ffe1
MD5 9b6c3c043ba39658267d606344db87f0
BLAKE2b-256 311b108168f5e4ddb77ed1221416b6d3c3cba8f9637fc46b3ed3ffd0d10eba87

See more details on using hashes here.

Provenance

The following attestation bundles were made for google_search_console_mcp-0.9.0.tar.gz:

Publisher: publish.yml on surendranb/google-search-console-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file google_search_console_mcp-0.9.0-py3-none-any.whl.

File metadata

File hashes

Hashes for google_search_console_mcp-0.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7f0f3f08f763be69fd85b10463a1b993f660cb74bdd454d325dd720155768100
MD5 f49b604ce9b96a9a72d95fc15990c2d4
BLAKE2b-256 75741134fb425a07279cc52bc4f47452b566c45628ae53758525bc9549f4f981

See more details on using hashes here.

Provenance

The following attestation bundles were made for google_search_console_mcp-0.9.0-py3-none-any.whl:

Publisher: publish.yml on surendranb/google-search-console-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page