mcp-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
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