Инструкции

Как установить SEOmator и запустить аудит сайта из командной строки

Команды установки SEOmator через npm и запуска аудита, альтернативный способ из исходников, коды завершения и разница между проваленным условием и неизмеренным параметром.

Понадобится

Не указано в README
  • Терминал с доступным npm
  • Для сборки из исходников — Git
  • Для Core Web Vitals с --cwv — системный Chrome, Chromium или Edge

README SEOmator описывает установку через npm и запуск аудита сайта из терминала. Ниже — команды из документации и объяснение кодов завершения, а также отдельного случая, когда проверка не смогла измерить параметр. Редакция не запускала программу самостоятельно.

Что нужно для запуска

Для приведённых ниже команд нужен терминал, в котором доступен npm. README также описывает сборку из исходников с помощью Git и npm. Для измерения Core Web Vitals с параметром --cwv документация указывает на системный Chrome, Chromium или Edge; для браузерного рендеринга в некоторых проверках отдельно упоминается параметр --render.

SEOmator предназначен для технического аудита сайта, а не для просмотра поискового трафика: README указывает, что данные Search Console пока не входят в аудит. В Telegram-посте автор заявляет о проверке по 398 параметрам и 20 категориям и обещает больше откликов и посетителей. Это рекламное заявление, а не подтверждённый результат тестирования. См. README SEOmator и пост в Telegram.

Установка и запуск аудита

README называет глобальную установку через npm рекомендуемым способом. Выполните в терминале:

npm install -g @seomator/seo-audit
seomator audit https://example.com

Замените https://example.com адресом сайта, который хотите проверить. Команды показывают порядок установки и запуска, но не гарантируют, что установка успешно завершится в конкретном окружении.

В качестве альтернативы README приводит запуск из исходников:

  1. Склонируйте репозиторий и перейдите в каталог проекта:
    git clone https://github.com/seo-skills/seo-audit-skill.git
    cd seo-audit-skill
  2. Установите зависимости и соберите проект:
    npm install
    npm run build
  3. Запустите аудит напрямую либо свяжите команду глобально:
    ./dist/cli.js audit https://example.com
    npm link
    seomator audit https://example.com
Последовательность: Склонируйте репозиторий и перейдите в каталог проекта: git clone https://github.com/seo-skills/seo-audit-skill.git cd seo-audit-skill; Установите зависимости и соберите проект: npm install npm run build; Запустите аудит напрямую либо свяжите команду глобально: ./dist/cli.js audit https://example.com npm link seomator audit https://example.com
Порядок действий из инструкции.

Это последовательности из документации проекта; конкретный отчёт на сайте в редакции не получали.

Как различать результат проверки и ошибку запуска

README описывает три кода завершения CLI:

  • 0 — проверка пройдена;
  • 1 — провалено заданное условие, или gate;
  • 2 — запуск не состоялся.

Код 1 не означает, что аудит не запускался: он сообщает о проваленном условии. Код 2 означает, что запуск не состоялся, поэтому его нельзя трактовать как результат успешного аудита. Устраните причину сбоя и повторите запуск.

Неизмеренный параметр — другой случай: проверка могла выполняться, но не получить значение по отдельному пункту. Согласно README, инструмент должен указать, что измерение не состоялось, и сообщить причину, например потребность в браузерном рендеринге или невозможность верификации, вместо того чтобы засчитать пункт как успешный. Рассматривайте такой результат как неопределённый, а не как пройденную проверку. Если вопрос касается Core Web Vitals, документация указывает на системный Chrome, Chromium или Edge; наличие браузера само по себе не гарантирует измерение каждого параметра.

Сколько страниц охватывает аудит

По README, обход по умолчанию рассчитан на 10 страниц, а для одного запуска командной строки указан предел до 1000 страниц. Это заданные масштабы обхода, а не обещание, что один аудит охватит все URL крупного сайта.

Технический аудит не показывает число переходов из поиска: данные Search Console в него пока не входят. Поэтому найденные технические проблемы сами по себе не измеряют поисковый трафик и не подтверждают обещание роста посещаемости.

Что учитывать при чтении документации

Команды установки, запуска и описанные ограничения приведены в README проекта. Документация не является независимым тестом полноты или точности аудита. Доступность npm-пакета и требования конкретной версии могут измениться; установленная версия и успешность запуска здесь не проверялись.

Шаги

По шагам
  1. Установить CLI

    | Выполнить npm install -g @seomator/seo-audit.

  2. Запустить аудит

    | Выполнить seomator audit https://example.com, подставив адрес сайта.

  3. Разобрать код завершения

    | Различать 0 (проверка пройдена), 1 (провалено условие) и 2 (запуск не состоялся).

  4. Разобрать неизмеренный параметр

    | Не считать его успешной проверкой; учитывать указанную инструментом причину.

Вопросы и ответы

Что означает код 1?

Провалено заданное условие (gate); это не то же самое, что несостоявшийся запуск.

Что означает код 2?

Запуск не состоялся.

Что означает неизмеренный параметр?

Проверка не получила значение для отдельного пункта; README указывает, что инструмент должен обозначить это и сообщить причину.

Показывает ли аудит поисковый трафик?

Нет, данные Search Console в аудит не входят.