mcp-seo-auditor
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-seo-auditor audit the SEO of https://example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-seo-auditor
Built by Artur Ferreira @ The GEO Lab Β· π @TheGEO_Lab Β· LinkedIn Β· Reddit
MCP server for on-page SEO auditing and JSON-LD schema validation. Replaces SEO Minion + Detailed SEO Extension as Claude Code tools.
Tools
Tool | Description |
| Full on-page SEO audit β title, meta, H1-H6, canonical, OG, Twitter, links, images, word count. Each element scored green/yellow/red |
| Extract and validate all JSON-LD blocks β type-specific checks for Article, FAQPage, Product, HowTo, BreadcrumbList, Person |
| Heading hierarchy analysis β missing H1, multiple H1s, skipped levels |
| Image audit β alt text coverage, empty alts, lazy loading, missing dimensions |
Related MCP server: seo-gaca-mcp
Features
β GEO-native β built alongside the GEO Brand Citation Index, tracking brand visibility across ChatGPT, Perplexity, and Gemini
Install
# Claude Code
claude mcp add seo-auditor -- npx mcp-seo-auditor
# Or in .mcp.json
{
"mcpServers": {
"seo-auditor": {
"command": "npx",
"args": ["mcp-seo-auditor"]
}
}
}Usage
Once installed, Claude Code can:
> audit the SEO of https://example.com
> validate the schema markup on https://thegeolab.net/geo-stack/
> check the heading hierarchy on this page
> audit images for alt text coverageNo API Keys Required
This server fetches pages directly β no external API keys needed.
Attributions & Licence
Built and maintained by Artur Ferreira @ The GEO Lab.
Email: artur@thegeolab.net
Best Practice Attribution
This MCP server was built following the open source Best Practice Approach β reading community work for inspiration, then writing original content, and crediting every source.
Based on:
Model Context Protocol specification by Anthropic
MCP SDK (MIT)
SEO audit logic inspired by:
Detailed SEO Extension β browser-based page-level SEO insights
SEO Minion β on-page SEO analysis extension
Screaming Frog SEO Spider β deep site audit methodology
Dependencies:
All server code is original writing. No files were copied or adapted from any source. MIT licence.
Found this useful? β Star the repo and connect: π thegeolab.net Β· π @TheGEO_Lab Β· LinkedIn Β· Reddit
Related Repos
claude-code-mcps β All 5 MCP servers in one collection
mcp-seo-auditor β On-page SEO audit + JSON-LD validation
mcp-serp-intel β SERP weak spots, PAA trees, intent comparison
mcp-common-crawl β Free backlink discovery via Common Crawl
mcp-gsc-advanced β GSC cannibalization, rank changes
mcp-wordpress-setup β WordPress MCP server setup guide
Licence
MIT β see LICENSE
Built and maintained by Artur Ferreira @ The GEO Lab Β· MIT License
Available Tools
4 toolsaudit_imagesA
Audit all images on a page β alt text coverage, missing alt attributes, oversized images, lazy loading status.
Inputs: url (required).
audit_pageA
Full on-page SEO audit β title, meta description, H1-H6 hierarchy, canonical, OG tags, Twitter cards, internal/external links, image alt coverage, word count, robots meta. Each element scored green/yellow/red.
Inputs: url (required).
check_headingsA
Extract and analyze heading hierarchy (H1-H6) from a page. Checks for missing H1, multiple H1s, skipped levels, heading-to-content ratio.
Inputs: url (required).
validate_schemaA
Extract and validate all JSON-LD schema blocks on a page. Type-specific validation for Article, FAQPage, Product, HowTo, BreadcrumbList, Person, Organization.
Inputs: url (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 4 tools
audit_page is a comprehensive audit that already includes heading hierarchy and image alt text, overlapping significantly with check_headings and audit_images. While the specific tools provide more detail, the boundaries are not crisp, and an agent could be uncertain which tool to invoke for a headings-only or images-only check.
All tool names follow a consistent verb_noun pattern (audit_page, validate_schema, check_headings, audit_images), using lowercase with underscores. Verbs are semantically apt for each action, and there are no mixed conventions.
The server provides 4 tools, which is within the ideal 3-15 range for a focused SEO auditing tool. Each tool handles a distinct aspect of SEO analysis without excessive redundancy or overwhelming breadth.
The tool set covers the main on-page SEO dimensionsβmeta tags, headings, schema, imagesβbut lacks common SEO audit features like page speed, mobile-friendliness, or sitemap/robots.txt validation. For a single-page auditor, the coverage is solid but not exhaustive.
Maintenance
Related MCP Connectors
Free MCP server that audits any public URL: technical SEO, Core Web Vitals, indexing checks.
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
SEO MCP server for keyword research, live SERPs, backlinks, site audits and AI visibility.
Remote MCP server for Google SERP, SEO research and web scraping. Free plan, no card.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA production-ready remote MCP server that performs comprehensive SEO audits, providing structured insights on on-page SEO, technical health, and social metadata without requiring local setup.30-
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server for SEO, performance, GEO, and UX audits with 37 tools covering technical SEO, Lighthouse performance, AI search optimization, content analysis, accessibility, security, and more.1MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides a suite of SEO analysis tools for auditing meta tags, headings, links, keyword density, page speed, and sitemaps without requiring external API keys.61MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server for SEO auditing that performs technical SEO, content quality, Schema.org, sitemap, hreflang, and GEO checks, returning scores and prioritized fixes.MIT