Анализатор экспортов Screaming Frog

Укажите SpiderHead папку с CSV- или XLSX-экспортами Screaming Frog и получите аудит и приоритизированный список задач. Обычный запуск работает офлайн: ни установка Screaming Frog, ни лицензия, ни запрос к сайту не нужны.

Что делает

Два режима

Режим B анализирует экспорты, которые вы уже сделали в Screaming Frog. Он читает файлы с диска и лицензии не требует. Режим A управляет отдельно установленным лицензированным CLI Screaming Frog: тот сканирует сайт, а затем SpiderHead анализирует результат.

  • Режим B: sf run с --exports-dir, полностью офлайн.
  • Режим A: --crawl URL, --crawl-list FILE или --load-crawl FILE.seospider с вашей лицензией Screaming Frog.
  • sf doctor проверяет локальную настройку перед стартом.

Что вы получаете

Папка отчёта содержит audit.json и audit.md. С флагом --tasks появляются tasks.json и tasks.md, то есть приоритизированный бэклог. Каждая задача содержит шаги воспроизведения, позицию ссылки на странице и предложенное исправление.

  • --format json,md выбирает форматы отчёта.
  • Проверка, для которой нет экспорта, помечается как skipped с причиной и никогда не засчитывается как пройденная.
  • --fail-on critical или warning задаёт ненулевой код выхода для CI.

Добавьте данные поиска и трафика

С флагом --project DIR команда sf run соединяет с аудируемыми страницами последнюю полную 28-дневную историю Search Console, GA4 и Метрики, которая хранится в этом проекте. При этом провайдеры не опрашиваются. Отдельный флаг --gsc-inspect, который включается по желанию, читает статус индексации Google для выборки до 50 URL.

  • Находки провайдеров сохраняют источник в audit.json и audit.md.
  • Отсутствующие привязки и урезанные выгрузки остаются недоступными или частичными.
  • Отрицательные находки вроде страниц-сирот требуют полного покрытия провайдеров и полного сканирования.

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

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

    Дайте папку с CSV- или XLSX-экспортами Screaming Frog. Анализ идёт офлайн и не отправляет запросов на сайт.

  2. Запустите реестр проверок

    Один и тот же реестр оценивает каждый экспорт. Проверка без данных помечается как skipped с причиной и никогда не засчитывается как пройденная.

  3. Получите приоритизированный бэклог

    audit.json, audit.md и tasks.md/tasks.json перечисляют каждую проблему с шагами воспроизведения, позицией ссылки и исправлением.

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

ПроверкаЧто значитКритичностьДоказательство
BROKEN_PAGE_4XXСтраница отдаёт ответ 4xxCriticalЭкспорт Response Codes 4xx
BROKEN_INTERNAL_LINKВнутренняя ссылка ведёт на URL с ответом 4xxCriticalЭкспорт Inlinks: исходная страница и позиция ссылки
REDIRECT_LOOPЦепочка редиректов возвращается на URL, который уже был в нейCriticalОтчёт Redirect Chains
TITLE_MISSINGУ страницы нет элемента titleCriticalВычисляется из данных Page Titles
REDIRECT_CHAINДва и больше редиректа до финального URLImportantОтчёт Redirect Chains
DESC_DUPLICATEОдинаковое мета-описание на нескольких страницахImportantВычисляется из данных о мета-описаниях
TITLE_TOO_LONGTitle длиннее заданного порога длиныTipВычисляется из данных Page Titles

Одна команда

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

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

Что нужно

  • Папка с CSV- или XLSX-экспортами Screaming Frog (--exports-dir)
  • Необязательно: config.json с порогами (--config)
  • Только для режима A: лицензированный CLI Screaming Frog и стартовый URL, список URL или сохранённый файл .seospider

Ограничения

  • Аудит видит только то, что есть в экспортах. Проверка без своего экспорта пропускается.
  • Для режима A нужна лицензия Screaming Frog. SpiderHead её не предоставляет и не поставляет.
  • Сверка данных sitemap и robots по сети выполняется только с флагом --live-recheck.
  • Предложенные исправления на сайт не применяются.

Вопросы

Нужна ли установленная Screaming Frog, чтобы этим пользоваться?
Для анализа — нет. Режим B читает экспорты, которые вы уже сделали в Screaming Frog, и не делает запросов к сайту. Screaming Frog и лицензия нужны только для режима A, где SpiderHead управляет CLI Screaming Frog для сканирования. Сам SpiderHead не требует ключа или аккаунта.
Что происходит с проверкой, у которой нет данных?
Она помечается как skipped с причиной. Её никогда не выводят как чистую, поэтому 0 проблем всегда значит, что проверка действительно прошла.
Меняет ли инструмент что-нибудь на сайте или в моих файлах?
Нет. Он читает экспорты и пишет файлы отчётов в папку, которую вы укажете. Предложенные исправления применяете вы.
В чём разница между audit.md и tasks.md?
audit.md перечисляет находки. tasks.md — приоритизированный бэклог: для каждой проблемы шаги воспроизведения, позиции ссылок и исправление. Чтобы его получить, передайте --tasks.
Можно ли использовать это в CI?
Да. Передайте --fail-on critical (или warning): при наличии проблем такой серьёзности команда возвращает ненулевой код выхода.
Можно ли анализировать экспорты других краулеров?
Не через sf run: он ждёт экспорты Screaming Frog. Для других инструментов crawl-import читает набор CSV, который вы сопоставляете с помощью манифеста. Результат — отдельный документ стороннего сканирования, а не аудит.

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