Model Context Protocol · how-to

Установка и использование MCP-сервера

Пошаговое руководство по atomno-mcp-seo-audit: установка, конфиги для популярных клиентов, разница free / PRO, все инструменты с примерами. Обзорная страница — /mcp.

uvx atomno-mcp-seo-audit

1. Установка

Требуется Python 3.11+. Два способа:

Без установки (рекомендуется)

uvx atomno-mcp-seo-audit

uvx скачает и запустит сервер на лету.

Глобально через pipx

pipx install atomno-mcp-seo-audit

Команда: atomno-mcp-seo-audit.

2. Подключение к клиенту

Добавьте сервер в конфиг MCP-клиента и перезапустите его. PRO-ключ (DETAILWEB_API_KEY) опционален — без него работает free.

Cursor — `~/.cursor/mcp.json`

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"],
      "env": {
        "DETAILWEB_LANG": "ru",
        "DETAILWEB_API_KEY": "dwa_ваш_ключ"
      }
    }
  }
}

Claude Desktop — `claude_desktop_config.json`

{
  "mcpServers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"],
      "env": { "DETAILWEB_API_KEY": "dwa_ваш_ключ" }
    }
  }
}

VS Code — `.vscode/mcp.json`

{
  "servers": {
    "seo-audit": {
      "command": "uvx",
      "args": ["atomno-mcp-seo-audit"],
      "env": { "DETAILWEB_API_KEY": "dwa_ваш_ключ" }
    }
  }
}

3. Free и PRO

	Free (без ключа)	PRO (DETAILWEB_API_KEY)
Проверки	базовые технические	40+ глубоких (E-E-A-T, Schema, Goldmine-title)
GEO	4 сигнала	GEO-суб-балл + глубокие GEO-проверки
Обход	одна страница	deep-crawl до 20 страниц
audit_diff	—	stateful-отслеживание изменений

Ключ создаётся в кабинете (Аккаунт → API-ключи) на тарифе PRO+ и выше; формат — dwa_…. Подставьте его в env.DETAILWEB_API_KEY.

4. Инструменты с примерами

audit_site

Полный аудит URL: health-score, оценка A–F, проблемы по категориям, GEO-суб-балл (PRO).

Промпт: «Проведи SEO-аудит https://example.ru»

Пример вывода: health: 68 (C), 5 критичных, 10 предупреждений; GEO 54/100; топ-проблемы: нет HSTS, короткое description…

audit_diff

Что изменилось с прошлой проверки: дельта score/health и какие проверки стали хуже/лучше (PRO).

Промпт: «Сравни текущий аудит example.ru с прошлым»

Пример вывода: health +6 (62→68); улучшилось: HSTS (warn→pass); ухудшилось: sitemap (pass→fail).

list_checks

Каталог всех проверок движка с разбивкой free / PRO по категориям.

Промпт: «Какие проверки делает движок в категории безопасности?»

Пример вывода: security: HTTPS/SSL, HSTS, CSP, X-Content-Type-Options, mixed-content, clickjacking…

explain_issue

Подробно по одной проверке: почему важна и как исправить.

Промпт: «Объясни проверку hsts и как её починить»

Пример вывода: HSTS заставляет браузер ходить только по HTTPS… Добавьте заголовок Strict-Transport-Security…

validate_robots

Разбор robots.txt: синтаксис, sitemap-директива, блокировка CSS/JS и ИИ-краулеров.

Промпт: «Проверь этот robots.txt: …»

Пример вывода: valid: true; найдена Sitemap-директива; GPTBot не заблокирован; CSS/JS открыты.

check_sitemap

Фетч и разбор sitemap по URL: формат, число URL, частые ошибки.

Промпт: «Проверь https://example.ru/sitemap.xml»

Пример вывода: format: urlset; 248 URL; отдаётся по https; ошибок не найдено.

build_jsonld

Готовый блок JSON-LD schema.org из ваших полей (Organization, Article, Product, FAQPage…).

Промпт: «Собери JSON-LD Organization для ООО Ромашка»

Пример вывода: <script type="application/ld+json">{ "@type": "Organization", "name": "Ромашка"… }</script>

build_meta

Генерация <head>-мета-тегов (title, description, canonical, Open Graph, Twitter) с проверкой длин.

Промпт: «Сделай meta-теги для страницы услуг»

Пример вывода: <title>…</title> (58 симв., ок), <meta name="description"…> (148 симв., ок), og:*, twitter:*

5. Типовые сценарии

Проверить сайт и объяснить топ-3 проблемы

«Проведи SEO-аудит example.ru, возьми три самые острые проблемы и объясни каждую: почему важно и как починить». Агент вызовет audit_site, затем explain_issue для топ-проблем.

Собрать разметку Organization

«Собери JSON-LD Organization: имя, сайт, телефон, соцсети» → build_jsonld вернёт готовый <script>-блок для вставки в <head>.

6. Troubleshooting

Симптом	Решение
uvx: command not found	Установите uv: pip install uv (или см. astral.sh/uv). Альтернатива — pipx install atomno-mcp-seo-audit и command: "atomno-mcp-seo-audit".
PRO-функции не работают	Проверьте DETAILWEB_API_KEY (формат dwa_…) и тариф PRO+ и выше. Без ключа сервер отдаёт free-результат.
Сервер не появился в агенте	Перезапустите MCP-клиент после правки mcp.json. Проверьте путь файла: Cursor — ~/.cursor/mcp.json.
Таймауты на больших сайтах	Deep-crawl дольше; повышайте depth постепенно (1→2→3) и убедитесь, что хватает кредитов.

Исходники и issues: GitHub · PyPI. Программный доступ без MCP — документация HTTP-API.