Перейти к основному содержанию
SEO / МаркетингОткрытое ядро

mcp-seo-audit — SEO-аудит сайта

Технические проверки robots, sitemap и метаданных сайта.

Подключение и доступ

Платный размещённый доступ здесь не предлагается.

Список проверок описан; результат аудита конкретного сайта здесь не подтверждён.

В исходной документации указан локальный пакет atomno-mcp-seo-audit. Его наличие не подтверждает доступ к источнику.

Вкратце

Технические проверки robots, sitemap и метаданных сайта. Список проверок описан; результат аудита конкретного сайта здесь не подтверждён.

Пример в чате

Учебный пример, не живой ответ. Размещённый доступ к этому составу данных не подтверждён (аудит atomno-mcp.ru — демо-данные, не живой ответ).

atomno-seo-audit Демо · HTTP-замеры и GEO-готовность

Источник данных:detail.web (audit.detailweb.ru) . Atomno MCP не аффилирован с провайдером.

Установка

Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.

Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):

Конфигурация (переменные окружения)

Переменная Описание Где взять 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 по категориям.

Input
url: str, depth?: int, lang?: "ru"|"en"
Output
AuditReport { score, grade, issues[], summary }
audit_diff async tool

Повторный аудит и сравнение с предыдущим снимком (PRO).

Input
url: str, lang?: "ru"|"en"
Output
AuditDiff { score_delta, improved[], worsened[] }
list_checks async tool

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

Input
lang?: "ru"|"en"
Output
list[Check { id, category, tier }]
explain_issue async tool

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

Input
check_id: str, lang?: "ru"|"en"
Output
IssueExplain { title, why, how_to_fix }
validate_robots async tool

Валидация текста robots.txt (синтаксис, Sitemap, блокировка AI-ботов).

Input
content: str, lang?: "ru"|"en"
Output
RobotsValidation { valid, issues[] }
check_sitemap async tool

Загрузка и разбор sitemap.xml по URL.

Input
url: str, lang?: "ru"|"en"
Output
SitemapReport { format, url_count, issues[] }
build_jsonld async tool

Генерация schema.org JSON-LD (Organization, Product, FAQ и др.).

Input
type: str, fields: dict, lang?: "ru"|"en"
Output
JsonLdSnippet { script, missing_fields[] }
build_meta async tool

Генерация meta / Open Graph / Twitter Card с проверкой длин title и description.

Input
fields: dict, lang?: "ru"|"en"
Output
MetaTags { html, warnings[] }

Примеры использования

Реальные запросы для 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

Одна проверка URL означает полный аудит всех страниц сайта?
Нет. Объём зависит от выбранного режима и глубины обхода. Сверяйте найденные, проверенные и исключённые адреса; результат одной страницы не описывает весь сайт.
Нужно ли исправлять каждую эвристическую отметку отчёта?
Сначала проверьте причину на конкретной странице. Намеренный noindex, внешняя ссылка и ссылка-иконка требуют разбора; сама отметка не доказывает дефект и не служит основанием удалять содержание.
Можно ли считать один таймаут доказательством недоступности сайта?
Нет. Неудачный запрос фиксирует результат этой попытки. Перед выводом о сайте учитывайте адрес, время, код ответа и объём выполненной проверки; отсутствие ответа не заменяет разбор причины.
Как установить mcp-seo-audit?
В разделе «Установка» выберите свой клиент и используйте приведённую команду uvx atomno-mcp-seo-audit. Файл и структура настройки зависят от клиента; пошаговые инструкции доступны в разделе документации. Требуемая версия Python указана в метаданных пакета на PyPI.
Нужен ли MCP-клиент для собственного сайта или CRM?
Если данные получает код вашего бэкенда, используйте REST API доступного продукта. MCP подходит для агента в совместимом приложении. Состав источников и ограничения продукта не расширяются при смене способа подключения.
Это открытый код?
Да, mcp-seo-audit распространяется под лицензией MIT. Исходный код: https://github.com/atomno-mcp/mcp-seo-audit. Код можно скопировать и доработать под себя.
Где сообщить об ошибке?
Раздел Issues на GitHub: https://github.com/atomno-mcp/mcp-seo-audit/issues. Или напишите mcp@atomno.com.

Changelog

Текущая версия: v0.4.8. Полная история — GitHub Releases. Прежние формулировки витрины — в истории изменений сайта.

Правовая оговорка

Atomno MCP не аффилирован с detail.web (audit.detailweb.ru). mcp-seo-audit использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: MIT.

Связанные задачи

Просмотр кода

Копируется исходный текст. Переносы меняют только отображение.

Текст

Поиск по сайту

Введите хотя бы два символа.

Tab — переход по ссылкам · Esc — закрыть