seo-audit-tool
v1.1.4
Published
Marketing-focused MCP server for SEO analysis. Audits pages, analyzes keywords, checks links, validates sitemaps, and compares page SEO metrics.
Maintainers
Readme
SEO Audit Tool - MCP Server
Marketing-focused MCP server for comprehensive SEO analysis. Fetches and parses live web pages to audit SEO health, analyze keywords, check links, validate sitemaps, and compare pages -- no external API keys needed.
Pricing
| Plan | Price | Features |
|------|-------|----------|
| Basic | $10/mo | audit_page, analyze_keywords, analyze_sitemap — Buy → |
| Pro | $20/mo | All 5 tools including check_links and compare_pages — Buy → |
Free trial: 3 calls total (shared across all tools), no credit card. License keys are emailed instantly after checkout. Activate via the LICENSE_KEY environment variable. More info: aivp-mcp.vercel.app
Tools
audit_page
Perform a comprehensive SEO audit on a URL. Returns a score from 0-100.
Input:
url(string, required) - The URL to audit
Checks:
- Title tag (length, presence, keyword positioning)
- Meta description (length, quality)
- H1-H6 heading structure and hierarchy
- Image alt text coverage percentage
- Internal and external link counts
- Page load size estimation (KB)
- Mobile-friendliness (viewport meta tag)
- Schema.org / structured data presence (JSON-LD, microdata)
- Canonical URL, Open Graph tags
Output: Score 0-100 with grade (A-F), categorized issues by severity, and actionable recommendations.
analyze_keywords
Extract keyword phrases and density metrics from text content.
Input:
text(string, required) - Plain text content to analyze
Extracts:
- Top single-word keywords (1-grams) with counts and density
- Top two-word phrases (2-grams)
- Top three-word phrases (3-grams)
- TF-IDF approximation scores
- Suggested focus keywords
- Related keyword suggestions
Output: Keyword tables with density percentages and optimization tips.
check_links
Crawl all links on a page and check their status.
Input:
url(string, required) - The page URL to check links on
Checks:
- Identifies broken links (4xx, 5xx status codes)
- Classifies links as internal vs external
- Detects nofollow and noopener attributes
- Identifies redirect chains (301/302)
- Checks up to 100 unique links with concurrent requests
Output: Summary with broken, redirected, and nofollow link lists plus a full link table.
analyze_sitemap
Parse and validate an XML sitemap.
Input:
url(string, required) - The sitemap.xml URL
Validates:
- XML structure and namespace declarations
- Total URL count (warns if over 50,000 limit)
- Duplicate URL detection
- lastmod date format validation
- Future date detection
- URL path pattern analysis
- Sitemap index support
Output: Validation status, statistics, URL pattern breakdown, and issues.
compare_pages
Compare SEO metrics of two URLs side by side.
Input:
url_a(string, required) - First URLurl_b(string, required) - Second URL
Compares:
- Overall SEO scores
- Title and meta description lengths
- Heading counts and H1 presence
- Image alt text coverage
- Internal/external link counts
- Page size
- Viewport and structured data presence
- Word count
Output: Side-by-side comparison table, winner determination, and improvement recommendations for the losing page.
Installation
No install step needed — run straight from npm:
npx -y seo-audit-toolOr install globally:
npm install -g seo-audit-toolUsage
stdio (Claude Desktop, Cursor, etc.)
Add to your MCP client configuration:
{
"mcpServers": {
"seo-audit-tool": {
"command": "npx",
"args": ["-y", "seo-audit-tool"],
"env": { "LICENSE_KEY": "<your license key — omit for free trial>" }
}
}
}SSE (HTTP mode)
npx -y seo-audit-tool --sse
# or with custom port:
PORT=4000 npx -y seo-audit-tool --sseEndpoints:
GET /sse- SSE connectionPOST /messages?sessionId=<id>- Send messagesGET /health- Health check
Example Usage
Once connected via MCP, ask your AI assistant:
- "Audit the SEO of https://example.com"
- "Analyze the keywords in this article" (paste text)
- "Check all links on https://example.com for broken ones"
- "Analyze the sitemap at https://example.com/sitemap.xml"
- "Compare the SEO of https://example.com vs https://competitor.com"
SEO Best Practices Reference
| Element | Optimal Range | |---------|--------------| | Title length | 50-60 characters | | Meta description | 120-155 characters | | H1 tags per page | Exactly 1 | | Keyword density | 1.0-2.0% | | Image alt text | 100% coverage | | Page size | Under 1.5 MB |
Technical Notes
- No external API keys required -- fetches and parses HTML directly
- Uses Node.js built-in
fetch(requires Node 18+) - Link checking uses HEAD requests with GET fallback
- Concurrent link checking (10 parallel requests, max 100 links)
- 15-second timeout per request
- Follows redirects manually to capture redirect chains
License
MIT
