Технический SEO-аудит

Один реестр проверок управляет каждым аудитом, независимо от того, пришли доказательства из экспортов Screaming Frog или из сканирования SpiderHead. Важность, источник доказательств и исправление берутся из того же реестра, который читает движок правил. Поэтому находка никогда не утверждает больше, чем движок может доказать.

Что делает

Доказательства, а не догадки

Каждая находка называет URL, описывает, что именно замечено, и даёт исправление. Для находок по ссылкам показывается ещё и место ссылки на странице. Проверка, у которой нет данных, отмечается как пропущенная с причиной, а не как пройденная.

  • Уровни важности: critical, warning и notice
  • Позиция ссылки и XPath для находок по ссылкам (из экспортов Inlinks Screaming Frog)
  • Каждая находка содержит текст исправления из реестра

Честное покрытие

Отчёт показывает, сколько проверок смогли выполниться на переданных доказательствах. Если покрытие ниже половины, оценка здоровья не выставляется. Более низкое покрытие также помечает оценку как несопоставимую с запуском на полных доказательствах.

  • Пропущенные проверки перечислены с недостающими данными
  • Без оценки при недостатке доказательств
  • Перезапустите аудит с большим числом экспортов, чтобы поднять покрытие

От находок к списку задач

С флагом tasks аудит также записывает tasks.json и tasks.md: приоритизированный список для разработчиков с исправлением рядом с каждой находкой. Тот же аудит может уронить сборку CI, если найдены находки выбранной важности.

  • Список задач в JSON и Markdown
  • Падение при критичных или предупреждающих находках с ненулевым кодом выхода
  • Форматы отчёта: json и md

Три шага — один сохранённый скан

  1. Укажите экспорты

    Передайте папку с CSV- или XLSX-экспортами Screaming Frog. Каждая проверка читает один и тот же реестр, каким бы способом ни собрали доказательства.

  2. Запустите все проверки, которые позволяют доказательства

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

  3. Получите исправления списком задач

    Добавьте --tasks, и появятся tasks.json и tasks.md: приоритизированный бэклог для разработчиков с исправлением рядом с каждой находкой.

Проверки в этой возможности

ПроверкаЧто значитКритичностьДоказательство
BROKEN_PAGE_4XXСтраница отвечает статусом 4xxCriticalЭкспорт Response Codes 4xx: URL и статус
SERVER_ERROR_5XXСтраница отвечает статусом 5xxCriticalЭкспорт Response Codes 5xx: URL и статус
TITLE_MISSINGНа странице нет элемента titleCriticalURL страницы
BROKEN_INTERNAL_LINKВнутренняя ссылка ведёт на URL с кодом 4xxCriticalСтраница-источник и позиция ссылки из экспорта inlinks
H1_MISSINGНа странице нет заголовка H1ImportantURL страницы
CANONICAL_MISSINGУ индексируемой страницы нет канонического URLImportantURL страницы
THIN_CONTENTНа странице мало словImportantURL и количество слов
HEADING_BEFORE_H1Заголовки стоят до первого H1 страницыTipСтруктура заголовков страницы

Одна команда

bash
seohead sf run --exports-dir ./exports --out ./report --tasks

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • Папка с CSV- или XLSX-экспортами Screaming Frog или стартовый URL для сканирования
  • Лицензированный CLI Screaming Frog, только для режимов сканирования в sf run
  • API-ключи не нужны для офлайн-аудита экспортов

Ограничения

  • Проверки без нужных доказательств пропускаются, а не угадываются
  • Если выполнилось мало проверок, оценку не выставляем или помечаем как несопоставимую
  • Сканирование через Screaming Frog требует вашей собственной лицензированной установки
  • Проверки отрисованных страниц требуют сканирования с рендерингом, а не статичных экспортов

Вопросы

Нужна ли лицензия Screaming Frog?
Для чтения экспортов — нет. sf run --exports-dir анализирует готовые CSV- или XLSX-файлы Screaming Frog офлайн. Сканирование через CLI Screaming Frog (--crawl) требует лицензированной установки Screaming Frog. crawl-site — собственный сканер SpiderHead, его результат проверяется теми же проверками.
Что происходит, если у проверки нет данных?
Она отмечается как пропущенная с причиной. Как пройденную её не показывают.
Аудит меняет мой сайт?
Нет. Он читает экспорты или сохранённые сканирования. Сканирование отправляет только запросы на чтение с той скоростью, которую вы задали. Для сканирований Screaming Frog её задаёт --max-urls-per-second, а 1–2 запроса в секунду — вежливое начало.
Может ли аудит запустить ИИ-агент?
Да. Тот же аудит доступен как MCP-инструменты: sf_audit_run, sf_audit_issues, sf_audit_summary и sf_audit_tasks.
Можно ли уронить сборку CI из-за находок?
Да. --fail-on critical или --fail-on warning возвращает ненулевой код выхода, если есть находки такой важности. По умолчанию стоит --fail-on none, поэтому обычный запуск по находкам не падает.
Куда попадают результаты?
В папку, которую вы передаёте в --out, как локальный отчёт (json и md). Ничего не выгружается.

Что ещё посмотреть

Проверьте на своём сайте