SEOmator — SEO-аудит по 398 правилам: CLI, десктоп-приложение и скилл для Claude Code
📂 Исходный код на GitHubSEOmator — open-source SEO-аудит по 398 правилам в 20 категориях: CLI, десктоп-приложение, MCP-сервер и скилл для Claude Code
SEOmator — open-source SEO-аудитор для сайтов. Он проверяет сайт по 398 правилам в 20 категориях и выдаёт оценку от 0 до 100 плюс список проблем, отсортированный по важности. Проект распространяется по лицензии MIT и поставляется в трёх видах: утилита командной строки, десктоп-приложение и скилл для Claude Code. Есть и MCP-сервер, поэтому аудит может запускать любой агент.
Отдельно стоит отметить честность отчётов. Если проверку выполнить не удалось, она не засчитывается как пройденная — отчёт пишет «не измерено» и объясняет причину, например «нужен рендеринг в браузере». Новые проверки сначала считаются консультативными и не влияют на оценку, пока не докажут пользу.
Что проверяется
Полный список категорий и их вес в общей оценке:
| Категория | Правил | Вес |
|---|---|---|
| Core — title, description, canonical, H1 | 27 | 11% |
| Performance — Core Web Vitals, DOM, сжатие | 30 | 10% |
| Links — внутренние и внешние ссылки | 27 | 8% |
| Images — alt, размеры, форматы | 15 | 8% |
| Security — HTTPS, CSP, заголовки, куки | 26 | 8% |
| Accessibility — доступность через axe-core | 46 | 7% |
| Technical SEO — robots.txt, sitemap, 404 | 19 | 7% |
| Crawlability — canonical, hreflang, пагинация | 39 | 5% |
| Structured Data — валидация JSON-LD | 19 | 5% |
| JavaScript Rendering — DOM до и после рендеринга | 17 | 5% |
| Content — объём текста, дубли, иерархия заголовков | 27 | 5% |
| Social — Open Graph и twitter-карточки | 13 | 3% |
| E-E-A-T — авторы, контакты, политики | 16 | 3% |
| URL Structure — слаги, регистр, параметры | 14 | 3% |
| Redirects — цепочки, петли, 301 | 11 | 3% |
| Mobile — вьюпорт, совпадение мобильной версии | 13 | 2% |
| Internationalization — hreflang, lang | 13 | 2% |
| HTML Validation — doctype, charset, head | 12 | 2% |
| AI/GEO Readiness — доступ AI-ботов, llms.txt | 13 | 2% |
| Legal Compliance — баннер cookie | 1 | 1% |
Категория AI/GEO Readiness проверяет, пускают ли robots.txt цитирующих AI-ботов, есть ли файл llms.txt, можно ли вытянуть структуру страницы и совпадает ли JSON-LD с видимым текстом. Тренировочные боты вроде GPTBot только фиксируются в отчёте — без штрафа.
Есть и жёсткий порог «страница не может попасть в выдачу». Пока на странице стоит noindex или её закрывает robots.txt, общая оценка не поднимется выше 20. Пустая страница ограничена 30 баллами, страница короче 20 слов основного текста — 49, отсутствие title — 69.
Установка и быстрый старт
# Install globally
npm install -g @seomator/seo-audit
# Basic audit
seomator audit https://example.com
# Render pages in a browser for Core Web Vitals (slower)
seomator audit https://example.com --cwv
# Audit only selected categories
seomator audit https://example.com -c core,security,perf
Для Core Web Vitals и проверок рендеринга нужен браузер. Утилита сама подхватит установленный Chrome, Chromium или Edge. Если браузера нет, поставьте Chromium через Playwright:
npx playwright install chromium
Флаг --crawl включает обход нескольких страниц: по умолчанию десять, максимум тысяча за прогон. Требования — Node.js 20.18.1+ и Playwright для рендеринга.
Форматы вывода
Отчёт можно получить в пяти форматах: console для терминала, json для CI и скриптов, html для самостоятельного отчёта, markdown для документации и llm для агентов. Формат llm — это компактный XML без лишних токенов, рассчитанный на передачу прямо в агента:
# LLM-optimized output, piped to Claude
seomator audit https://example.com --format llm | claude S0
Скилл для Claude Code и MCP-сервер
Установка скилла:
npx skills add seo-skills/seo-audit-skill
После этого аудит запускается прямо из чата: «Run an SEO audit on https://example.com» или «Audit https://mysite.com and tell me what to fix first».
Через MCP-сервер аудит доступен любому агенту:
claude mcp add seomator-audit -- npx -y @seomator/seo-audit mcp
По умолчанию сервер отказывается проверять приватные адреса. Флаг --allow-private разрешает аудит локальных и корпоративных сетей.
CI и конфигурация
Код выхода — вердикт аудита: 0 значит «пройдено», 1 — оценка ниже порога --fail-under (по умолчанию 70) или провалено правило с флагом fail_ci, 2 — ошибка запуска, 130 — прогон прерван. Поэтому в CI достаточно просто запустить команду.
Порог и правила настраиваются в файле seomator.toml, который создаёт seomator init. Переопределения меняют приоритет правил и условия провала CI, но не оценку:
# seomator.toml
[ci]
fail_under = 80
[rules.override]
"core-canonical-present" = { fail_ci = true }
"url-underscores" = { priority = "ignore" }
Подробные гайды по условиям провала CI — в docs/ci-gates.md, все ключи конфигурации — в docs/configuration.md. Свои проверки описываются в том же файле — как это устроено, рассказано в docs/custom-checks.md.
История аудитов и сравнение прогонов
Каждый аудит сохраняется в локальную SQLite-базу ~/.seomator/audits.db. Команда seomator compare показывает разницу между двумя прогонами — удобно сравнить сайт до и после деплоя. Правила сравниваются по ID, поэтому «одно сломалось, другое починилось» не превратится в одно число.
Обход сайта также считает Link Score — внутреннюю метрику по ссылкам между страницами, устроенную как PageRank. Она показывает, какие страницы получают мало внутренних ссылок. На общую оценку она не влияет.
Десктоп-приложение и веб-панель
Приложение для Electron показывает прогресс аудита в реальном времени, историю оценок по домену и очередь исправлений, отсортированную по тому, сколько очков вернёт каждое. Команда seomator serve поднимает ту же панель в браузере на http://127.0.0.1:7360 — доступ по одноразовому токену, наружу панель запросов не отправляет.
Полная документация собрана в docs/README.md. Если ставить ничего не хочется, есть бесплатная веб-версия на seomator.com/free-seo-audit-tool.