Come faccio un audit SEO tecnico e di visibilità AI con Claude Code?
Fallo in tre passaggi. Prima fai leggere a Claude Code il repository per metadati, sitemap, regole di robots e dati strutturati. Poi fagli controllare il sito pubblicato con curl, come browser e come crawler AI, perché il codice non è ciò che ricevono i crawler. Infine verifica la visibilità AI: cosa citano ChatGPT e gli altri per le tue domande, e Search Console.
Dati
- Lo strumento WebFetch di Claude Code esegue un prompt sulla pagina con una chiamata separata al modello ed è “lossy by design”, cioè per sua natura perde dettagli; la documentazione indica curl via Bash per la pagina non elaborata. (Documentazione Claude Code: Riferimento agli strumenti)
- Google elabora i siti JavaScript in 3 fasi, scansione, rendering e indicizzazione, e dice che non tutti i bot possono eseguire JavaScript. (Google Search Central: Nozioni di base sulla SEO per JavaScript)
- OpenAI dice che le modifiche a robots.txt richiedono circa 24 ore per avere effetto sulla ricerca di ChatGPT, che usa il crawler OAI-SearchBot. (OpenAI: Panoramica dei crawler di OpenAI)
- L'API di Search Console consente 2.000 ispezioni URL al giorno e 600 al minuto per sito. (API di Google Search Console: Limiti di utilizzo)
Perché leggere il codice non basta per un audit SEO?
Perché i crawler ricevono il sito pubblicato, non il tuo repository. Un firewall o una sfida anti-bot, un robots.txt modificato dall'hosting, una pagina che mostra il testo solo con JavaScript o un noindex aggiunto da un plugin non compaiono mai nel codice. Claude Code controlla ciò che legge, quindi deve anche scaricare le pagine online.
Cosa deve controllare l'audit, e dove?
Dividi ogni controllo tra repository e sito online:
| Controllo | Dove | Cosa intercetta |
|---|---|---|
| Titoli, descrizioni, intestazioni, canonical | Repository, poi HTML servito | Tag mancanti o duplicati |
| robots.txt e sitemap | Sito online | Crawler AI bloccati, pagine assenti dalla sitemap |
| Codice di stato come browser e come GPTBot | Sito online | Un firewall o una sfida anti-bot che blocca i crawler AI |
| Testo principale presente senza JavaScript | Sito online | Pagine che arrivano vuote ai crawler |
| noindex e JSON-LD | HTML servito | Pagine nascoste alla ricerca, dati strutturati non validi o mancanti |
| Indicizzazione | Search Console | Pagine che Google non ha indicizzato |
Come controlla Claude Code il sito online?
Chiedigli di eseguire curl via Bash sugli URL pubblicati. WebFetch restituisce il riepilogo della pagina fatto da un modello, quindi può perdere tag; curl restituisce la risposta grezza. Questi comandi coprono i controlli che il codice non può mostrare:
# Eseguili sul sito pubblicato, non sul repository
SITE=https://example.com
# 1. Stessa pagina per un browser e per un crawler AI? (firewall, sfide anti-bot)
curl -s -o /dev/null -w "%{http_code}\n" -A "Mozilla/5.0" $SITE/
curl -s -o /dev/null -w "%{http_code}\n" -A "GPTBot" $SITE/
# 2. robots.txt e sitemap come vengono serviti
curl -s $SITE/robots.txt
curl -s $SITE/sitemap.xml | head -20
# 3. Il testo principale è nell'HTML prima che parta il JavaScript?
curl -s $SITE/some-page | grep -c "una frase della pagina"
# 4. noindex, canonical e JSON-LD nell'HTML servito
curl -s $SITE/some-page | grep -iE 'noindex|rel="canonical"|ld\+json'Come faccio un audit della visibilità AI, non solo SEO?
Fai le domande che i tuoi acquirenti rivolgono a ChatGPT, Claude, Perplexity e Gemini, e annota quali fonti cita ogni risposta. Fallo sempre nello stesso modo ogni mese, così un cambiamento ha significato. Aggiungi Search Console per indicizzazione e ricerche Google, e i dati di analytics per le visite dagli assistenti AI.
Come trasformo l'audit in correzioni senza rompere il sito?
Chiedi a Claude Code un elenco di problemi con le prove per ciascuno, poi correggili in piccole modifiche riviste. Dopo ogni deploy, ripeti i controlli sul sito online: una correzione conta quando il sito pubblicato la mostra, non quando l'agente dice che è fatta.
Passo dopo passo
- Controlla il repository. Chiedi a Claude Code di elencare metadati mancanti, regole di sitemap e robots e dati strutturati per tipo di pagina.
- Controlla il sito online. Fagli eseguire curl sugli URL pubblicati come browser e come GPTBot, e leggere robots.txt, la sitemap e l'HTML grezzo.
- Verifica l'indicizzazione. Apri Search Console e controlla quali pagine Google ha indicizzato.
- Verifica le risposte AI. Fai le domande dei tuoi acquirenti negli assistenti principali e annota le fonti citate.
- Correggi e ricontrolla. Correggi con piccole modifiche, fai il deploy e ripeti i controlli sul sito online prima di chiudere ogni problema.
Errori comuni
- Fidarsi di un audit che ha letto solo il repository.
- Usare i riepiloghi di WebFetch per giudicare tag che si vedono solo nell'HTML grezzo.
- Rimuovere un blocco in robots.txt che il titolare ha messo di proposito, senza chiedere.
- Chiudere un problema sulla parola dell'agente invece di ricontrollare il sito online.
Come lo risolve easyIndex
easyIndex esegue l'audit dall'esterno: il tuo agente di codifica fa ogni modifica, e easyIndex controlla da sé il sito online, quindi un passo si chiude su prove e non sul resoconto dell'agente. Poi mostra le visite dagli assistenti AI per pagina, quali pagine leggono i crawler AI e quando, e l'indicizzazione e le ricerche Google da Search Console, per US$ 30 per sito al mese dopo una prova gratuita di 7 giorni. Collegalo con claude mcp add --transport http easyindex https://easyindex.app/api/mcp.
Domande frequenti
Esiste una skill SEO pronta per Claude Code?
Esistono skill SEO gratuite e open source; la maggior parte legge il repository, quindi abbinale ai controlli sul sito pubblicato.
Ogni quanto va ripetuto l'audit?
Dopo ogni deploy che tocca i template, robots.txt o l'hosting, e una volta al mese per le risposte AI.
Claude Code può usare i dati di Search Console?
Sì, tramite un server MCP di Search Console o un'esportazione; l'API consente 2.000 ispezioni URL al giorno per sito.
Un audit mi fa citare da ChatGPT?
Nessun audit garantisce citazioni. Elimina ciò che impedisce ai crawler di leggere le pagine; le pagine devono comunque rispondere alla domanda.
Continua a leggere
- Skill SEO di Claude Code o server MCP: quale mi serve per comparire in ChatGPT?
- Quali crawler AI esistono e come li consento in robots.txt?
- ChatGPT e Claude vedono il mio sito fatto in JavaScript?
- Come aggiungo lo schema markup (JSON-LD) al mio sito con Claude Code o Codex?
- Cos'è la checklist GEO per un sito?
- Come funziona easyIndex, cosa mi serve e quanto tempo ci vuole per vedere i risultati?
Verificato il .