Analizzatore di export Screaming Frog

Punta SpiderHead a una cartella di export CSV o XLSX di Screaming Frog e ottieni un audit e una lista di task prioritizzata. L'esecuzione predefinita è offline: non serve installazione Screaming Frog, licenza né richieste al sito.

Cosa fa

Due modalità

La modalità B analizza export che hai già fatto in Screaming Frog. Legge file dal tuo disco e non richiede licenza. La modalità A guida un CLI Screaming Frog installato a parte e con licenza, lo lascia scansionare, poi analizza il risultato.

  • Modalità B: sf run con --exports-dir, completamente offline.
  • Modalità A: --crawl URL, --crawl-list FILE o --load-crawl FILE.seospider, con la tua licenza Screaming Frog.
  • sf doctor verifica l'ambiente locale prima di iniziare.

Cosa ottieni

La cartella del rapporto contiene audit.json e audit.md. Con --tasks contiene anche tasks.json e tasks.md, un backlog prioritizzato. Ogni task elenca i passaggi di riproduzione, la posizione del link nella pagina e la correzione suggerita.

  • --format json,md sceglie i formati del report.
  • Un controllo il cui export manca è marcato skipped con un motivo, mai contato come superato.
  • --fail-on critical o warning imposta un exit code non zero per la CI.

Aggiungi dati di ricerca e traffico

Con --project DIR, sf run unisce alle pagine auditate l'ultimo storico completo di 28 giorni di Search Console, GA4 e Metrika conservato in quel progetto. Non contatta alcun provider mentre lo fa. Un --gsc-inspect separato e opt-in legge lo stato di indicizzazione di Google per un campione fino a 50 URL.

  • Le segnalazioni dei provider conservano la loro sorgente in audit.json e audit.md.
  • Binding mancanti e letture troncate restano non disponibili o parziali.
  • Le segnalazioni negative come le orfane richiedono una copertura completa dei provider e una scansione completa.

Tre passaggi, una scansione salvata

  1. Puntalo sui tuoi export

    Dagli una cartella di export CSV o XLSX di Screaming Frog. L'analisi gira offline e non invia richieste al sito.

  2. Esegui il registro dei controlli

    Lo stesso registro punteggia ogni export. Un controllo senza dati è marcato skipped con un motivo, mai contato come superato.

  3. Ottieni un backlog prioritizzato

    audit.json, audit.md e tasks.md/tasks.json elencano ogni problema con passaggi di riproduzione, posizione del link e correzione.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
BROKEN_PAGE_4XXLa pagina restituisce una risposta 4xxCriticalExport Response Codes 4xx
BROKEN_INTERNAL_LINKUn link interno punta a una URL 4xxCriticalExport Inlinks: pagina di origine e posizione del link
REDIRECT_LOOPLa catena di redirect torna a una URL già visitataCriticalReport Redirect Chains
TITLE_MISSINGLa pagina non ha l'elemento titleCriticalDerivato dai dati dei title di pagina
REDIRECT_CHAINDue o più hop di redirect prima della URL finaleImportantReport Redirect Chains
DESC_DUPLICATEStessa meta description su più di una paginaImportantDerivato dai dati delle meta description
TITLE_TOO_LONGIl title supera la soglia di lunghezza configurataTipDerivato dai dati dei title di pagina

Un solo comando

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

Prima installa SpiderHead: guida all'installazione. Ogni comando funziona anche come strumento MCP per agenti AI.

Cosa ti serve

  • Una cartella di export CSV o XLSX di Screaming Frog (--exports-dir)
  • Opzionale: un config.json per le soglie (--config)
  • Solo modalità A: un CLI Screaming Frog con licenza e una URL di partenza, lista di URL o file .seospider salvato

Limiti

  • L'audit vede solo ciò che contengono gli export. Un controllo senza il suo export è saltato.
  • La modalità A richiede una licenza Screaming Frog che SpiderHead non fornisce né include.
  • I ricontrolli di rete su dati sitemap e robots avvengono solo se passi --live-recheck.
  • Le correzioni suggerite non sono applicate al tuo sito.

Domande

Serve Screaming Frog installato per usarlo?
Non per l'analisi. La modalità B legge export che hai già fatto in Screaming Frog e non invia richieste al sito. Screaming Frog e una licenza servono solo nella modalità A, dove SpiderHead guida il CLI di Screaming Frog per scansionare. SpiderHead stesso non richiede chiavi né account.
Cosa succede a un controllo senza dati?
È marcato skipped con il motivo. Non è mai riportato come superato, quindi 0 problemi significa sempre che il controllo è girato.
Cambia qualcosa sul mio sito o nei miei file?
No. Legge gli export e scrive file di report nella cartella di output che indichi. Le correzioni suggerite sei tu ad applicarle.
Che differenza c'è tra audit.md e tasks.md?
audit.md elenca le segnalazioni. tasks.md è il backlog prioritizzato, con passaggi di riproduzione, posizioni dei link e una correzione per ogni problema. Passa --tasks per ottenerlo.
Posso usarlo in CI?
Sì. Passa --fail-on critical (o warning) e il comando restituisce un exit code non zero quando quella gravità è presente.
Posso analizzare export di un altro crawler?
Non con sf run, che si aspetta export Screaming Frog. Per altri strumenti, crawl-import legge un bundle CSV che mappi con un manifest. Produce un documento di scansione di terze parti separato, non un audit.