MCP server for technical SEO audits powered by the detail.web engine: site health score, issues across 8 categories and a GEO (AI-search visibility) sub-score.
Project description
atomno-mcp-seo-audit
MCP (Model Context Protocol) server for technical SEO audits, powered by the detail.web engine. Run a site audit straight from your AI agent in Cursor, Claude Desktop or any MCP client — get a health score, issues across 8 categories, and a GEO (Generative Engine Optimization — visibility in AI search) sub-score.
What you get
audit_site(url, depth=1, lang="ru")— one call returns:- health score
0–100(higher is better) and a letter gradeA–F; - issues grouped by category (security, SEO & indexing, performance, GEO, …),
each with status
pass / warn / fail; - a short human-readable summary.
- health score
list_checks(lang="ru")— the full catalogue of engine checks grouped by category, with afree/PRObadge on each — so you (and the agent) can see exactly what the free tier covers and what PRO unlocks.explain_issue(check_id, lang="ru")— a deep-dive on a single check: why it matters and how to fix it. Pass acheck_idfromaudit_siteorlist_checks. Title and category are localized; detailed advice is currently in Russian (theadvice_langfield reports this).validate_robots(content, lang="ru")— paste arobots.txtand get back syntax issues, whether aSitemap:directive is present, whether CSS/JS is blocked from render bots, and which AI crawlers (GPTBot, ClaudeBot, …) are explicitly blocked. No fetch — validates the text you provide.check_sitemap(url, lang="ru")— fetches a sitemap by URL and reports its format (urlset/sitemapindex), URL count and common problems (404, non-XML content type,http://links, missing<lastmod>, the 50k-per-file limit). The fetch is SSRF-guarded on the server.build_jsonld(type, fields, lang="ru")— generates a ready-to-paste schema.org JSON-LD<script>(Organization, LocalBusiness, Article, Product, FAQPage, BreadcrumbList, WebSite) and tells you which required/recommended fields are missing. It never invents data — only what you pass in.build_meta(fields, lang="ru")— generates<head>meta tags (title, description, canonical, Open Graph, Twitter Card) and validates the title (50–60 chars) and description (120–160 chars) lengths.
Free vs PRO
| Free (no key) | PRO (with API key) | |
|---|---|---|
| Checks | core technical basics | 40+ deeper checks (E-E-A-T, Schema.org, Goldmine title) |
| GEO | 4 GEO signals | GEO readiness sub-score + deep GEO checks |
| Crawl | single page | deep-crawl up to 20 pages (depth=2/3) |
The audit engine itself stays on the server — this package is a thin client (HTTP calls + formatting only).
Install
uvx atomno-mcp-seo-audit
Or add to your MCP client config (mcp.json):
{
"mcpServers": {
"seo-audit": {
"command": "uvx",
"args": ["atomno-mcp-seo-audit"]
}
}
}
Configuration
All via environment variables:
| Variable | Default | Purpose |
|---|---|---|
DETAILWEB_API_BASE |
https://api.detailweb.ru |
Backend base URL |
DETAILWEB_API_KEY |
— | PRO key (dwa_...). Without it → free tier |
DETAILWEB_TIMEOUT |
60 |
HTTP timeout (seconds) |
DETAILWEB_LANG |
ru |
Default issue-title language (ru / en) |
Get a PRO key in the detail.web dashboard → Account → API keys.
Example
"Audit https://example.com"
The agent calls audit_site("https://example.com") and gets back the health
score, grade and the list of issues to fix.
License
MIT © atomno-labs. The open-source client talks to a proprietary hosted backend.
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 atomno_mcp_seo_audit-0.3.0.tar.gz.
File metadata
- Download URL: atomno_mcp_seo_audit-0.3.0.tar.gz
- Upload date:
- Size: 17.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b25c1545688f3ad7f4a9b7c529af3fc826855a832f7022e9122e207856ff8f92
|
|
| MD5 |
2a1b358139fa89250dbeac8a70555436
|
|
| BLAKE2b-256 |
600798cee29f2449d8e9c738870dae994ed230396576871ccbf37837c38fe0ba
|
File details
Details for the file atomno_mcp_seo_audit-0.3.0-py3-none-any.whl.
File metadata
- Download URL: atomno_mcp_seo_audit-0.3.0-py3-none-any.whl
- Upload date:
- Size: 15.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4092733e809c6b4eee81292857e15a375de7505bde120ddee02485c2579b343
|
|
| MD5 |
f07f033a30b6b2053ba5fe30914f4782
|
|
| BLAKE2b-256 |
b1fb406cf90e38b957ea64181886813bb481a76cd273eca05318a7aa6585781f
|
