Instant SEO, performance, and security audits for any URL — an MCP server for AI agents
Project description
SiteAudit MCP
Instant SEO, Performance, and Security Audits for AI Agents — analyze any URL with a single tool call via the Model Context Protocol (MCP).
SiteAudit is an MCP server that gives Claude Code, Cursor, Windsurf, and any AI agent the ability to audit any website instantly. No API keys, no configuration, no cost. The complete website audit toolkit for AI-powered development.
Use Cases
Here are concrete examples of what you can ask your AI agent once SiteAudit is installed:
- "Audit example.com and give me a prioritized list of SEO fixes" — Full SEO audit with title tags, meta descriptions, headings, structured data, Open Graph, and actionable recommendations
- "Check the security headers on my production site" — HTTPS, HSTS, CSP, X-Frame-Options, cookie flags, SSL certificate validity, and server disclosure
- "Compare my site vs 3 competitors side-by-side" — Multi-site comparison with scores for SEO, performance, and security across all sites
- "Run a Lighthouse audit on my homepage" — Google PageSpeed Insights performance, accessibility, best practices, and SEO scores
- "Find all broken links on my site" — Crawl internal and external links, report 404s, redirects, and unreachable URLs
- "Check if my robots.txt is blocking anything important" — Parse robots.txt rules, find sitemap references, and identify potential crawl issues
Why SiteAudit?
| Feature | SiteAudit MCP | Ahrefs | Screaming Frog | Google Lighthouse |
|---|---|---|---|---|
| Works with Claude Code / Cursor | Yes | No | No | CLI only |
| No API key needed | Yes | No ($99/mo) | Free (limited) | Yes |
| SEO + Security + Performance | All three | SEO only | SEO only | Performance only |
| AI-native (MCP protocol) | Yes | REST API | Desktop app | CLI / API |
| Broken link checker | Yes | Yes | Yes | No |
| Lighthouse integration | Yes | No | No | It is Lighthouse |
| Multi-site comparison | Yes | Manual | Manual | Manual |
| Free | Yes | $99+/mo | Free (500 URLs) | Yes |
Tools (8)
| Tool | Description |
|---|---|
full_audit |
Comprehensive SEO + performance + security audit with unified score (0-100) |
seo_audit |
SEO analysis: title, meta, headings, images, links, structured data, Open Graph |
security_audit |
Security headers, HTTPS, HSTS, CSP, SSL certificate check, cookie flags |
performance_audit |
Response time, page size, compression, caching, redirects |
compare_sites |
Side-by-side comparison of multiple websites |
lighthouse_audit |
Google PageSpeed Insights: performance, accessibility, best practices, SEO |
check_links |
Crawl and validate all links on a page — find broken links, redirects, timeouts |
check_robots_txt |
Parse and analyze robots.txt rules, directives, and sitemaps |
Installation
Claude Code (recommended)
claude mcp add siteaudit -- uvx --from siteaudit-mcp siteaudit
Claude Desktop / Cursor / Windsurf
Add to your MCP configuration (claude_desktop_config.json, .cursor/mcp.json, etc.):
{
"mcpServers": {
"siteaudit": {
"command": "uvx",
"args": ["--from", "siteaudit-mcp", "siteaudit"]
}
}
}
Install via Smithery
npx -y @smithery/cli install @vdalhambra/siteaudit --client claude
Install via MCPize (hosted, no local install)
{
"mcpServers": {
"siteaudit": {
"url": "https://siteaudit-mcp.mcpize.run/mcp"
}
}
}
From PyPI
pip install siteaudit-mcp
siteaudit
From source
git clone https://github.com/vdalhambra/siteaudit-mcp.git
cd siteaudit-mcp
uv sync
uv run siteaudit
What it checks
SEO Audit (20+ checks)
- Title tag (presence, length optimization)
- Meta description (presence, length)
- H1 tag (count, content)
- Heading hierarchy (H1-H6)
- Image alt text coverage
- Internal/external link count
- Canonical URL
- Open Graph tags
- Twitter Card tags
- Mobile viewport
- Structured data (JSON-LD)
- Favicon
- Language attribute
- robots meta directives
- Content length (word count)
Security Audit (10+ checks)
- HTTPS enforcement
- HSTS header (with subdomains and preload)
- Content-Security-Policy
- X-Content-Type-Options
- X-Frame-Options
- Referrer-Policy
- Permissions-Policy
- Server/X-Powered-By disclosure
- Cookie security flags (Secure, HttpOnly, SameSite)
- SSL certificate validity and expiration
Performance Audit
- Server response time (ms)
- Page size (KB)
- Compression (gzip/brotli)
- Cache-Control headers
- Redirect chain analysis
- HTTP status code
Lighthouse Audit (via Google PageSpeed Insights)
- Performance score
- Accessibility score
- Best practices score
- SEO score
- Core Web Vitals (FCP, LCP, TBT, CLS)
Example Output
URL: https://github.com
Overall Score: 90/100 (Grade: A)
Scores:
SEO: 85/100
Performance: 95/100
Security: 90/100
Issues: 0
Warnings: 3
[SEO] No JSON-LD structured data
[Security] Missing Content-Security-Policy header
[Security] Server header discloses: 'GitHub.com'
No API Keys Required
SiteAudit works entirely by analyzing the HTML and HTTP headers of the target URL. No third-party API keys needed. It uses:
requestsfor HTTP fetchingBeautifulSoupfor HTML parsing- Python
sslfor certificate checking - Google PageSpeed Insights API (free, no key required for basic usage)
Compatible AI Agents
SiteAudit works with any AI agent or IDE that supports the Model Context Protocol:
- Claude Code (CLI) —
claude mcp add - Claude Desktop —
claude_desktop_config.json - Cursor —
.cursor/mcp.json - Windsurf — MCP settings
- Copilot — MCP configuration
- Any MCP client — stdio or HTTP transport
License
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file siteaudit_mcp-1.1.0.tar.gz.
File metadata
- Download URL: siteaudit_mcp-1.1.0.tar.gz
- Upload date:
- Size: 106.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7695bdc83125727471728e396418de5963647d38837a9e2a9f525d8100396b6c
|
|
| MD5 |
d51b50ecd5489296b19e1989ede50e8c
|
|
| BLAKE2b-256 |
867e713aef3c4cf9e6775f7e4cfa1f8338ca2748618e1134c66518ae002195b5
|
File details
Details for the file siteaudit_mcp-1.1.0-py3-none-any.whl.
File metadata
- Download URL: siteaudit_mcp-1.1.0-py3-none-any.whl
- Upload date:
- Size: 19.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f3f402d8421d00548fc40ed11ffbf16653f77afc1dc6823eb68c4342ff323a9
|
|
| MD5 |
0abc54262cdbf9268ead80b3295b7942
|
|
| BLAKE2b-256 |
6aed5c863fdcf884f21e66ebc6c9226e6a832ebcaf304fdbd1926d8152263b1c
|