Вкратце
MCP-сервер для технического SEO и GEO (видимость в ChatGPT, Perplexity, Google AI Overviews): health score 0–100, TLS, robots.txt, sitemap, JSON-LD, AI-crawler access. Движок detail.web — бесплатный tier без ключа, PRO с deep-crawl и audit_diff.
Источник данных: detail.web (audit.detailweb.ru) . Atomno MCP не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-seo-audit": {
"command": "uvx",
"args": ["atomno-mcp-seo-audit"]
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-seo-audit": {
"command": "uvx",
"args": ["atomno-mcp-seo-audit"]
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-seo-audit -- uvx atomno-mcp-seo-audit
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-seo-audit": {
"command": "uvx",
"args": ["atomno-mcp-seo-audit"]
}
}
}Конфигурация (переменные окружения)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| DETAILWEB_API_KEY | API key PRO tier (dwa_...). Без ключа — free tier | ссылка ↗ | no | — |
| DETAILWEB_API_BASE | Backend URL движка detail.web | — | no | https://api.detailweb.ru |
| DETAILWEB_LANG | Язык заголовков проверок (ru / en) | — | no | ru |
| MCP_SEO_AUDIT_LOG_LEVEL | Уровень логирования | — | no | INFO |
Инструменты MCP-сервера
Сервер регистрирует 8 инструментов для AI-агента. Все входные данные строго проверяются.
audit_site async tool Полный технический аудит URL: score 0–100, grade A–F, issues по категориям.
url: str, depth?: int, lang?: "ru"|"en" AuditReport { score, grade, issues[], summary } audit_diff async tool Повторный аудит и сравнение с предыдущим снимком (PRO).
url: str, lang?: "ru"|"en" AuditDiff { score_delta, improved[], worsened[] } list_checks async tool Каталог всех проверок движка с пометкой free/PRO.
lang?: "ru"|"en" list[Check { id, category, tier }] explain_issue async tool Разбор одной проверки: зачем важно и как исправить.
check_id: str, lang?: "ru"|"en" IssueExplain { title, why, how_to_fix } validate_robots async tool Валидация текста robots.txt (синтаксис, Sitemap, блокировка AI-ботов).
content: str, lang?: "ru"|"en" RobotsValidation { valid, issues[] } check_sitemap async tool Загрузка и разбор sitemap.xml по URL.
url: str, lang?: "ru"|"en" SitemapReport { format, url_count, issues[] } build_jsonld async tool Генерация schema.org JSON-LD (Organization, Product, FAQ и др.).
type: str, fields: dict, lang?: "ru"|"en" JsonLdSnippet { script, missing_fields[] } build_meta async tool Генерация meta / Open Graph / Twitter Card с проверкой длин title и description.
fields: dict, lang?: "ru"|"en" MetaTags { html, warnings[] } Бесплатно и Pro
Клиент — с открытым кодом под MIT, бесплатный. Тариф Pro — размещение на нашей стороне с дополнительными возможностями: без лимитов, массовые операции, аудит, уведомления о событиях.
| Возможность | Бесплатно (открытый код) | Pro (на нашей стороне) |
|---|---|---|
| Проверки | Базовый technical SEO | 40+ углублённых (E-E-A-T, Schema, Goldmine title) |
| GEO | 4 GEO-сигнала | GEO readiness sub-score + deep GEO |
| Краул | 1 страница | До 20 страниц (depth 2–3) |
| audit_diff | — | Сравнение с предыдущим аудитом |
Тариф Pro — размещение на нашей стороне без лимитов и с дополнительными возможностями.
Запросить Pro-доступПримеры использования
Реальные запросы для AI-агента в Cursor / Claude Code:
- audit_site: «Используй mcp-seo-audit инструмент
audit_siteи полный технический аудит url: score 0–100, grade a–f, issues по категориям.» - audit_diff: «Используй mcp-seo-audit инструмент
audit_diffи повторный аудит и сравнение с предыдущим снимком (pro).» - list_checks: «Используй mcp-seo-audit инструмент
list_checksи каталог всех проверок движка с пометкой free/pro.»
Решение проблем
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
Полное руководство по решению проблем → /docs/troubleshooting
FAQ
Как установить mcp-seo-audit? +
Какой Python нужен? +
Это открытый код? +
Где сообщить об ошибке? +
Чем Pro отличается от бесплатной версии? +
Changelog
Текущая версия: v0.4.2. Полная история — GitHub Releases.
Исходный код и задачи
- GitHub: atomno-mcp/mcp-seo-audit
- PyPI: atomno-mcp-seo-audit
- Issues: atomno-mcp/mcp-seo-audit/issues
- Discussions: atomno-mcp/mcp-seo-audit/discussions
Правовая оговорка
Atomno MCP не аффилирован с detail.web (audit.detailweb.ru). mcp-seo-audit использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: MIT.