Search Console Mcp

Created By

saurabhsharma2ua month ago

Search Console MCP is an open-source implementation of the Model Context Protocol that gives AI agents direct, structured access to Google Search Console (GSC). Unlike simple API wrappers, this project focuses on providing SEO Intelligence Tools. Instead of just asking an agent to “look at my data,” you can give it tools to “find quick wins” or “detect traffic anomalies.”

# google search

# google search console

Overview Content Tools Comments

Overview

Google Search Console MCP Server

A Model Context Protocol (MCP) server that transforms how you interact with Google Search Console. Stop exporting CSVs and start asking questions.

📚 View Documentation

Why use this?

❌ The Old Way

Open Search Console -> Performance Tab
Filter by "Last 28 days"
Export to CSV
Open in Excel/Sheets
Create a filter for "Position > 10" AND "Impressions > 1000"
Analyze manually to find opportunities

✅ The New Way

Just ask:

"Find low-hanging fruit keywords (positions 11-20) with high impressions that I should optimize."

🎯 Magic Prompts

Copy and paste these into your MCP client (Claude Desktop, etc.) to see the intelligence engine in action:

�️ The Traffic Detective

"My traffic dropped this week compared to last. Use the anomaly detection and time-series tools to find exactly when the drop started and which pages are responsible."

🎯 The "Striking Distance" Hunter

"Find keywords for https://example.com where I'm ranking in positions 8-15 but have at least 1,000 impressions. These are my best opportunities for a quick traffic boost."

⚔️ The Cannibalization Cleaner

"Check for keyword cannibalization. Are there any queries where two or more of my pages are competing and splitting the traffic? Suggest which one should be the primary authority."

📈 The SEO Opportunity Scoreboard

"Analyze my top 50 keywords for the last 90 days. Rank them by a custom 'Opportunity Score' (Impressions / Position). Give me the top 5 specific pages to focus on."

📊 The Executive Health Check

"Run a full SEO health check for my site. Segment the results by Brand vs. Non-Brand and give me 3 high-impact actions for the upcoming week."

⚡ The Speed vs. Ranking Correlator

"Fetch the top 5 pages by impressions. For these pages, run a PageSpeed audit. Is there any correlation between low performance scores and recently declining positions?"

🔐 Authentication (Desktop Flow)

Search Console MCP uses a Secure Desktop Flow. This provides high-security, professional grade authentication for your Google account:

Multi-Account Support: Automatically detects and stores separate tokens for different Google accounts based on your email.
System Keychain Primary: Tokens are stored in your OS's native credential manager (macOS Keychain, Windows Credential Manager, or Linux Secret Service).
AES-256-GCM Hardware-Bound Encryption: Fallback storage is encrypted with AES-256-GCM using a key derived from your unique hardware machine ID. Tokens stolen from your machine cannot be decrypted on another computer.
Silent Background Refresh: Tokens auto-refresh silently when they expire.

Run the following command to start the authorization process:

npx search-console-mcp setup

The CLI will:

Briefly start a secure local server to handle the redirect.
Open your default web browser to the Google Authorization page.
Automatically fetch your email after authorization to label your credentials securely.

🔑 Step 2 — Logout & Management

To wipe your credentials from both the keychain and the disk:

# Logout of the default account
npx search-console-mcp logout

# Logout of a specific account
npx search-console-mcp logout user@gmail.com

🔑 Alternative: Service Account (Advanced)

For server-side environments or automated tasks where interactive login isn't possible, you can use a Google Cloud Service Account.

Setup:

Create Service Account: Go to the Google Cloud Console and create a service account.
Generate Key: Click "Keys" > "Add Key" > "Create new key" (JSON). Download this file.
Share Access: In Google Search Console, add the service account's email address (e.g., account@project.iam.gserviceaccount.com) as a user with at least "Full" or "Restricted" permissions.

Configure: Point the server to your key file:

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/key.json"

🛡️ Fort Knox Security

This MCP server implements a multi-layered security architecture:

Keychain Integration: Primarily uses the macOS Keychain, Windows Credential Manager, or libsecret (Linux) to store tokens.
Hardware-Bound Vault: Fallback tokens are stored in ~/.search-console-mcp-tokens.enc and encrypted with AES-256-GCM.
Machine Fingerprinting: The encryption key is derived from your unique hardware UUID and OS user. The encrypted file is useless if moved to another machine.
Minimalist Storage: Only the refresh_token and expiry_date are stored.
Strict Unix Permissions: The fallback file is created with mode 600 (read/write only by your user).

Tools Reference

Analytics

Tool	Description
`analytics_query`	Master tool for raw data. Supports `dimensions`, `filters`, `aggregationType` (byPage/byProperty), `dataState` (final/all), and `type` (web/image/news/discover).
`analytics_trends`	Detect trends (rising/falling) for specific queries or pages.
`analytics_anomalies`	Detect statistical anomalies in daily traffic.
`analytics_drop_attribution`	[NEW] Attribute traffic drops to mobile/desktop or correlate with known Google Algorithm Updates.
`analytics_time_series`	[NEW] Advanced time series with rolling averages, seasonality detection, and forecasting.
`analytics_compare_periods`	Compare two date ranges (e.g., WoW, MoM).
`seo_brand_vs_nonbrand`	[NEW] Analyze performance split between Brand vs Non-Brand traffic.

SEO Opportunities (Opinionated)

Tool	Description
`seo_low_hanging_fruit`	Find keywords ranking in pos 5-20 with high impressions.
`seo_striking_distance`	[NEW] Find keywords ranking 8-15 (Quickest ROI wins).
`seo_low_ctr_opportunities`	[NEW] Find top ranking queries (pos 1-10) with poor CTR.
`seo_cannibalization`	[Enhanced] Detect pages competing for the same query with traffic conflict.
`seo_lost_queries`	[NEW] Identify queries that lost all traffic in the last 28 days.

SEO Primitives (Atoms for Agents)

These are low-level tools designed to be used by other AI agents to build complex logic.

Tool	Description
`seo_primitive_ranking_bucket`	Categorize a position (e.g. "Top 3", "Page 1", "Unranked").
`seo_primitive_traffic_delta`	Calculate absolute and % change between two numbers.
`seo_primitive_is_brand`	Check if a query matches a brand regex.
`seo_primitive_is_cannibalized`	Check if two pages are competing for the same query.

Sites & Sitemaps

Tool	Description
`sites_list`	List all verified sites.
`sites_add` / `sites_delete`	Manage properties.
`sites_health_check`	[NEW] Run a health check on one or all sites. Checks WoW performance, sitemaps, and anomalies.
`sitemaps_list` / `sitemaps_submit`	Manage sitemaps.

Inspection & Validation

Tool	Description
`inspection_inspect`	Google URL Inspection API (Index status, mobile usability).
`pagespeed_analyze`	Lighthouse scores & Core Web Vitals.
`schema_validate`	Validate Structured Data (JSON-LD).

License

MIT Contributing

Server Config

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": [
        "-y",
        "search-console-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account.json",
        "BING_API_KEY": "YOUR_BING_API_KEY"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Tavily Mcp

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

Amap Maps高德地图官方 MCP Server

MCP AdvisorMCP Advisor & Installation - Use the right MCP server for your needs

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

Howtocook Mcp基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

Jina AI MCP ToolsA Model Context Protocol (MCP) server that integrates with Jina AI Search Foundation APIs.