Rilevare i crawler IA

I robot IA (GPTBot, ClaudeBot, PerplexityBot…) recuperano il tuo HTML senza eseguire JavaScript. Il tag w.js non può quindi vederli: per contare la fase « Esplorato » del percorso IA serve un piccolo modulo lato server. Questa pagina spiega come installarlo.

#Perché un modulo lato server

Un tag di misurazione classico viene eseguito nel browser del visitatore. Un robot invece richiede la pagina e se ne va: nessun JavaScript viene eseguito, nessun evento viene inviato. Il modulo server colma questa lacuna. Osserva lo user-agent di ogni richiesta e, solo quando riconosce un robot IA, segnala la pagina a Snorklee.

Non tocca mai il traffico umano: i tuoi visitatori restano misurati dal solo w.js, senza doppi conteggi.

#Installare il modulo della tua piattaforma

Ogni file è pronto all'uso, senza dipendenze:

• WordPress — niente da fare, il modulo è incluso nel plugin ufficiale e attivo per impostazione predefinita.
• Cloudflare — cloudflare-worker.js, da distribuire come Worker. Funziona davanti a qualsiasi sito passato per il proxy di Cloudflare, compresi Shopify, Webflow o Wix.
• Next.js / Vercel — vercel-middleware.js, da inserire come middleware.js nella radice del progetto.
• Netlify — netlify-edge.js, da inserire in netlify/edge-functions/ con path /*.
• Node / Express — node-express.js, middleware da montare prima delle tue rotte.
• PHP — php-generic.php, da includere all'inizio della pagina fuori da WordPress.

Il modulo è non bloccante: non attende mai la risposta di Snorklee, e un guasto di rete dalla nostra parte non rallenta né rompe la tua pagina.

#Impostare il tuo dominio

All'inizio di ogni file c'è un solo valore da compilare: il tuo dominio. Deve essere identico all'attributo data-site del tuo snippet w.js.

Un valore diverso indica un sito che Snorklee non conosce: le segnalazioni vengono allora rifiutate e nella tua dashboard non appare nulla, senza alcun messaggio di errore visibile sul sito. È la prima cosa da verificare se il contatore resta a zero.

#Verificare che i robot arrivino

Apri la scheda Traffico IA. I passaggi dei robot compaiono nella card Crawler IA e nella console Chi legge cosa.

Non preoccuparti se entro un'ora non appare nulla: i robot passano secondo il loro ritmo, su un sito piccolo a volte una volta a settimana. Conta diversi giorni prima di concludere che c'è un problema.

#« L'indirizzo del robot non ci è mai arrivato »

Uno user-agent si falsifica in una riga di codice. Quando l'editore di un robot pubblica i suoi intervalli di indirizzi IP, Snorklee vi confronta ogni passaggio — è ciò che distingue un vero GPTBot da uno scraper che si spaccia per lui.

Questa verifica ha bisogno dell'indirizzo del robot, che il modulo trasmette in un header dedicato. Se la tua dashboard segnala passaggi « non verificabili », quell'indirizzo non arriva: il modulo è installato, ma una versione datata, o un proxy intermedio, ha perso l'informazione. Riprendi il file qui sopra nella sua versione attuale — non è una falsificazione, solo un'integrazione da aggiornare.

#Dove non è possibile

Su Wix, Squarespace, Webflow o Framer in hosting nativo, nessun codice può essere eseguito lato server sulla richiesta di pagina: il rilevamento dei crawler è lì impossibile. La dashboard lo dice chiaramente invece di mostrare uno zero fuorviante.

L'unico rimedio è mettere il dominio dietro Cloudflare e usare il Worker. Le visite umane provenienti dalle chat IA restano invece misurate normalmente su tutte queste piattaforme.