SEOmator — SEO-аудит по 398 правилам: CLI, десктоп-приложение и скилл для Claude Code

· 5 мин чтения
skills seo audit cli claude-code
📂 Исходный код на GitHub

SEOmator — open-source SEO-аудит по 398 правилам в 20 категориях: CLI, десктоп-приложение, MCP-сервер и скилл для Claude Code

SEOmator — SEO-аудит по 398 правилам: CLI, десктоп-приложение и скилл для 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.

Источник: https://github.com/seo-skills/seo-audit-skill