Gerador de relatórios SEO: XLSX, DOCX, PDF

O report-build formata as evidências guardadas em XLSX, DOCX, CSV, Markdown, JSON ou em uma visão geral limitada em PDF. Ele formata as evidências e nunca inventa problemas.

O que faz

Formatos

Uma auditoria pode virar uma planilha de trabalho, um documento para o cliente ou um JSON legível por máquina. O XLSX traz as abas de problemas, páginas e escopo, e as abas grandes são divididas com um índice com hash. O DOCX abre com um resumo executivo de contagens e verificações indisponíveis, seguido das evidências. Ele não acrescenta conclusão nem recomendação própria.

  • xlsx: a planilha de auditoria factual para a equipe
  • docx: um documento para o cliente ou o gestor
  • csv: tabelas separadas para problemas, evidências de escopo e páginas
  • md e json: para um repositório ou outro agente

Visão geral em PDF

O PDF é uma visão de leitura limitada. A primeira página informa quantos problemas e páginas existem, quantos são mostrados e quantos ficaram de fora. Os arquivos JSON e CSV completos e um manifesto com hash são gravados ao lado, então nada se perde. O PDF é gerado localmente com Chrome, Edge ou Chromium e não faz nenhuma requisição de rede.

  • Entradas audit.v2 transmitidas exigem a opção explícita --pdf-policy overview-v1
  • O PDF e a pasta de arquivos que o acompanha precisam ser caminhos novos
  • Escolha o idioma do PDF com --lang en ou --lang ru

Pacotes para BI

Para muitos sites ou um painel, o bi-export transforma um scan ou uma auditoria salva em partições CSV tipadas e um manifesto versionado, com contagem de linhas e hashes SHA-256. Ele roda offline. Comandos de plano separados verificam um pacote para Google Sheets ou BigQuery sem acessar o Google, e gravar em um destino é uma etapa explícita à parte.

  • O bi-sheets-plan e o bi-bigquery-plan são offline e somente leitura
  • Valores desconhecidos ou indisponíveis ficam marcados, e um zero medido continua sendo zero
  • O bi-destination-apply exige autorização do host e nunca aceita credenciais

Três passos, um rastreamento salvo

  1. Forneça uma auditoria guardada

    Aponte o report-build para um JSON de auditoria ou para um artefato SQLite scan.v1. Ele lê as evidências salvas e não rastreia o site.

  2. Escolha o formato

    Gere xlsx, docx, csv, md ou json. O PDF é uma visão limitada e precisa de uma política explícita para auditorias transmitidas.

  3. Aplique uma visão salva

    Com --project e --view, mostra-se uma página limitada de problemas. Os totais continuam cobrindo a auditoria inteira.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
BROKEN_PAGE_4XXA página retorna uma resposta 4xxCriticalURL e código de status
REDIRECT_LOOPA cadeia de redirecionamentos volta para uma URL já visitadaCriticalCaminho do redirecionamento
TITLE_MISSINGA tag title está ausenteCriticalURL
H1_MISSINGA página não tem título H1ImportantURL
DESC_MISSINGA meta description está ausenteImportantURL
CANONICAL_MISSINGA página indexável não tem URL canônicaImportantURL
REDIRECT_CHAINA cadeia de redirecionamentos tem dois ou mais saltosImportantSaltos em ordem
URL_NOT_IN_SITEMAPA página indexável não está no sitemapTipURL

Um comando

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

Instale primeiro: guia de instalação. Todo comando também funciona como ferramenta MCP para agentes de IA.

O que você precisa

  • Uma auditoria salva em JSON ou um scan nativo (arquivo SQLite scan.v1)
  • Um caminho de saída com --out e um formato com --format
  • O extra reports para XLSX e DOCX (openpyxl, python-docx)
  • Chrome, Edge ou Chromium instalado localmente, somente para PDF

Limites

  • Ele formata uma auditoria salva. Não rastreia, não verifica de novo e não adiciona problemas
  • O PDF é uma visão geral, não uma listagem completa. Os dados completos estão nos arquivos JSON e CSV que o acompanham
  • Com --project e --view você obtém uma página limitada de problemas, mas os totais cobrem a auditoria inteira
  • O CSV é uma exportação simples, não um backlog agrupado. Para tarefas, use a lista de tarefas

Perguntas

O report-build rastreia meu site?
Não. Ele formata uma auditoria que você já produziu, a partir de um JSON de auditoria ou de um arquivo SQLite scan.v1. Execute antes o site-audit, o crawl-site ou um sf run.
Ele pode acrescentar problemas que a auditoria não registrou?
Não. Ele formata evidências e nunca inventa problemas. O relatório mostra o que a auditoria salvou, incluindo as verificações que foram puladas ou ficaram indisponíveis.
Posso gerar um PDF?
Sim, como uma visão geral limitada, com os arquivos JSON e CSV completos ao lado. Entradas audit.v2 transmitidas exigem --pdf-policy overview-v1. O PDF precisa de Chrome, Edge ou Chromium local. Escolha --lang en ou --lang ru.
Um relatório longo vira uma planilha enorme?
Não. O XLSX divide as abas grandes Findings e Pages e grava um índice com hash.
Qual formato devo enviar ao cliente?
O DOCX é o documento legível; o XLSX é a planilha para quem quer filtrar linhas. Os dois mostram as mesmas evidências salvas. Revise qualquer um dos arquivos antes de enviar.
Precisa de chaves ou custa dinheiro?
Não. O report-build funciona offline e não usa nenhum provedor. Ele grava apenas o arquivo que você indica com --out, mais a pasta de arquivos que acompanha o PDF.

Teste no seu próprio site