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., "@SEO Check MCP scan 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.
A Model Context Protocol (MCP) server that provides comprehensive SEO analysis tools with actionable fix instructions for AI assistants like Claude Code and Claude Desktop.
24 SEO Analysis & Fix Tools
Actionable Instructions for Claude Code to apply fixes directly
Dual Transport Support: HTTP (Claude Code) and stdio (Claude Desktop)
Headless Chrome via Selenium for screenshots and Core Web Vitals
Related MCP server: FetchSERP MCP Server
Bun runtime
Chrome/Chromium browser (for screenshot tools)
git clone git@github.com:muningis/seo-check-mcp.git
cd seo-check-mcp
bun installClaude Code supports HTTP-based MCP servers:
bun server.mtsAdd to your project's .mcp.json:
{
"mcpServers": {
"seo-analysis": {
"url": "http://localhost:3000/mcp"
}
}
}Or add to your global ~/.claude/settings.json:
{
"mcpServers": {
"seo-analysis": {
"url": "http://localhost:3000/mcp"
}
}
}The 24 SEO tools will be available in Claude Code automatically.
Add to your claude_desktop_config.json:
{
"mcpServers": {
"seo-analysis": {
"command": "bun",
"args": ["cli.mts"],
"cwd": "/path/to/seo-check-mcp"
}
}
}Replace /path/to/seo-check-mcp with the actual path to this project.
Tool | Description |
| Fetches and parses XML sitemaps |
| Fetches robots.txt content |
| Comprehensive page analysis with optional screenshots |
| Lightweight page scan (no WebDriver) |
Tool | Description |
| Keyword density, readability scores, content suggestions |
| Flesch-Kincaid, Gunning Fog, SMOG analysis |
Tool | Description |
| JSON-LD/Schema.org validation with @graph analysis and completeness scoring |
| Deep sitemap analysis (freshness, priorities) |
| Internal linking structure analysis |
| Broken link detection with status codes |
Tool | Description |
| Semantic HTML and ARIA accessibility analysis (WCAG 2.1 Level A) |
| Open Graph, Twitter Cards, and Facebook meta analysis with platform previews |
Tool | Description |
| Meta tag analysis with SERP preview |
| H1-H6 structure validation |
| Image SEO with alt text suggestions |
| URL structure and canonical analysis |
Tool | Description |
| Side-by-side SEO comparison |
| Overall SEO score with grades |
These tools return structured instructions that Claude Code can execute:
Tool | Returns |
| Title, description, canonical, Open Graph fixes with HTML snippets |
| Alt text fixes with suggested values and CSS selectors |
| Heading hierarchy fixes with before/after HTML |
| JSON-LD schema templates ready to add |
| Prioritized task list with recommended tools |
| SEO, readability, and structure improvements for local markdown files |
Use the generate-seo-tasks tool on https://example.comThe tool returns tasks sorted by priority (critical → low) with effort/impact ratings:
{
"url": "https://example.com",
"score": 62,
"tasks": [
{
"id": "meta-title-missing",
"description": "Add missing title tag",
"tool": "fix-meta",
"priority": "critical",
"effort": "low",
"impact": "high"
}
],
"quickWins": ["meta-title-missing", "meta-canonical"],
"summary": "SEO Score: 62/100. 1 critical issue(s) need immediate attention."
}Run fix-meta on https://example.com to get the HTML changes needed{
"url": "https://example.com",
"instructions": [
{
"action": "replace",
"target": { "type": "html-tag", "selector": "title" },
"value": {
"current": "<title>Home</title>",
"suggested": "<title>Example - Your Brand Name</title>"
},
"reason": "Title too short (4 chars). Should be 50-60 chars with keywords.",
"priority": "critical",
"automated": true
},
{
"action": "add",
"target": { "type": "html-tag", "selector": "head", "tagName": "link" },
"value": {
"suggested": "<link rel=\"canonical\" href=\"https://example.com\">"
},
"reason": "Missing canonical URL causes duplicate content issues.",
"priority": "high",
"automated": true
}
],
"summary": "2 fixes needed: 1 critical, 1 high priority"
}# Start HTTP server (for programmatic clients)
bun server.mts
# or
bun run start
# Start stdio server (for Claude Desktop)
bun cli.mts
# or
bun run start:stdio
# Health check (HTTP mode only)
curl http://localhost:3000/health
# Set custom port (HTTP mode only)
MCP_PORT=8080 bun server.mts
# Type check
npx tsc --noEmitEndpoint | Method | Description |
| GET | Health check, returns |
| POST/GET/DELETE | MCP Streamable HTTP transport endpoint |
server.mts # HTTP server (for programmatic clients)
cli.mts # Stdio server (for Claude Desktop)
browser/
├── driver.ts # Headless Chrome WebDriver
├── load-page.ts # Page loading, Core Web Vitals, screenshots
└── mod.ts
lib/
├── analysis/ # Text analysis & scoring algorithms
├── cache/ # Resource caching
├── config/ # Constants & configuration
├── extraction/ # Page parsing helpers
├── page/ # Page retrieval orchestration
├── suggestions/ # SEO improvement suggestions
├── tools/ # MCP tool implementations (24 tools)
└── types/ # TypeScript interfacesCreate tool file in lib/tools/your-tool.ts
Export registration function: registerYourTool(server: McpServer)
Import and call in lib/tools/mod.ts
Add to registerAllTools() function
Runtime: Bun (primary), Node.js compatible
HTTP Framework: Hono
Transports: StdioServerTransport (Claude Desktop), WebStandardStreamableHTTPServerTransport (HTTP clients)
Browser Automation: Selenium WebDriver with headless Chrome
Key Dependencies: @modelcontextprotocol/sdk, zod, hono, fast-xml-parser, node-html-parser
MIT
This server cannot be deployed
SEO MCP server: crawl your site, find AI-visibility gaps, and ship the fix from your coding agent.
SEO MCP server for keyword research, SERP analysis, audits, and Search Console workflows.
Live SEO workflow tools for Claude Code, Codex, and AI agents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
