Audit SEO tecnico

Un unico registro dei controlli guida ogni audit, che le evidenze arrivino da export di Screaming Frog o da una scansione di SpiderHead. Gravità, sorgente delle evidenze e correzione vengono dallo stesso registro che legge il motore di regole, quindi una segnalazione non dice mai più di quanto il motore possa provare.

Cosa fa

Evidenze, non congetture

Ogni segnalazione nomina la URL, ciò che è stato osservato e una correzione. Per le segnalazioni sui link mostra anche dove sta il link nella pagina. Un controllo senza dati su cui girare viene riportato come skipped con un motivo, mai come superato.

  • Livelli di gravità: critical, warning e notice
  • Posizione del link e XPath per le segnalazioni sui link (dagli export Inlinks di Screaming Frog)
  • Ogni segnalazione porta un testo di correzione dal registro

Copertura onesta

Il rapporto conta quanti controlli hanno potuto girare sulle evidenze ricevute. Quando la copertura sta sotto la metà, il punteggio di salute è trattenuto. Una copertura più bassa marca anche il punteggio come non confrontabile con un run che aveva evidenze complete.

  • I controlli saltati sono elencati con l'input mancante
  • Nessun punteggio da troppo poche evidenze
  • Riesegui con più export per alzare la copertura

Dalle segnalazioni al backlog

Aggiungi il flag dei task e l'audit scrive anche tasks.json e tasks.md, una lista prioritizzata per gli sviluppatori con la correzione accanto a ogni segnalazione. Lo stesso audit può far fallire una build CI quando sono presenti segnalazioni della gravità scelta.

  • Lista di task in JSON e Markdown
  • Fallisci su segnalazioni critical o warning con un exit code non zero
  • Formati del report: json e md

Tre passaggi, una scansione salvata

  1. Puntalo sui tuoi export

    Dagli una cartella di export CSV o XLSX di Screaming Frog. Ogni controllo legge lo stesso registro, in qualunque modo siano state raccolte le evidenze.

  2. Esegui ogni controllo che le evidenze permettono

    Ogni controllo o riporta segnalazioni, torna pulito, o viene saltato con un motivo quando mancano i dati che gli servono.

  3. Ottieni le correzioni come lista di task

    Aggiungi --tasks per ottenere tasks.json e tasks.md, un backlog prioritizzato per gli sviluppatori con la correzione accanto a ogni segnalazione.

Controlli di questa funzionalità

ControlloCosa significaGravitàEvidenza
BROKEN_PAGE_4XXLa pagina risponde con uno stato 4xxCriticalExport Response Codes 4xx, URL e stato
SERVER_ERROR_5XXLa pagina risponde con uno stato 5xxCriticalExport Response Codes 5xx, URL e stato
TITLE_MISSINGLa pagina non ha l'elemento titleCriticalURL della pagina
BROKEN_INTERNAL_LINKUn link interno punta a una URL 4xxCriticalPagina di origine e posizione del link dall'export inlinks
H1_MISSINGLa pagina non ha l'intestazione H1ImportantURL della pagina
CANONICAL_MISSINGUna pagina indicizzabile non ha URL canonicalImportantURL della pagina
THIN_CONTENTLa pagina ha un conteggio di parole bassoImportantURL e conteggio parole
HEADING_BEFORE_H1Compaiono intestazioni prima del primo H1 della paginaTipStruttura delle intestazioni della 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, oppure una URL di partenza per una scansione
  • Il CLI di Screaming Frog con licenza, solo per le modalità di crawl di sf run
  • Nessuna chiave API per l'audit offline degli export

Limiti

  • I controlli senza le evidenze che servono vengono saltati, non inventati
  • Con pochi controlli eseguibili, il punteggio è trattenuto o marcato non confrontabile
  • Scansionare tramite Screaming Frog richiede la tua installazione con licenza
  • I controlli sulle pagine renderizzate richiedono una scansione con rendering, non export statici

Domande

Serve la licenza di Screaming Frog?
Non per leggere gli export. sf run --exports-dir analizza offline i file CSV o XLSX di Screaming Frog già esistenti. Scansionare tramite il CLI di Screaming Frog (--crawl) richiede un'installazione con licenza. crawl-site è il crawler di SpiderHead e verifica il suo risultato con gli stessi controlli.
Cosa succede quando un controllo non ha dati su cui girare?
Viene riportato come skipped, con il motivo. Non è mai mostrato come superato.
L'audit cambia il mio sito?
No. Legge export o scansioni salvate. Una scansione invia richieste in sola lettura alla frequenza che imposti; per le scansioni Screaming Frog la imposta --max-urls-per-second, e 1 o 2 richieste al secondo è una partenza rispettosa.
Un agente AI può eseguire l'audit?
Sì. Lo stesso audit è disponibile come strumenti MCP: sf_audit_run, sf_audit_issues, sf_audit_summary e sf_audit_tasks.
Posso far fallire una build CI sulle segnalazioni?
Sì. --fail-on critical o --fail-on warning restituisce un exit code non zero quando ci sono segnalazioni di quella gravità. Il predefinito è --fail-on none, quindi un run semplice non fallisce sulle segnalazioni.
Dove finiscono i risultati?
Nella cartella che passi con --out, come report locale (json e md). Nulla viene caricato online.