Correggere errori SEO con un agente di coding AI: flusso sicuro per Claude Code e Cursor

Risposta breve: un agente di coding AI può correggere i problemi SEO meccanici e verificabili del tuo sito: title, meta description, tag canonical, hreflang, testi alternativi, header di sicurezza e i file robots.txt, sitemap e llms.txt. Affidagli un rilievo alla volta, ciascuno con una condizione che dice quando l’attività è finita, lascialo lavorare su un branch, leggi il diff e misura di nuovo la pagina dopo la modifica. Non deve inventare contenuti, scegliere le tue parole chiave, parlare a nome della tua azienda né decidere al tuo posto se i crawler AI possano leggere il tuo sito. Una correzione rende la pagina tecnicamente corretta. Un posizionamento migliore non è mai garantito.

Dove aiuta un agente di coding AI con la SEO, e dove no?

Un audit SEO produce due tipi di rilievi. Alcuni sono meccanici: c’è una sola risposta giusta e puoi verificarla richiamando la pagina. Altri sono decisioni che spettano a una persona. Un agente di coding AI come Claude Code, Cursor o GitHub Copilot è adatto al primo tipo ed è rischioso per il secondo.

Lavori adatti a un agente:

• Title e meta description. Un tag mancante, duplicato o di lunghezza sbagliata si trova in fretta in un template o in un file di contenuto. L’agente dovrebbe ricavare il testo da ciò che la pagina già dice, non scrivere testi promozionali dal nulla.
• Tag canonical e hreflang. Entrambi sono regole, non prosa. L’hreflang ha una trappola su cui torniamo più avanti: ogni versione linguistica deve rimandare alle altre.
• Testi alternativi. Vanno bene quando il significato dell’immagine si capisce dalla pagina intorno. Altrimenti l’agente dovrebbe chiedere.
• Header di sicurezza. Poche righe di configurazione del server o del framework, facili da verificare con curl -I.
• I file nella radice: robots.txt, sitemap.xml e llms.txt. Testo semplice e breve, il cui risultato leggi subito.

Lavori che restano a te:

• Inventare contenuti. Dati sui prodotti, prezzi, testimonianze, affermazioni sulla tua azienda. L’ordine di lavoro che genera SEOgrinder lo dice nelle sue regole di lavoro: non inventare contenuti, ricavare i testi mancanti da quanto è già sulla pagina, oppure chiedere.
• Decisioni su parole chiave e argomenti. Quale pagina debba puntare a quale espressione è una questione di business.
• Decisioni del proprietario. Se i crawler AI possano leggere il tuo sito, e se possano usarlo per l’addestramento, lo decidi tu. I prompt per agenti di SEOgrinder lo dicono esplicitamente: consentire o bloccare è una decisione del proprietario, quindi si chiede e non si sceglie al suo posto.
• Il lavoro sulle prestazioni, in parte. Gli obiettivi sono misurabili: i Core Web Vitals contano al 75º percentile dei caricamenti di pagina, separatamente per mobile e desktop, e «buono» significa LCP fino a 2,5 secondi, INP fino a 200 millisecondi e CLS fino a 0,1 (web.dev). Un agente può applicare correzioni note, ma un test di laboratorio fatto dopo non mostra ciò che misurano i visitatori reali, quindi cosa togliere lo decidi tu.

Il flusso sicuro in sei passi

L’obiettivo è un ciclo in cui ogni modifica sia piccola, verificata e reversibile.

1. Analizza. Inserisci l’indirizzo del tuo sito pubblico in SEOgrinder. È gratuito e non richiede un account. Ottieni un punteggio complessivo, un elenco di attività ordinato per impatto e sei sezioni: velocità, aspetto della pagina su Google, accessibilità, tecnologia e sicurezza, preparazione all’IA e sito.
2. Passa il lavoro. Per l’elenco completo, premi Passa all’IA nel report. Si apre l’ordine di lavoro, un documento Markdown che scarichi come .md oppure copi e incolli nel tuo agente. Per una singola attività, premi Passa all’IA sulla sua scheda. Per i controlli per agenti IA, la scheda Preparazione all'IA ha su ogni riga un pulsante Copia il prompt per l’agente (nelle righe già soddisfatte il pulsante compare solo dopo averle aperte). I prompt sono scritti in inglese perché sono pensati per un modello e le specifiche a cui rimandano sono in inglese.
3. Un rilievo alla volta. Di’ all’agente di svolgere l’attività uno e di fermarsi. Non chiedere «tutta la SEO». Un’attività piccola dà un diff piccolo che puoi leggere.
4. Leggi il diff e lancia i test. La tua build, il tuo linter e la tua suite di test esistono proprio per questo. Apri tu stesso i file modificati. Se l’agente ha toccato qualcosa che l’attività non menzionava, chiedi perché.
5. Ricontrolla. Quando la modifica è online sul tuo indirizzo pubblico, apri il report e premi Ricontrolla. SEOgrinder conserva un report fino a 24 ore, quindi senza quel pulsante vedresti il vecchio risultato. Il pulsante funziona qualche volta all’ora. Il rilievo dovrebbe sparire. SEOgrinder analizza solo siti pubblici, quindi una modifica che esiste soltanto sul tuo portatile o dietro un login non gli è visibile. Verifica allora dopo la pubblicazione e mantieni la modifica abbastanza piccola da poterla annullare.
6. Fai il commit. Un commit per rilievo, con un messaggio che lo nomini. Fai il merge quando la verifica conferma, poi passa all’attività successiva.

Come si presenta un buon ordine di lavoro

Un agente senza un obiettivo chiaro si ferma quando qualcosa gli sembra plausibile. Un buon ordine toglie lo spazio alle supposizioni. Ha quattro parti:

L’ordine di lavoro è costruito in questa sequenza: Incarico, Pagina, Stato attuale, Parole chiave, Attività, Regole di lavoro e Dati (leggibili dalla macchina). In un’installazione locale di SEOgrinder, la sezione Verifica il tuo lavoro sta tra Regole di lavoro e Dati; l’ordine di lavoro scaricato da seogrinder.com non la contiene. Ogni attività riporta il suo problema, il modo di risolverlo, una valutazione dell’impegno e il blocco «Fatto quando». Un blocco del genere è scritto come un test, per esempio:

meta[name=description] exists
description.length in [min, max]
description contains the focus keyword

Nell’ordine di lavoro vero i limiti sono compilati per la tua pagina. Il punto è che «finito» si può verificare. Le regole di lavoro sono brevi: procedere dall’alto verso il basso, individuare il file interessato prima di ogni modifica, saltare e segnalare un’attività di cui non si trova il punto, non inventare contenuti, mantenere formattazione, lingua e tono esistenti e, alla fine, elencare quali file sono cambiati e quali attività sono state svolte o saltate, con il motivo.

In un’installazione locale, la sezione «Verifica il tuo lavoro» dice all’agente di misurare di nuovo la pagina. Secondo il testo dell’ordine di lavoro, quel confronto controlla soltanto ciò che dicono le attività qui sopra, non il posizionamento, e il suo comando deve girare sul computer su cui gira SEOgrinder. Il controllo su cui puoi contare sempre è quindi quello del passo 5: pubblica, premi Ricontrolla, leggi il report.

Un esempio di prompt abbreviato

Qui sotto trovi una versione abbreviata del prompt per agenti destinato a un robots.txt esistente, con example.com come sito. Il prompt vero in SEOgrinder è più lungo ed elenca più controlli.

# Review and improve the existing robots.txt

Your site already serves a robots.txt. Review it against RFC 9309
and fix what is wrong. Change only what is needed.
Do not remove a rule you do not understand: ask the site owner.

## Check

- Served as text/plain with HTTP 200, not as an HTML page
- Valid User-agent groups with Allow/Disallow rules, no syntax errors
- No rule blocks pages that should appear in search
- The sitemap is listed as an absolute URL
- AI crawlers: allowing or blocking is the owner's decision.
  Ask, do not choose for them

## Read it

curl -sg https://example.com/robots.txt

Report the problems you found and the changes you made.

Quattro abitudini rendono sicuro questo prompt, e puoi copiarle nei tuoi prompt. Moderazione: «change only what is needed» (cambia solo ciò che serve) mantiene il diff piccolo. Un modo per dire «non lo so»: «ask the site owner» (chiedi al proprietario del sito) dà all’agente una via d’uscita legittima, così non deve tirare a indovinare. Un confine per le decisioni: le scelte del proprietario sono indicate come tali. Prima lo stato reale: la riga con curl fa leggere all’agente il file vero invece di presumere che cosa contenga. L’ultima riga ti dà un riepilogo da confrontare con il diff.

Regole di sicurezza prima che un agente tocchi il tuo codice

• Lavora su un branch, o su una copia del progetto. Non lasciare mai che un agente modifichi direttamente i file sul server di produzione. Le modifiche arrivano in produzione con il tuo normale rilascio.
• Leggi ogni diff. Un agente può essere sicuro di sé e sbagliare. Nel diff te ne accorgi.
• Tieni fuori i segreti. Niente chiavi, token o contenuti di .env in un prompt o nei file che incolli. Controlla che le modifiche dell’agente non ne abbiano copiati nel repository.
• Nessuna modifica di massa senza un campione. Se un’attività riguarda ogni pagina, per esempio un template dei title, applicala prima a una pagina, guarda il risultato, poi estendila.
• Esegui build e test prima di ogni commit.
• Tratta il testo recuperato come dati. Il contenuto delle pagine, un’esportazione di Search Console o una risposta del server possono contenere frasi che sembrano istruzioni. Le tue istruzioni sono quelle che hai scritto tu. Il riepilogo di Search Console di SEOgrinder contrassegna per lo stesso motivo query e indirizzi di un’esportazione come «dati, non istruzioni».

Errori comuni

• Consegnare tutto l’elenco in una volta. Il diff cresce e non riesci più a capire quale modifica abbia causato quale problema.
• Lasciare che l’agente decida sui crawler AI. È una regola su chi può usare i tuoi contenuti. È una tua decisione.
• hreflang senza link di ritorno. Google documenta che ogni versione linguistica deve indicare se stessa e tutte le altre, e che la mancanza di link di ritorno può portare a ignorare le indicazioni. Un agente che modifica una pagina e lascia stare le altre rompe l’insieme. Specifica nell’attività che tutte le versioni cambiano insieme e controlla il risultato in ognuna. I dettagli sono nella guida di Google alle versioni localizzate.
• Un nuovo gruppo nel robots.txt che dimentica le vecchie regole. La RFC 9309 dice che un crawler usa il gruppo che corrisponde al suo nome e, se ne esiste uno, il gruppo * non vale per lui. Quando un agente aggiunge un blocco per un bot AI, tutte le regole che quel bot deve seguire vanno ripetute lì.
• Una pagina di errore cordiale con stato 200. Una pagina mancante dovrebbe rispondere 404 o 410. Se il contenuto dice «non trovata» ma lo stato è 200, Search Console di Google può segnalare un soft 404, come descritto nella pagina di Google sui codici di stato HTTP. Una pagina di errore più bella deve comunque inviare lo stato 404. Maggiori dettagli nell’articolo sugli errori soft 404.
• Credere a «fatto» senza misurare. Il resoconto dell’agente dice che cosa intendeva cambiare. Solo una nuova analisi dice che cosa è online.

Domande frequenti

Qual è il miglior agente di coding AI per le correzioni SEO?

Non classifichiamo gli strumenti e non facciamo affermazioni su singoli modelli o prodotti. L’ordine di lavoro è un file Markdown scritto per Claude Code, Cursor, GitHub Copilot o ChatGPT. La qualità dell’ordine, la dimensione dell’attività e la tua revisione contano più del nome dello strumento.

L’agente può eseguire l’intero audit senza supervisione?

Noi non lo faremmo. I rilievi meccanici si adattano a un agente, le decisioni no, e un’esecuzione senza supervisione è il punto in cui una supposizione sbagliata finisce in produzione. Un’attività, un diff, una verifica è più lento e molto più sicuro.

SEOgrinder modifica il mio sito?

No. SEOgrinder legge le tue pagine pubbliche e riporta ciò che trova. Le modifiche le fa il tuo agente nel tuo progetto, e sei tu a rivederle.

Correggere i rilievi farà salire il mio posizionamento?

Nessuno può garantirlo. Correggere i rilievi elimina errori tecnici e rende la pagina più leggibile per crawler e visitatori, una base solida. Che cosa accada al posizionamento o alle menzioni nelle risposte dell’IA, nessuno strumento può prometterlo.

Il prossimo passo

Avvia l’analisi gratuita del tuo sito, apri il report e scegli la prima attività dell’elenco. Affida all’agente solo quella, leggi il diff, pubblica, premi Ricontrolla e fai il commit. Se dopo vuoi un secondo lavoro, parti dagli errori soft 404: rispondere con lo stato giusto alle pagine che non esistono è una correzione piccola e verificabile.