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.8.0.tar.gz (18.7 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.8.0-py3-none-any.whl (29.1 kB view details)

Uploaded Python 3

File details

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

File metadata

File hashes

Hashes for google_search_console_mcp-0.8.0.tar.gz
Algorithm Hash digest
SHA256 d4282a92e0fab713c4347f2d4c9436c7074a9ccc77c0772c4f0bad8cced3c897
MD5 744f63ea946f31250ba083bbae1b7009
BLAKE2b-256 80da4d8095377811590c58024f100ec834afd16e83babbfebe604a1caf6f7840

See more details on using hashes here.

Provenance

The following attestation bundles were made for google_search_console_mcp-0.8.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.8.0-py3-none-any.whl.

File metadata

File hashes

Hashes for google_search_console_mcp-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6b373905c5a31e5c0d98942d20041ecf80fefff7d5b05b0c9b3512b3033d8fbd
MD5 a03c2015475dbf27295c295cbd1c0b27
BLAKE2b-256 4624401b1a1a46923ab5a035e8010f9b888cfd26fb4e70683aa328ba178f910d

See more details on using hashes here.

Provenance

The following attestation bundles were made for google_search_console_mcp-0.8.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