mcp-seo-audit
About
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.
Details
- Author
- giorgikemo
- Categories
- Search, Other
Jump to
Setup
Install mcp-seo-audit in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/giorgikemo/mcp-seo-audit
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server for SEO auditing with Google Search Console, Indexing API, Chrome UX Report, PageSpeed Insights, local Lighthouse, robots.txt checks, sitemap analysis, on-page SEO inspection, crawl audits, and live site analysis. Works with Claude Code, Claude Desktop, Cursor, and any MCP-compatible client.
Forked fromAminForou/mcp-gscand expanded into a broader technical SEO and performance audit server with 30 tools and a full test suite.
- Go toGoogle Cloud Console
- Enable theSearch Console APIandWeb Search Indexing API
- Create anOAuth 2.0 Client ID(Desktop app)
- Downloadclient_secrets.json
- Create a service account in Google Cloud Console
- Download the JSON key file
- Add the service account email to your GSC properties
MCP clients can run the PyPI package directly:
git clone https://github.com/GiorgiKemo/mcp-seo-audit.git cd mcp-seo-audit python -m venv .venv # Activate: # macOS/Linux: source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -r requirements.txt
{ "mcpServers": { "seo-audit": { "command": "uvx", "args": ["mcp-seo-audit"], "env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json", "PAGESPEED_API_KEY": "your-google-api-key", "CRUX_API_KEY": "your-google-api-key" } } } }
{ "mcpServers": { "seo-audit": { "command": "/path/to/mcp-seo-audit/.venv/bin/python", "args": ["/path/to/mcp-seo-audit/gsc_server.py"], "env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json", "PAGESPEED_API_KEY": "your-google-api-key", "CRUX_API_KEY": "your-google-api-key" } } } }
Claude Desktop (claude_desktop_config.json)
Same JSON structure — seeClaude Desktop MCP docsfor config file location.
For field and lab performance data, setCRUX_API_KEYandPAGESPEED_API_KEYin the env block:
"env": { "GSC_OAUTH_CLIENT_SECRETS_FILE": "/path/to/client_secrets.json", "CRUX_API_KEY": "your-google-api-key", "PAGESPEED_API_KEY": "your-google-api-key" }
You can also setGOOGLE_API_KEY; the server uses it as the PageSpeed Insights fallback key.
"List my GSC properties" "Show search analytics for cdljobscenter.com last 28 days" "Find striking distance keywords for my site" "Detect keyword cannibalization" "Run a full site audit" "Check Core Web Vitals for cdljobscenter.com" "Run PageSpeed Insights for https://example.com" "Run a local Lighthouse audit for https://example.com" "Inspect robots.txt for https://example.com" "Analyze https://example.com/sitemap.xml" "Analyze on-page SEO for https://example.com/jobs" "Crawl https://example.com and report duplicate titles" "Run a live SEO audit for https://example.com" "Inspect indexing status of these URLs: /jobs, /companies, /pricing" "Request indexing for https://mysite.com/new-page" "Compare search performance this month vs last month"
96 tests covering all 30 tools with mocked Google/API/web-audit calls:
# Activate venv first python -m pytest test_gsc_server.py -v
- 30 tools— added PSI, local Lighthouse, robots.txt inspection, sitemap validation, page SEO analysis, crawl audits, and live site audits
- Robustness fixes— OAuth scope alignment, sort direction mapping, origin/URL detection, sitemap BOM and plain-text handling, external redirect crawl guards, empty rows handling, API key redaction, service caching, and stale cache handling on reauth
- 96-test QA suite— coverage for GSC, CrUX, PSI, Lighthouse CLI, fallback behavior, robots, sitemaps, crawl audits, safety gates, auth scopes, and live-audit composition
- Security— private/local network fetches blocked by default, mutating Google tools gated behind an explicit env flag, and API keys redacted from error messages
- Performance— Google API service objects cached, async sleep instead of blocking, async CrUX HTTP calls, PSI-to-Lighthouse fallback, plus lab-performance tooling on top of CrUX field data
- Audit quality— local-preview aware canonical warnings, visible-content parsing that ignoresnoscriptduplicates, severity-ranked SEO findings, image alt audits, crawlable-link checks, invalid JSON-LD detection, viewport/lang checks, and stricter canonical/robots diagnostics
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
An MCP server for accessing Google Search Console data, including site performance and indexing status.
Read-only MCP server for Google Search Console: search analytics, URL inspection, and sitemaps
Google Search Console MCP for Claude Code
Google Search Console MCP for Claude Code & Cursor with built-in SEO intelligence: traffic-drop diagnosis, quick wins, content decay, cannibalization, ranking alerts. Read-only by default, with anti-hallucination provenance metadata on every response.
A Model Context Protocol (MCP) server providing access to Google Search Console & Google analytics
The SEO Review Tools MCP gives you direct access to our SEO API
Connect Google Search Console to Claude or ChatGPT via Two Minute Reports MCP. Analyze top-performing queries, pages, and SEO trends to grow search visibility.
Your AI assistant can query Search Console analytics
Multi-account Google Search Console MCP — analytics, URL inspection, sitemaps across named accounts.
SEO + GEO MCP server: live Google Search Console & GA4 data, keyword/page analysis and SEO tasks from chat.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



