Analisador de exportações do Screaming Frog

Aponte o SpiderHead para uma pasta de exportações CSV ou XLSX do Screaming Frog e receba uma auditoria e uma lista de tarefas priorizada. A execução padrão é offline: não é preciso ter o Screaming Frog instalado, licença nem fazer requisições ao site.

O que faz

Dois modos

O modo B analisa exportações que você já fez no Screaming Frog. Ele lê os arquivos do seu disco e não precisa de licença. O modo A controla uma CLI do Screaming Frog instalada separadamente, com licença: deixa que ela rastreie e depois analisa o resultado.

  • Modo B: sf run com --exports-dir, totalmente offline.
  • Modo A: --crawl URL, --crawl-list FILE ou --load-crawl FILE.seospider, com a sua licença do Screaming Frog.
  • sf doctor verifica a configuração local antes de você começar.

O que você recebe

A pasta do relatório guarda audit.json e audit.md. Com --tasks, ela também guarda tasks.json e tasks.md, um backlog priorizado. Cada tarefa lista os passos para reproduzir, a posição do link na página e a correção sugerida.

  • --format json,md escolhe os formatos do relatório.
  • Uma verificação cuja exportação está ausente é marcada como ignorada, com o motivo, e nunca contada como aprovada.
  • --fail-on critical ou warning define um código de saída diferente de zero para o CI.

Adicione dados de busca e tráfego

Com --project DIR, o sf run cruza às páginas auditadas o último histórico completo de 28 dias do Search Console, do GA4 e do Metrika guardado nesse projeto. Nesse processo, nenhum provedor é consultado. Uma opção separada e voluntária, --gsc-inspect, lê o status de indexação do Google para uma amostra de até 50 URLs.

  • Os achados de provedores mantêm a origem em audit.json e audit.md.
  • Vínculos ausentes e leituras limitadas ficam indisponíveis ou parciais.
  • Achados negativos, como páginas órfãs, exigem cobertura completa do provedor e um rastreamento completo.

Três passos, um rastreamento salvo

  1. Aponte para as suas exportações

    Informe uma pasta com exportações CSV ou XLSX do Screaming Frog. A análise roda offline e não envia nenhuma requisição ao site.

  2. Execute o registro de verificações

    O mesmo registro avalia todas as exportações. Uma verificação sem dados é marcada como ignorada, com o motivo, e nunca contada como aprovada.

  3. Receba um backlog priorizado

    audit.json, audit.md e tasks.md/tasks.json listam cada problema com os passos para reproduzir, a posição do link e a correção.

Verificações deste recurso

VerificaçãoO que significaGravidadeEvidência
BROKEN_PAGE_4XXA página responde com status 4xxCriticalExportação Response Codes 4xx
BROKEN_INTERNAL_LINKUm link interno aponta para uma URL com status 4xxCriticalExportação Inlinks: página de origem e posição do link
REDIRECT_LOOPA cadeia de redirecionamentos volta para uma URL que já foi visitadaCriticalRelatório Redirect Chains
TITLE_MISSINGA página não tem o elemento titleCriticalDerivada dos dados de títulos das páginas
REDIRECT_CHAINDois ou mais redirecionamentos antes da URL finalImportantRelatório Redirect Chains
DESC_DUPLICATEA mesma meta description aparece em mais de uma páginaImportantDerivada dos dados de meta description
TITLE_TOO_LONGO título excede o limite de tamanho configuradoTipDerivada dos dados de títulos das páginas

Um comando

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

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

O que você precisa

  • Uma pasta com exportações CSV ou XLSX do Screaming Frog (--exports-dir)
  • Opcional: um config.json com os limites (--config)
  • Somente no modo A: uma CLI licenciada do Screaming Frog e uma URL inicial, uma lista de URLs ou um arquivo .seospider salvo

Limites

  • A auditoria vê apenas o que as exportações contêm. Uma verificação sem a exportação correspondente é ignorada.
  • O modo A exige uma licença do Screaming Frog, que o SpiderHead não fornece nem inclui.
  • Novas verificações de dados de sitemap e robots pela rede acontecem somente se você passar --live-recheck.
  • As correções sugeridas não são aplicadas ao seu site.

Perguntas

Preciso ter o Screaming Frog instalado para usar?
Não para a análise. O modo B lê exportações que você já fez no Screaming Frog e não faz requisições ao site. Você precisa do Screaming Frog e de uma licença só no modo A, em que o SpiderHead controla a CLI do Screaming Frog para rastrear. O próprio SpiderHead não precisa de chave nem de conta.
O que acontece com uma verificação que não tem dados?
Ela é marcada como ignorada, com o motivo. Nunca é apresentada como aprovada, então 0 problemas sempre significa que a verificação foi executada.
Isso altera algo no meu site ou nos meus arquivos?
Não. Ele lê as exportações e grava os arquivos do relatório na pasta de saída que você indicar. As correções sugeridas são para você aplicar.
Qual é a diferença entre audit.md e tasks.md?
O audit.md lista os achados. O tasks.md é o backlog priorizado, com os passos para reproduzir, as posições dos links e uma correção para cada problema. Passe --tasks para gerá-lo.
Posso usar no CI?
Sim. Passe --fail-on critical (ou warning) e o comando retorna um código de saída diferente de zero quando essa severidade estiver presente.
Posso analisar exportações de outro rastreador?
Não com o sf run, que espera exportações do Screaming Frog. Para outras ferramentas, o crawl-import lê um pacote CSV que você mapeia com um manifesto. Ele gera um documento de rastreamento de terceiros, separado, e não uma auditoria.

Teste no seu próprio site