Настройки cookie

Необходимые cookies держат сайт рабочим. Аналитика показывает, какие страницы полезны. Выбор можно изменить в любой момент — из футера.

Политика cookie — подробно: категории cookie, как мы храним ваш выбор в браузере и как отозвать согласие.

Необходимые

Базовые функции сайта и ваш выбор согласия. Всегда включены.

Аналитика

Помогает понять, как используют сайт. Загружается только после вашего разрешения.

GitHubСкачать ZIP

Генератор SEO-отчётов: XLSX, DOCX, PDF

report-build переводит сохранённые доказательства в XLSX, DOCX, CSV, Markdown, JSON или ограниченный PDF-обзор. Инструмент только оформляет доказательства и не придумывает находки.

Открыть на GitHubБыстрый старт

Что делает

  • Терминал: seohead report-build formats

Форматы

Один аудит может стать рабочей таблицей, документом для клиента или JSON для машин. XLSX содержит листы находок, страниц и области работ; большие листы разбиваются, и для них создаётся индекс с хэшами. DOCX открывается резюме: сколько находок и недоступных проверок, затем идут доказательства. Своих выводов и рекомендаций документ не добавляет.

  • xlsx: фактическая рабочая книга аудита для команды
  • docx: документ для клиента или руководителя
  • csv: отдельные таблицы для находок, доказательств по области работ и страниц
  • md и json: для репозитория или другого агента

PDF-обзор

PDF — ограниченный вид для чтения. На первой странице сказано, сколько есть находок и страниц, сколько показано и сколько пропущено. Рядом записываются полные JSON, CSV и манифест с хэшами, поэтому ничего не теряется. PDF отрисовывается локально через Chrome, Edge или Chromium и не делает сетевых запросов.

  • Для потоковых входов audit.v2 нужен явный --pdf-policy overview-v1
  • PDF-файл и папка с сопутствующими файлами должны быть новыми путями
  • Язык PDF задаётся через --lang en или --lang ru

BI-пакеты

Для многих сайтов или дашборда bi-export превращает сохранённый скан или аудит в типизированные CSV-разделы и версионированный манифест с числом строк и хэшами SHA-256. Работает офлайн. Отдельные команды планирования проверяют пакет для Google Sheets или BigQuery, не обращаясь к Google. Запись в место назначения — отдельный явный шаг.

  • bi-sheets-plan и bi-bigquery-plan работают офлайн и только читают данные
  • Неизвестные или недоступные значения остаются помеченными, а измеренный ноль остаётся нулём
  • bi-destination-apply требует разрешения от среды запуска и никогда не принимает учётные данные

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

  1. Передайте сохранённый аудит

    Укажите report-build JSON аудита или артефакт scan.v1 SQLite. Инструмент прочитает сохранённые доказательства и не будет сканировать сайт.

  2. Выберите формат

    Запишите xlsx, docx, csv, md или json. PDF — ограниченный обзор, для потоковых аудитов нужна явная политика.

  3. Примените сохранённый вид

    С --project и --view показывается одна ограниченная страница находок. Итоги при этом считаются по всему аудиту.

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

ПроверкаЧто значитКритичностьДоказательство
BROKEN_PAGE_4XXСтраница отдаёт ответ 4xxCriticalURL и код статуса
REDIRECT_LOOPЦепочка редиректов возвращается к URL, который уже был в нейCriticalПуть редиректа
TITLE_MISSINGЭлемент title отсутствуетCriticalURL
H1_MISSINGНа странице нет заголовка H1ImportantURL
DESC_MISSINGОтсутствует мета-описаниеImportantURL
CANONICAL_MISSINGУ индексируемой страницы нет канонического URLImportantURL
REDIRECT_CHAINЦепочка редиректов из двух и более переходовImportantПереходы по порядку
URL_NOT_IN_SITEMAPИндексируемой страницы нет в sitemapTipURL

Одна команда

bash
seohead report-build --audit ./scans/audit.sqlite --format xlsx --out audit.xlsx

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

Что нужно

  • Сохранённый JSON аудита или нативный скан (файл SQLite scan.v1)
  • Путь для результата через --out и формат через --format
  • Дополнительный набор reports для XLSX и DOCX (openpyxl, python-docx)
  • Локально установленные Chrome, Edge или Chromium — только для PDF

Ограничения

  • Инструмент оформляет уже проведённый аудит. Он не сканирует, не перепроверяет и не добавляет находки
  • PDF — обзор, а не полный список. Все данные есть в JSON и CSV-файлах рядом
  • С --project и --view вы получаете одну ограниченную страницу находок, но итоги считаются по всему аудиту
  • CSV — плоская выгрузка, а не сгруппированный бэклог. Для задач используйте список задач

Вопросы

Сканирует ли report-build мой сайт?
Нет. Он оформляет уже проведённый аудит из JSON аудита или файла scan.v1 SQLite. Сначала запустите site-audit, crawl-site или SF run.
Может ли он добавить находки, которых нет в аудите?
Нет. Он оформляет доказательства и никогда не придумывает находки. В отчёте показано то, что сохранил аудит, включая пропущенные и недоступные проверки.
Можно ли получить PDF?
Да, как ограниченный обзор с полными JSON и CSV рядом. Для потоковых входов audit.v2 нужен --pdf-policy overview-v1. Для PDF нужны локальные Chrome, Edge или Chromium. Язык выбирается через --lang en или --lang ru.
Будет ли длинный отчёт одним огромным листом?
Нет. XLSX разбивает большие листы Findings и Pages и записывает индекс с хэшами.
Какой формат отправлять клиенту?
DOCX — читаемый документ, XLSX — рабочая книга для тех, кто хочет фильтровать строки. Оба показывают одни и те же сохранённые доказательства. Проверьте файл перед отправкой.
Нужны ли ключи и есть ли оплата?
Нет. report-build работает офлайн и не использует провайдеров. Он пишет только файл, указанный в --out, и папку с сопутствующими файлами для PDF.

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

Ещё в этой группе · Результаты

Список SEO-задач для разработчиковВозможностьВизуализация графа внутренних ссылокВозможность

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

Скачать ZIPВсе возможности