About @rog0x/mcp-seo-tools
@rog0x/mcp-seo-tools is an MCP server for AI agents to analyze SEO on public webpages without external API keys. It checks page structure, links, and sitemaps, and measures page-loading metrics.
Key features
- 01Audit meta tags and social cards
- 02Validate heading hierarchy
- 03Find broken links and redirects
- 04Analyze keyword density and placement
- 05Measure page speed and resources
- 06Parse and check sitemaps
Use cases
- 01Review page metadata and heading structure
- 02Locate broken links and redirects
- 03Check target keyword placement on a page
- 04Validate sitemap health
MCP support
The MCP server exposes webpage SEO analysis tools for AI agents, covering metadata, headings, links, keywords, speed, and sitemaps. Tools use direct HTTP requests and HTML parsing, with no API key required.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
6Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | Full URL of the page to analyze (e.g. https://example.com) |
Details
From the project READMEmcp-seo-tools
An MCP (Model Context Protocol) server that gives AI agents a suite of SEO analysis tools. Analyze any public webpage for meta tags, heading structure, broken links, keyword density, page speed, and sitemap health — all without external API keys.
Tools
| Tool | Description |
|---|---|
seo_meta_analyze | Audit meta tags, Open Graph, and Twitter Card tags with scoring |
seo_heading_check | Validate H1-H6 hierarchy, detect skipped levels and duplicates |
seo_link_check | Find broken links, redirects, and missing anchor text |
seo_keyword_density | Measure keyword frequency and check target keyword placement |
seo_page_speed | Measure TTFB, load time, HTML size, and resource counts |
seo_sitemap_parse | Parse sitemap.xml, check freshness, duplicates, and compliance |
Requirements
- Node.js 18+
- No API keys needed — all tools use direct HTTP requests and HTML parsing
Installation
git clone <repo-url>
cd mcp-seo-tools
npm install
npm run build
Usage with Claude Code
Add to your Claude Code MCP configuration:
claude mcp add seo-tools node D:/products/mcp-servers/mcp-seo-tools/dist/index.js
Usage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"seo-tools": {
"command": "node",
"args": ["D:/products/mcp-servers/mcp-seo-tools/dist/index.js"]
}
}
}
Tool Details
seo_meta_analyze
Fetches a URL and inspects all meta-related elements. Checks title length (optimal: 30-60 chars), meta description length (optimal: 120-160 chars), canonical URL, viewport tag, language attribute, Open Graph completeness, and Twitter Card setup. Returns a 0-100 score.
Input: { "url": "https://example.com" }
seo_heading_check
Parses all headings on a page and builds a visual hierarchy tree. Flags: missing H1, multiple H1s, skipped heading levels, empty headings, overly long headings (>70 chars), and duplicate headings.
Input: { "url": "https://example.com" }
seo_link_check
Extracts all anchor tags from a page, resolves relative URLs, deduplicates, and probes each link with a HEAD request (falling back to GET when needed). Classifies links as ok, broken, redirect, timeout, or error. Reports internal vs. external link ratio.
Input: { "url": "https://example.com", "max_links": 100 }
seo_keyword_density
Strips scripts, styles, and navigation, then tokenizes the remaining body text. Computes frequency and density for single words, bigrams, and trigrams (filtering stop words). When a target keyword is provided, checks whether it appears in the title, H1, meta description, and first paragraph.
Input: { "url": "https://example.com", "target_keyword": "seo tools" }
seo_page_speed
Measures Time to First Byte and total download time from the server's perspective. Counts external scripts, stylesheets, images, and iframes. Detects render-blocking scripts (missing async/defer), images without alt text or dimensions, missing compression, and absence of lazy loading.
Input: { "url": "https://example.com" }
seo_sitemap_parse
Accepts a sitemap URL or any page URL (automatically appends /sitemap.xml). Falls back to checking robots.txt for a Sitemap directive. Handles both <sitemapindex> and <urlset> formats. Validates URL count limits, lastmod freshness, duplicate entries, protocol consistency, and trailing slash patterns.
Input: { "url": "https://example.com" }
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.