La maggior parte dei team ha già un report di ranking su Google. È la scheda Prestazioni di Search Console, ordinata per clic e catturata in uno screenshot dentro una slide. Mostra le posizioni. Non mostra cosa è cambiato, perché è cambiato, né cosa dovrebbe fare qualcuno al riguardo.
Questo flusso lo risolve in una sola seduta. Definisci un insieme di query, consegni a Codex un contratto di report scritto e lo lasci produrre la stessa forma ogni settimana. La prima costruzione richiede circa 90 minuti. Ogni esecuzione successiva ne richiede meno di dieci.
Il flusso intero: gli export grezzi entrano, esce un report di forma fissa, e alla fine c'è una decisione umana.
Con cosa finirai
Per chi è: per chiunque risponda del reporting di un sito e abbia già accesso a Search Console. Non serve essere sviluppatori, ma serve un posto dove tenere file che Codex possa leggere.
Cosa avrai alla fine: un modello di report salvato, un file di istruzioni scritto che Codex segue a ogni esecuzione, e un report completo per una settimana reale.
Prerequisiti: una proprietà verificata in Search Console, una lista di 20-50 query che ti interessano davvero, un Codex con accesso a una cartella di progetto e il permesso di lettura sul repository del tuo sito se vuoi la versione avanzata.
Definizione di fatto: puoi passare il report a qualcuno che non fa SEO, e quella persona sa dirti quali tre query guardare e perché.
Tempo: circa 90 minuti per la prima costruzione, meno di 10 minuti per esecuzione dopo.
Perché il report Prestazioni non è un report di ranking
Search Console ti dà quattro colonne: clic, impression, CTR e posizione media. Quella è una tabella di misurazione. Un report di ranking deve rispondere a un altro insieme di domande, e i segnali del 2026 hanno allargato quel divario rispetto a prima.
Il sondaggio di esperti Zyppy, pubblicato il 9 settembre 2026, ha raccolto 13.665 punti dati da 131 professionisti. I segnali di clic e comportamento si sono fermati al 29,4%, i segnali di brand al 27,0% e la salute tecnica del SEO al 17,5%. Due dei tre segnali che superano la salute tecnica sono invisibili in una colonna di posizione. La nostra analisi di cosa cambiano quei numeri è nella guida pratica, ma la versione breve per il reporting è questa: se il tuo report mostra solo le posizioni, stai rendicontando il segnale che si è mosso meno di tutti.
È questo il divario che Codex chiude. Non ti dirà perché Google ha cambiato qualcosa. Metterà insieme le prove del cambiamento in modo abbastanza coerente da permettere a te di dirlo.
Prima di iniziare: quattro decisioni
Prendile prima di scrivere qualcosa, perché cambiarle dopo significa ricostruire il report.
- L'insieme di query. Da 20 a 50 query, raggruppate in due o tre secchielli che seguono il modo in cui ragiona il business. "Prodotto", "confronto", "supporto" funziona meglio di "volume alto / medio / basso".
- La finestra di confronto. Confronta gli ultimi 28 giorni con i 28 precedenti. Finestre più corte sono rumorose; più lunghe nascondono il cambiamento che stai cercando.
- La soglia. Decidi cosa conta come degno di nota. Una query che si sposta di più di cinque posizioni, o impression che variano di oltre il 30% con i clic fermi, sono valori predefiniti ragionevoli.
- Dove archiviare. Una cartella, una regola di denominazione.
reports/ranking/YYYY-MM-DD.mdpiù una sottocartelladata/per gli export grezzi. Codex ha bisogno di un posto di scrittura coerente.
Passo 1: esporta i dati grezzi
Apri Search Console, seleziona la proprietà e vai su Prestazioni. Imposta l'intervallo di date a 56 giorni perché il confronto 28 contro 28 sia possibile da un solo export, poi usa il pulsante Esporta per scaricare il CSV della scheda Query.
Fai lo stesso per Pagine, e per Dispositivi se prevedi di riportare la divisione tra mobile e desktop.
Output atteso: tre file CSV in data/, con la data dell'export nel nome.
Controllo di qualità: apri il CSV delle query e verifica che la prima riga di dati non sia una query contenente la parola "anonymous". Search Console oscura le query rare, e quelle righe finirebbero altrimenti nel report come movimento senza nome.
Se fallisce: se l'export è troncato, il tuo intervallo di date è troppo ampio per il limite di righe. Esporta finestre di 28 giorni separatamente e lascia che Codex le concateni.
Passo 2: scrivi il contratto del report
Questo è il passo che decide se il flusso sopravvive oltre la terza settimana. Metti il contratto in un file che Codex legge a ogni esecuzione: AGENTS.md nella radice del progetto, o un file di istruzioni dedicato nella cartella dei report.
Il contratto ha bisogno di cinque cose e di nient'altro:
Blocco del contratto | Cosa scrivere | Perché conta |
|---|---|---|
Input | Percorsi esatti dei file e regola dell'intervallo di date | Impedisce all'agente di inventare una finestra |
Soglie | Le tue fasce, in numeri | Trasforma una tabella in una decisione |
Forma dell'output | Le tre sezioni, in quest'ordine | Mantiene la settimana 30 confrontabile con la settimana 1 |
Regole di confidenza | Cosa dire quando i dati non spiegano un cambiamento | Evita sciocchezze sicure di sé |
Confini | Cosa l'agente non deve fare | Sola lettura finché non ti fidi |
Una versione che funziona assomiglia a questa:
## Contratto del report di ranking
Input: data/queries-*.csv, data/pages-*.csv
Finestra: ultimi 28 giorni contro i 28 precedenti. Indica entrambe le date nell'intestazione.
Riporta solo tre cose:
1. Query che si sono mosse: qualsiasi query oltre 5 posizioni di scarto, o
impression in aumento di oltre il 30% con clic fermi, o qualsiasi query
uscita dai primi 10.
2. Spiegazione probabile: usa solo i dati nei file. Se i file non spiegano il
movimento, scrivi "non spiegato da questi dati".
3. Da controllare la settimana prossima: una riga per query segnalata, con il
nome esatto della pagina o della query da ispezionare.
Non affermare mai una causa che non puoi indicare nei dati. Non raccomandare mai
una modifica al sito. Non modificare mai file fuori da reports/ranking/.Output atteso: un file di istruzioni, committato o salvato accanto ai dati.
Controllo di qualità: leggi il contratto ad alta voce. Se una riga qualsiasi potesse valere per un altro sito senza modifiche, è troppo vaga per vincolare qualcosa.
Se fallisce: se Codex continua ad aggiungere sezioni, la forma dell'output non è abbastanza specifica. Nomina i tre titoli esattamente come li vuoi.
L'anatomia del report. Il piè di pagina che elenca i file esatti usati è la parte di cui chi revisiona si fida di più, e quella che quasi tutti i modelli omettono.
Passo 3: genera il primo report
Punta Codex sulla cartella e chiedi un report secondo il contratto. Chiedi il file, non una risposta in chat, così l'output è revisionabile e confrontabile.
Alla prima esecuzione scoprirai come sono davvero i tuoi dati. Metti in conto due o tre giri di correzione. È normale, ed è la parte più economica dell'intero flusso.
Output atteso: reports/ranking/YYYY-MM-DD.md con intestazione, tre sezioni e un piè di pagina che elenca i file esatti usati.
Controllo di qualità: prendi due query segnalate e verifica i numeri a mano in Search Console. Se coincidono, la pipeline è solida. Se no, fermati e sistema il passo dei dati. Non fare debug dell'analisi su un input rotto.
Se fallisce: il guasto più comune è un disallineamento di date tra l'export e il contratto. Fissa entrambe le date nell'intestazione a ogni esecuzione, così uno scarto di due giorni non trasforma in silenzio un mese piatto in un crollo.
La prima versione che ho costruito riportava undici query in movimento in una settimana in cui non si era mosso quasi niente. Il contratto andava bene; l'export no. Un file di 30 giorni confrontato con una finestra di 28 ha fatto sembrare due giorni mancanti un collasso dell'intero sito. Ora il contratto si rifiuta di girare se i due intervalli non coincidono, e quel guasto non si è più ripresentato.
Passo 4: aggiungi la riga che l'agente non può scrivere
Ogni report riceve un paragrafo umano: cosa abbiamo rilasciato, cambiato o rotto la settimana scorsa.
Non è decorazione. È il modo più rapido per cogliere un agente che attribuisce il tuo rilascio a un aggiornamento dell'algoritmo. Quando il report dice che un gruppo di pagine prodotto è calato e la tua nota dice che il template è cambiato martedì, la spiegazione si restringe immediatamente.
Output atteso: due o tre frasi in cima al report, scritte da una persona.
Controllo di qualità: se la nota e la sezione dei movimenti si contraddicono, quella contraddizione è la riga più preziosa del report. Lasciala visibile invece di appianarla.
Passo 5: verifica prima di inviare
Esegui questi tre controlli prima che il report esca dalla tua scrivania.
- Date. Entrambe le finestre dichiarate nell'intestazione, coerenti con l'export.
- Due verifiche a campione. Due query segnalate controllate a mano.
- Un controllo di contraddizione. Qualche spiegazione affermata cita dati che non sono nell'elenco dei file in fondo?
Se tutti e tre passano, il report si può condividere. È una bozza del tuo giudizio, non un sostituto.
Il percorso avanzato, quando sei pronto
Fai girare il flusso a mano per quattro settimane. Automatizza solo dopo aver corretto due volte la stessa classe di errore.
Poi i miglioramenti sono incrementali:
- Programma l'esecuzione. Un'esecuzione settimanale programmata scrive il report prima che tu apra il portatile. Tieni il paragrafo umano come campo obbligatorio, così il report non può uscire senza.
- Salva gli snapshot nel controllo di versione. Ogni esecuzione diventa un commit. Il diff tra due settimane si legge più in fretta di entrambi i report.
- Aggiungi una seconda proprietà. Le query dei concorrenti o di brand stanno in un report separato con lo stesso contratto, non mescolate in quello principale.
- Aggiungi un segnale esterno. Un controllo di ricerca brand o di quota di risposta rende il segnale di brand del sondaggio 2026 misurabile invece che teorico.
Cosa non automatizzare: il passo della raccomandazione. Nel momento in cui un agente inizia a proporre modifiche al sito, sei passato dal reporting alla pubblicazione, e il carico di revisione cresce più in fretta del tempo risparmiato.
Risoluzione dei problemi
Sintomo | Causa probabile | Rimedio |
|---|---|---|
Ogni query sembra calata | Disallineamento di date tra gli export | Fissa entrambe le finestre nel contratto e nell'intestazione |
Il report è vuoto | Soglie troppo rigide per il tuo livello di traffico | Abbassa la soglia delle impression prima di quella della posizione |
Sempre le stesse cinque query | L'insieme di query è troppo stretto | Aggiungi query long-tail e comparative ai secchielli |
Movimento senza spiegazione | Normale per query a basso volume | Mantieni l'output "non spiegato da questi dati" e vai avanti |
Numeri diversi da Search Console | Proprietà o filtro incoerenti nell'export | Esporta sempre dalla stessa proprietà e dallo stesso set di filtri |
Mantieni il flusso
Tre abitudini di manutenzione lo tengono utile oltre il primo trimestre.
Rivedi l'insieme di query ogni trimestre. Un report che insegue le priorità dell'anno scorso è una lezione di storia, non un report di ranking.
Rileggi il contratto quando Search Console cambia. Google aggiorna periodicamente l'interfaccia del report Prestazioni e i campi dell'export. Se un campo sparisce, il contratto va modificato lo stesso giorno.
Conserva i report vecchi. Confrontare il report di questo trimestre con lo stesso trimestre dell'anno scorso è l'unico modo economico di separare un calo reale dalla stagionalità.
Domande frequenti (FAQ)
Serve Codex per forza? No. Il flusso funziona con qualsiasi agente che sappia leggere file, girare su pianificazione e scrivere un output revisionabile. Codex è adatto quando il sito vive già in un repository, perché il report diventa un commit che puoi confrontare.
Si può fare solo con strumenti gratuiti? Sì. L'intero flusso gira sui dati di Search Console, che sono gratuiti, più l'agente. Un tracker di posizioni a pagamento serve solo quando vuoi le posizioni dei concorrenti o posizioni che non vedi nella tua proprietà.
In cosa è diverso dal report Prestazioni di Search Console? Il report Prestazioni ti mostra una tabella. Questo flusso produce una decisione: quali query hanno superato una soglia, cosa i dati spiegano e non spiegano, e cosa ispezionare la settimana prossima. Inoltre tiene uno storico, cosa che l'interfaccia non fa.
E se il mio sito ha pochissimo traffico? Abbassa la soglia delle impression e confronta 28 giorni con gli stessi 28 giorni dell'anno scorso invece che con i 28 precedenti. I siti a basso volume ricavano più segnale dai confronti annuali che da quelli settimanali.
Il report dovrebbe includere AI Overview o citazioni AI? Se vuoi, aggiungi una sezione separata con un contratto proprio. Tienila fuori dal report sulle posizioni, perché fonti e misurazione sono diverse, e mescolarle rende entrambe più difficili da leggere.
Autore: Leo Harrington, traduttore di analytics SEO per oltre 500 report direzionali in Auspia. Leo scrive di come trasformare i dati di ricerca in report su cui un non specialista può agire.
