Search Console Mcp

by saurabhsharma2u

205 stars

825 downloads

Not rated

GitHub Website

Search
Other

About

Search & analytics data as infrastructure — MCP server for Google Search Console, Bing Webmaster Tools, and GA4, designed for AI agents and automation.

Details

Author: saurabhsharma2u
GitHub stars: 205
Downloads: 825
Categories: Search, Other

- Combined data from Google Search Console, Bing, and GA4 in one window
- Deterministic SEO math (cannibalization detection, Z‑score anomalies, striking distance)
- Zero‑config multi‑account support (20+ accounts, automatic credential resolution)
- Secure authentication using OS keychain and AES‑256‑GCM encryption
- Opinionated tools for opportunity scoring, traffic drop attribution, and brand vs. non‑brand analysis
- Low‑level SEO primitives that agents can chain for custom logic

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Search Console Mcp

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

From the repository

Install globally via npm, then run npx search-console-mcp setup to initiate a secure desktop authorization flow. Connect one or multiple Google, Bing, and GA4 accounts. After setup, use any MCP‑compatible client (e.g., Claude Desktop) to invoke the server’s tools using natural‑language prompts or direct tool calls.

`get_started`

Start here. Returns a complete map of this server's capabilities, active platforms, and recommended workflows. Call this once at the beginning of any session.

`sites_list`

List verified web properties across Google Search Console, Bing Webmaster Tools, or GA4.

`sites_manage`

Add or delete a web property from Google Search Console or Bing Webmaster Tools.

`accounts_manage`

Manage Google Search Console service accounts and site permissions.

`sitemaps_list`

List submitted XML sitemaps and status for a site.

`sitemaps_submit`

Submit a new XML sitemap to Google Search Console and/or Bing Webmaster Tools.

`sitemaps_delete`

Delete a sitemap from Google Search Console or Bing Webmaster Tools.

`analytics_query`

Unified search performance query replacing single-dimension tools. Supports queries, pages, countries, devices, and search appearances.

`analytics_compare`

Period-over-period search performance comparisons, trends, and traffic drop attributions.

`analytics_anomalies`

Detect search traffic anomalies across Google and Bing.

`analytics_advanced`

Google Analytics 4 (GA4) e-commerce, realtime metrics, user behavior, and conversion funnels.

`inspection_inspect`

Inspect indexing, canonical, and crawl status for single or batch URLs on Google or Bing.

`pagespeed_analyze`

Run PageSpeed Insights & Core Web Vitals performance analysis for a page.

`indexing_submit`

Submit URL(s) for indexing via Google Indexing API, Bing URL submission, or IndexNow protocol.

`indexing_status`

Check notification status for Google Indexing API or remaining daily Bing submission quota.

`seo_audit`

Specialized SEO intelligence analysis (recommendations, quick wins, cannibalization, striking distance, lost queries, low CTR, brand vs nonbrand).

`seo_keywords_research`

Keyword performance stats, related query expansion, and search volume estimates.

`schema_validate`

Validate structured data (JSON-LD, Microdata, RDFa) for a given webpage URL.

`site_health_check`

Comprehensive health audit across Google Search Console and Bing Webmaster Tools.

`compare_engines`

Cross-engine performance matrix comparing Google Search Console vs Bing Webmaster Tools.

`diagnostics`

Run connectivity diagnostics for all connected accounts. Use this to troubleshoot '0 results' or authentication issues.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "search console mcp": {
            "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"
                }
            }
        }
    }
}

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"
        }
    }
}

Search Console MCP

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

📚 View Documentation

---

Why use this?

❌ The Old, Broken Way

Data Silos: Manually checking Google, then Bing, then GA4. Manual Correlation: Exporting 3 different CSVs and using VLOOKUPs to see if your #1 ranking page actually converts. Switching Fatigue: Logging in and out to manage multiple clients or properties. AI Context Limits: Uploading giant spreadsheets that hit context limits and cause model hallucinations.

✅ The Search Console MCP Way

Platform Synergy: GSC + Bing + GA4 in a single context window. Stop exporting, start analyzing. Deterministic Intelligence: The server performs the complex SEO math (cannibalization, Z-score anomalies, striking distance) so your AI agent gets curated insights, not raw data piles. Cross-Platform ROI: Use the Opportunity Matrix to prioritize keywords that have high search visibility (GSC) but poor on-site engagement (GA4). Zero-Config Multi-Account: Connect 20+ accounts. The server automatically resolves the correct credentials for every site URL.

One Server. Three Platforms. Infinite Accounts. Actionable Intelligence.

---

🎯 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?"

🔀 Multi-Engine Comparison

> "Compare my performance between Google and Bing for the last 30 days. Which keywords are ranking better on Bing but have lower traffic on Google?"

🎯 Bing Opportunity Finder

> "Show me keywords where I'm in the top 5 on Google but not ranking on Bing. These are my easy Bing wins."

⚠️ Google Dependency Check

> "Am I too dependent on Google? Check my click share across both engines and flag any keywords where over 85% of traffic comes from Google."

💰 The ROI Prioritizer (GSC + GA4)

> "Run an opportunity_matrix for my top 20 pages. Which high-visibility pages have the lowest engagement or conversion rates? These are my conversion optimization priorities."

---

🔐 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: Connect multiple Google and Bing accounts. The server automatically picks the right one for each site.
- 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.

🚀 Step 1 — Initiate Login

Run the following command to start the authorization process:

npx search-console-mcp setup

The CLI will:
1. Briefly start a secure local server to handle the redirect.
2. Open your default web browser to the Google Authorization page.
3. 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: ```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_started

sites_list

sites_manage

accounts_manage

sitemaps_list

sitemaps_submit

sitemaps_delete

analytics_query

analytics_compare

analytics_anomalies

analytics_advanced

inspection_inspect

pagespeed_analyze

indexing_submit

indexing_status

seo_audit

seo_keywords_research

schema_validate

site_health_check

compare_engines

diagnostics

Claude Desktop / Cursor

McpServers

Search Console MCP

Why use this?

❌ The Old, Broken Way

✅ The Search Console MCP Way

🎯 Magic Prompts

🔍 The Traffic Detective

🎯 The "Striking Distance" Hunter

⚔️ The Cannibalization Cleaner

📈 The SEO Opportunity Scoreboard

📊 The Executive Health Check

⚡ The Speed vs. Ranking Correlator

🔀 Multi-Engine Comparison

🎯 Bing Opportunity Finder

⚠️ Google Dependency Check

💰 The ROI Prioritizer (GSC + GA4)

🔐 Authentication (Desktop Flow)

🚀 Step 1 — Initiate Login

🔑 Step 2 — Logout & Management

Install

More like this

Sequential Thinking

Brave Search

Filesystem

EverArt

Google Drive

Reactive Resume

`get_started`

`sites_list`

`sites_manage`

`accounts_manage`

`sitemaps_list`

`sitemaps_submit`

`sitemaps_delete`

`analytics_query`

`analytics_compare`

`analytics_anomalies`

`analytics_advanced`

`inspection_inspect`

`pagespeed_analyze`

`indexing_submit`

`indexing_status`

`seo_audit`

`seo_keywords_research`

`schema_validate`

`site_health_check`

`compare_engines`

`diagnostics`