Esistono sei modi concreti per dare a un agente IA l'accesso ai dati di Google Search Console: un connettore OAuth ospitato, un server MCP della community, la Search Console API usata direttamente, l'esportazione collettiva in BigQuery, un ponte tramite foglio di calcolo oppure la configurazione IA integrata nella stessa Search Console, senza alcun agente. Si va da due minuti a quasi una giornata di lavoro, e la scelta giusta dipende da una domanda sola: ti serve uno storico oltre i 16 mesi?
È proprio quest'ultimo punto il bivio, quindi partiamo da lì. La Search Analytics API restituisce al massimo 25.000 righe per richiesta e conserva 16 mesi di storico. Passati i 16 mesi, i dati spariscono: non vengono nascosti, vengono cancellati. Se ti serve uno storico più lungo, solo uno dei metodi di questa lista te lo garantisce, e va attivato prima che ti serva.
Metodo 1: un connettore OAuth ospitato
Configurazione: da 2 a 5 minuti. Zero codice.
Autorizzi un prodotto SEO basato su agenti ad accedere al tuo account Google, scegli la proprietà e la connessione viene salvata lato server e riutilizzata a ogni query. È la soluzione che la maggior parte dei marketer dovrebbe usare, e non per pigrizia: il motivo è che i casi di errore li gestisce qualcun altro al posto tuo. Un connettore fatto bene rileva una connessione mancante e te la chiede invece di tirare a indovinare, capisce quale proprietà usare quando ne possiedi diverse e pagina oltre il tetto delle 25.000 righe senza che tu debba pensarci.
Nella nostra implementazione lo strumento di Search Console è contrassegnato come di sola lettura, verifica al primo utilizzo che ci sia una connessione attiva e, se non c'è, mostra un invito interattivo a collegarsi con un link diretto alla schermata delle integrazioni; poi riprende la conversazione quando torni.
Il compromesso: hai a disposizione il catalogo di strumenti che ha costruito il fornitore. Se ti serve una query che non hanno implementato, non puoi averla.
Metodo 2: un server MCP per Search Console
Configurazione: da 15 a 45 minuti. Serve un minimo di dimestichezza da sviluppatore.
Il Model Context Protocol è uno standard aperto client/server per collegare gli assistenti IA a sistemi esterni: qualsiasi client compatibile con MCP (Claude Desktop, Claude Code, Cursor e altri) può quindi chiamare direttamente un server di Search Console.
L'avvertenza importante: a differenza di GA4, per cui Google pubblica un proprio server MCP, non esiste un server MCP ufficiale di Google per Search Console. Esiste invece un buon numero di implementazioni della community, come mcp-server-gsc, che gestisce il recupero dei dati di Search Analytics fino al tetto delle 25.000 righe con filtri regex ed è di sola lettura.
La configurazione è un blocco JSON nel tuo client MCP che punta al server con le tue credenziali:
{
"mcpServers": {
"search-console": {
"command": "npx",
"args": ["-y", "mcp-server-gsc"],
"env": { "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json" }
}
}
}Il compromesso: stai affidando a un pacchetto della community le credenziali dei tuoi dati di ricerca. Leggi il codice sorgente, preferisci gli scope di sola lettura e blocca la versione. Controlla anche che la versione del protocollo implementata dal server corrisponda a quella che si aspetta il tuo client.
Metodo 3: la Search Console API con un account di servizio
Configurazione: da 1 a 3 ore. Qui si scrive codice.
Il massimo del controllo, e il massimo del lavoro. La sequenza:
- Crea un progetto Google Cloud, oppure riutilizzane uno esistente.
- Abilita la Search Console API sul progetto.
- Crea un account di servizio e scarica la chiave JSON.
- Aggiungi l'indirizzo email dell'account di servizio come utente della proprietà in Search Console, con autorizzazione Limitata (sola lettura).
- Autentica il tuo agente con la chiave e chiama
searchanalytics.query.
Il passaggio 4 è quello che dimenticano tutti. Creare una credenziale in Cloud non le dà accesso a una proprietà: sono due sistemi di autorizzazione separati, e saltare il secondo produce un generico errore 403 che sembra un problema di abilitazione dell'API anziché di accesso alla proprietà. Mettiti in conto di perderci venti minuti, almeno la prima volta.
Un corpo di query minimo, con paginazione, si presenta così:
{
"startDate": "2026-04-01",
"endDate": "2026-06-30",
"dimensions": ["query", "page"],
"rowLimit": 25000,
"startRow": 0
}Incrementa startRow di 25.000 a ogni pagina e fermati quando una risposta restituisce meno righe di quelle richieste. Tutto il resto (gestione delle quote, nuovi tentativi, rinnovo dei token) adesso tocca a te costruirlo.
Il compromesso: flessibilità totale, ma ora gestione delle quote, paginazione, nuovi tentativi e rinnovo dei token sono affar tuo. Scegli questa strada quando l'agente ha bisogno di una query che nessun connettore offre, o quando i dati devono restare all'interno della tua infrastruttura.
Metodo 4: esportazione collettiva in BigQuery
Configurazione: circa un'ora, più fino a 48 ore prima che arrivi la prima esportazione.
È l'unico metodo che risolve il problema dei 16 mesi, ed è quello da configurare oggi stesso anche se non ti serve ancora, perché accumula lo storico da qui in avanti, non a ritroso.
Secondo la documentazione di Google sull'esportazione collettiva dei dati, la sequenza è questa:
- Crea o scegli un progetto Google Cloud con la fatturazione abilitata. Non è facoltativo.
- Abilita sul progetto la BigQuery API e la BigQuery Storage API.
- Assegna all'account di servizio di Search Console due ruoli sul progetto: BigQuery Job User e BigQuery Data Editor.
- In Search Console apri Impostazioni, poi Esportazione collettiva dei dati, e inserisci l'ID del progetto Cloud e una località per il dataset.
- Aspetta. La prima esportazione arriva entro 48 ore, poi le esportazioni vengono eseguite ogni giorno.
Due dettagli da conoscere prima di lanciarti. Le query anonimizzate sono escluse dall'esportazione per motivi di privacy, quindi i totali di BigQuery non coincideranno esattamente con quelli dell'interfaccia di Search Console. È normale, non è un bug, ma un agente che confronta le due fonti ti segnalerà una discrepanza inesistente se non glielo dici. Inoltre la località del dataset non si può cambiare in seguito senza ricominciare da capo, quindi sceglila con attenzione.
Una volta che i dati sono in BigQuery, il tuo agente interroga SQL invece della Search Console API, e così elimini in un colpo solo il tetto di righe e la finestra di conservazione. Per i siti piccoli i costi restano nel livello gratuito di BigQuery, per quelli grandi diventano concreti: chiedi quindi all'agente di filtrare sulla colonna della data di partizione invece di scansionare l'intera tabella. Un agente che lancia un SELECT * senza limiti su tre anni di una proprietà di grandi dimensioni ti regalerà una fattura difficile da dimenticare.
Il compromesso: costa, richiede più infrastruttura di qualsiasi altra opzione e il primo giorno non ti dà nulla. Ma è anche l'unica strada per un'analisi pluriennale.
Metodo 5: un ponte tramite foglio di calcolo
Configurazione: da 10 a 20 minuti. Zero codice.
Esporti i dati di Search Console in Google Sheets a intervalli programmati con un componente aggiuntivo o con Apps Script, poi indirizzi al foglio un agente che ha accesso a Sheets. È l'opzione pragmatica quando il tuo agente legge già fogli di calcolo e vuoi dargli i dati entro questo pomeriggio.
Il compromesso: i dati sono aggiornati solo quanto l'ultima esportazione, tutto è già filtrato da chi ha configurato il foglio e l'agente non può approfondire con una query che nessuno aveva previsto, cioè esattamente la capacità per cui hai scelto un agente. Consideralo una soluzione tampone.
Metodo 6: nessuna connessione
Configurazione: nessuna.
Search Console ha l'IA integrata. La configurazione basata sull'IA di Google ti permette di descrivere in linguaggio naturale l'analisi che vuoi e la traduce in filtri, confronti e selezioni di metriche del report. Una richiesta come «Confronta il traffico delle mie pagine che contengono /blog in questo trimestre con lo stesso trimestre dell'anno scorso» si configura da sola.
Conosci i limiti, che Google dichiara senza giri di parole: funziona solo sui report Rendimento per i risultati di ricerca, non su Discover o News; configura filtri, confronti e metriche ma non può ordinare le tabelle né esportare i dati; e Google avverte che l'IA può interpretare male una richiesta, quindi conviene controllare i filtri applicati prima di fidarti dell'analisi. Inoltre si limita alla configurazione: non ragiona incrociando GA4 e Search Console, né indaga sulle cause.
A parte questo, Search Console ora include i report sul rendimento dell'IA generativa per il traffico proveniente dalle superfici IA di Google. Se la tua domanda riguarda la visibilità su queste superfici, la fonte autorevole è questa, e nessuna stima di terze parti può sostituirla.
Quale metodo scegliere?
| Metodo | Configurazione | Supera i 16 mesi | Ideale per |
|---|---|---|---|
| Connettore ospitato | 2-5 min | No | Marketer che vogliono risposte oggi |
| Server MCP | 15-45 min | No | Sviluppatori che usano già un client MCP |
| API diretta | 1-3 ore | No | Query personalizzate, dati che restano in casa |
| Esportazione in BigQuery | 1 ora + 48 ore | Sì | Analisi pluriennali, siti di grandi dimensioni |
| Ponte tramite foglio di calcolo | 10-20 min | No | Soluzione temporanea |
| Configurazione IA integrata | Nessuna | No | Creare report più in fretta, non indagare |
La combinazione a cui arriva la maggior parte dei team è un connettore ospitato per le domande di tutti i giorni più un'esportazione in BigQuery che gira in silenzio in background, così tra un anno avranno uno storico che nessun altro ha. Le due cose non sono in competizione.
È sicuro dare a un agente l'accesso a Search Console?
Ragionevolmente sì, a tre condizioni. Concedi la sola lettura. Le autorizzazioni di Search Console includono la possibilità di inviare sitemap e richiedere rimozioni, e un agente non ha bisogno di nulla di tutto ciò. Preferisci un account di servizio con permessi limitati a un'autorizzazione OAuth personale, così la revoca non dipende dall'account di un singolo dipendente. E tieni gli strumenti di scrittura separati da quelli che recuperano pagine web: un agente che legge la pagina di un concorrente ha portato testo scritto da terzi nella stessa finestra di contesto delle tue istruzioni, e se quella pagina contiene comandi iniettati un agente ingenuo può eseguirli. Il nostro runtime isola i contenuti recuperati come non attendibili, segna il turno come contaminato e rifiuta ogni strumento contrassegnato come di scrittura per il resto del turno, a meno che non lo approvi una persona. Le query a Search Console sono contrassegnate come di lettura, quindi sono sicure in ogni caso.
Errori di configurazione comuni e cosa significano davvero
| Sintomo | Causa più comune | Soluzione |
|---|---|---|
| 403 su ogni query, anche con l'API abilitata | L'account di servizio non è mai stato aggiunto come utente della proprietà | Aggiungi la sua email nelle impostazioni della proprietà in Search Console, con autorizzazione Limitata |
| Set di risultati vuoto, nessun errore | URL della proprietà non corrispondente: proprietà Dominio contro proprietà Prefisso URL, oppure slash finale mancante | Copia la stringa della proprietà esattamente come la mostra Search Console |
| L'agente riporta totali sospettosamente tondi | Risultato troncato al tetto delle 25.000 righe e trattato come completo | Pagina con startRow, oppure chiedi all'agente di segnalare il troncamento |
| I numeri non coincidono con l'interfaccia di Search Console | Query anonimizzate escluse dall'esportazione in BigQuery, oppure un diverso limite di date | Normale per BigQuery; altrimenti controlla fuso orario e date assolute |
| Esportazione collettiva configurata ma nessun dataset visibile | Sei ancora nella finestra delle 48 ore, oppure la fatturazione non è abilitata sul progetto | Aspetta, poi verifica la fatturazione e i due ruoli IAM |
| Il server MCP si avvia ma non espone strumenti | Percorso delle credenziali errato, oppure versione del protocollo non compatibile con il client | Verifica che il percorso in env venga risolto e quale versione della specifica supporta il server |
Due cose da fare bene, qualunque metodo tu scelga
Gestisci la paginazione in modo onesto. Un agente che chiede 25.000 righe, ne riceve esattamente 25.000 e riporta un totale sta riportando un troncamento. Chiedigli di paginare o di dichiarare che il risultato ha toccato il tetto.
Usa date assolute. Espressioni relative come «il mese scorso» vengono risolte in base al fuso orario della proprietà e al momento in cui è partita la query. È la causa più frequente di un'analisi di Search Console sicura di sé, coerente e sbagliata.
Una volta creata la connessione, l'articolo su cosa può trovare davvero un agente nei dati di Search Console spiega le analisi che vale la pena fare, e Autopilot implementa il connettore ospitato descritto nel metodo 1.
Get a free AI ranking consultation
Want your brand to show up when ChatGPT, Gemini and Perplexity answer questions in your market? Tell us about your site and our team will send a personalized strategy.
