Logo di Google Search Console

SEO e ricerca

Collegare Google Search Console per Excel, Fogli Google, IA e REST

Query, pagine, paesi e dispositivi come tabelle. Lo stesso connettore che il resto di Query Streams utilizza internamente per la propria SEO.

Un collegamento, ogni superficie

Dove possono essere archiviati i dati della tua Search Console

Query Streams trasforma una proprietà di Search Console in SQL: ogni combinazione di query, pagina, paese e dispositivo viene visualizzata come riga in un'unica tabella, insieme ai siti, alle sitemap e ai risultati delle ispezioni. Il tutto è leggibile da Microsoft Excel, Fogli Google, Power BI, assistenti AI tramite MCP e un endpoint REST. Recupera tutti i sedici mesi di dati che Google conserva al primo accesso, ovvero la parte che l'interfaccia di Search Console non fornisce in un'unica soluzione.

  1. Per il tuo team, i fornitori e i partner
  2. Search Console su Excel Microsoft Excel · Componente aggiuntivo di Excel

    Importa i risultati di Search Console in tempo reale direttamente in un foglio di lavoro e aggiornali a piacimento: in Excel per desktop, Excel Online e Microsoft 365.

    Guida alla console di ricerca
  3. Search Console a Fogli Google Componente aggiuntivo Fogli

    Esegui una query salvata di Search Console dalla barra laterale e trascina le righe nel foglio. I collaboratori che condividono il foglio possono aggiornarlo autonomamente.

    Guida alla console di ricerca
  4. Chiedi a Nova informazioni su Search Console Nova AI · conversione da testo a SQL

    Poni una domanda in un linguaggio semplice. Nova conosce già le tue tabelle di Search Console, scrive ed esegue la query SQL, spiega la risposta e la rappresenta graficamente: non è necessario scrivere alcuna query né fornire credenziali.

    Come funziona la rosa
  5. Console di ricerca per la visualizzazione dei dati Condivisione dei risultati · team, fornitori, partner · telefono, tablet, computer fisso

    Condividi i risultati di una ricerca Search Console in tempo reale con chiunque – un collega, un fornitore, un partner – sotto forma di griglia aggiungibile ai segnalibri, che si aggiorna automaticamente all'apertura su smartphone, tablet o computer. L'interlocutore visualizzerà i risultati, senza mai dover accedere al codice SQL o alle credenziali.

    Come funziona il visualizzatore di dati
  6. Per app e sistemi
  7. API REST della console di ricerca Endpoint dell'HT

    Pubblica una query di Search Console come endpoint JSON autenticato, accessibile a qualsiasi applicazione, con specifiche OpenAPI 3.1 e raccolte predefinite per Postman, Insomnia e Hoppscotch. Non viene aperta alcuna porta del database.

    Come funziona un'API REST
  8. Search Console a Power BI Power Query M

    Incolla la query Power Query M generata nell'editor avanzato di Power BI e il report visualizzerà i risultati in tempo reale di Search Console tramite HTTPS, senza driver ODBC né porte di database aperte.

    Come funziona Power BI
  9. Cerca nella console di Airtable Piattaforma di automazione

    Sincronizza le righe di Search Console con una base Airtable a intervalli regolari, oppure recuperale tramite uno script di automazione di Airtable.

    Guida alla console di ricerca
  10. Console di ricerca per riga di base Piattaforma di automazione

    È possibile alimentare una tabella Baserow da Search Console tramite l'endpoint REST, sia in locale che nel cloud di Baserow.

    Guida alla console di ricerca
  11. Cerca Console in SeaTable Piattaforma di automazione

    Mantieni aggiornato il database di SeaTable con i dati di Search Console senza esportare un file o esporre il database stesso.

    Guida alla console di ricerca
  12. Search Console to Smartsheet Piattaforma di automazione

    Inserisci i risultati di Search Console in una griglia di Smartsheet in modo che piani e report vengano letti dal sistema di origine e non dall'esportazione della settimana precedente.

    Guida alla console di ricerca
  13. Console di ricerca per Anvil Anvil Works · Piattaforma per app

    Esegui il backup di un'app Anvil Python con Search Console tramite l'endpoint REST anziché incorporare le credenziali del database nell'app.

    Guida alla console di ricerca
  14. Per gli strumenti di intelligenza artificiale
  15. Server ConsoleMCP di ricerca Clienti di Claude, Cursor e MCP

    Concedi a un assistente IA l'accesso in sola lettura a Search Console con lo schema necessario per scrivere query SQL corrette, senza fornire le credenziali nella chat.

    Guida alla console di ricerca
  16. Consegnato alle persone
  17. Avvisi e report della Search Console Slack · Discord · Email · Webhook

    Imposta una query di Search Console per programmare l'invio delle righe a Slack, Discord, via e-mail o tramite un webhook firmato, oppure attendi che il messaggio venga inviato fino a quando il numero di righe, la soglia o la variazione percentuale non superano il valore da te impostato.

    Come funzionano gli avvisi e i report

Come funziona

5 passaggi, nessuna modifica al firewall in entrata

01

Crea un account di servizio Google e aggiungilo come utente alla proprietà Search Console.

02

Installa l'agente di rete e forniscigli la chiave dell'account di servizio e l'URL del sito, sia nel formato https che nel formato sc-domain.

03

Salva. La prima sincronizzazione ripercorre gli ultimi sedici mesi per tutti e cinque i tipi di ricerca.

04

Scrivi del normale codice SQL per gsc.search_analytics, oppure lascia che lo scriva Nova.

05

Leggi i dati da Excel, Fogli Google, Power BI, MCP o REST, collegati a qualsiasi sistema gestisca le tue iscrizioni e i tuoi ricavi.

Analisi approfondita delle funzionalità

Cosa ti offre Search Console

Sedici mesi, in una tabella

Search Console conserva i dati degli ultimi sedici mesi e li mostra a frammenti. Una volta che i dati vengono convertiti in SQL, il confronto anno su anno che l'interfaccia non può effettuare è un'operazione GROUP BY.

  • gsc.search_analytics contiene una riga per query, pagina, paese, dispositivo e giorno, con dati relativi a clic, impressioni, percentuale di clic e posizione media.
  • Sono sincronizzati cinque tipi di ricerca, non solo quella web. — vengono visualizzate anche immagini, video, notizie e contenuti Discover, ciascuno con la propria etichetta.
  • Le righe Discover e News non contengono query o dispositivi, perché Google non riporta queste dimensioni per esse. Le colonne sono vuote anziché create artificialmente.
  • gsc.sites e gsc.sitemaps sono disponibili come tabelle separate, quindi è possibile interrogare i conteggi tra siti inviati e siti indicizzati.

Sincero riguardo al ritardo di Google

I dati di Search Console sono aggiornati con circa tre giorni di ritardo e quelli degli ultimi giorni continuano a cambiare dopo la loro prima pubblicazione. Entrambi i comportamenti sono tipici di Google e vengono visualizzati in modo evidente, non nascosti.

  • La sincronizzazione si riferisce a tre giorni fa, perché richiedendo dati più recenti si ottiene un numero errato per il giorno successivo.
  • Ogni riga contiene una colonna data_state che ne indica lo stato (parziale o finale), consentendo così al report di escludere i giorni in fase di stabilizzazione anziché calcolarne automaticamente la media.
  • Ogni passaggio incrementale rilegge gli ultimi cinque giorni, quindi una riga parziale diventa quella finale anziché rimanere la prima versione visualizzata.

Noi usiamo questo

Query Streams esegue la propria ottimizzazione SEO su questo connettore: le stesse tabelle, lo stesso ritardo di tre giorni, lo stesso flag per distinguere tra risultati parziali e finali. Non si tratta di un'integrazione demo pensata per essere mostrata in una galleria di loghi.

  • Se una query genera più delle venticinquemila righe che Google restituisce per pagina in un giorno, quella porzione di risultati è quella che si ottiene; la suddivisione in base a ulteriori dimensioni non è automatica.
  • La tabella di ispezione degli URL esiste e viene popolata su richiesta anziché tramite la sincronizzazione programmata.

Condiviso da ogni connettore API

Come funziona ogni connettore API

  • Il tuo account diventa tabelle — gli endpoint sono mappati a tabelle SQL tipizzate con chiavi primarie e indici, quindi si scrivono SELECT, JOIN e GROUP BY invece di scorrere il JSON.
  • Sei tu a scegliere cosa sincronizzare e con quale frequenza. — ogni tabella ha il proprio intervallo, oppure non ne ha alcuno. Laddove l'API del fornitore lo supporti, vengono recuperati solo i record modificati dall'ultima esecuzione.
  • La copia è tua — risiede in un file DuckDB crittografato con AES-256-GCM accanto all'agente, sul tuo computer. Non nel nostro cloud.
  • Il venditore riceve solo tue notizie — l'agente chiama l'API direttamente dalla tua rete, quindi Query Streams non ha bisogno del tuo token per rispondere a una query.

Buono a sapersi

  • Si tratta di una copia sincronizzata, non di un proxy in tempo reale. — una query legge i dati già recuperati, quindi restituisce i risultati alla velocità di SQL e non supera mai il limite di richieste API. Le tabelle selezionate possono inoltre aggiornare una riga obsoleta durante la lettura.
  • I limiti tariffari vengono rispettati per te — ogni connettore rispetta ampiamente i limiti pubblicati dal fornitore, quindi una segnalazione non può causare la limitazione della velocità del tuo account per tutto il resto che lo utilizza.
  • Nulla viene buttato via — i campi non denominati dalla tabella vengono conservati in una colonna JSON raw_data che è comunque possibile interrogare.
  • Aggiungilo ai tuoi database — una tabella API e una tabella SQL Server nella stessa istruzione costituiscono una normale query, non un progetto di integrazione.

SQL tra sorgenti diverse

Collega Search Console al resto dei tuoi dati

Search Console può indicarti quale pagina ha generato il clic. Non può però dirti quale di quei clic si è trasformato in un account, né quanto quell'account ha speso. Queste informazioni si trovano altrove e un'unica istruzione può raggiungere tutti e tre i livelli. Ogni fonte esegue solo la parte di cui è competente, trasmette il risultato e l'unione avviene centralmente: le fonti non comunicano mai tra loro e nulla viene copiato altrove.

3 connessioni · 3 agenti

Google Search Console SEO e ricerca
PostgreSQL Motore relazionale
Striscia Pagamenti e fatturazione

Una dichiarazione

-- clic da Search Console, iscrizioni dal tuo database, entrate da Stripe
SELEZIONARE   s.page, SOMMA(s.clicks) COME clicks, SOMMA(i.amount_due) COME invoiced
DA     sito gsc.gsc.search_analytics1 S
CONGIUNGERE     pg_crm.clienti pubblici2       c ON c.landing_page = s.page
CONGIUNGERE     fatturazione.stripe.invoices3       i ON i.customer = c.stripe_id
GRUPPO PER pagina
ORDINATO DA clic DESC;

Le tre parti sono connessione, schema e tabella, e il nome della connessione è quello che le hai assegnato. Le colonne sono a scopo illustrativo; le tue tabelle saranno le tue tabelle. I dati di Search Console risalgono a tre giorni prima, ovvero a un ritardo di reporting di Google stesso, non a qualcosa aggiunto dalla sincronizzazione. La modalità di sola lettura si applica a ogni elemento: solo SELECT, WITH ed EXPLAIN, con un limite massimo alla quantità di dati che una singola fonte può fornire per una singola query. Come funzionano le query federate

Dettagli di connessione

Cosa serve a Search Console

Autenticazione
Una chiave dell'account di servizio Google, aggiunta come utente sulla proprietà. Ambito di sola lettura, conservata sull'agente
Proprietà
L'URL del sito: https://example.com/ o sc-domain:example.com. Lascialo vuoto e tutte le proprietà visibili all'account verranno sincronizzate.
Si è allungato oltre
HTTPS dalla tua rete all'API di Search Console. Nessun traffico in entrata.
Schema
gsc — quindi gsc.search_analytics, gsc.sitemaps
Tavoli
4. analisi_di_ricerca, siti, mappe_del_sito e ispezione_URL
Tipi di ricerca
web, immagini, video, notizie e scopri, ciascuno etichettato sulla riga
Freschezza
I dati risalgono a tre giorni fa, ovvero al ritardo di reporting di Google. Gli ultimi cinque giorni vengono riletti a ogni passaggio.
Storia
16 mesi dalla prima sincronizzazione: tutto ciò che Google conserva
Copia locale
Un file DuckDB crittografato con AES-256-GCM accanto all'agente, sulla tua macchina

La sola lettura è una caratteristica strutturale. Ogni chiamata effettuata da questo connettore è una lettura e il token che contiene è di sola lettura con ambito limitato: non può inviare una sitemap o richiedere l'indicizzazione.

In una query cross-source, la parte centrale di un riferimento a tre parti è gsc. Una connessione chiamata gsc_site che legge i dati di analisi della ricerca viene scritta come gsc_site.gsc.search_analytics.

Documentazione del fornitore: search.google.com

FAQ

Domande su Google Search Console

Quali strumenti sono in grado di leggere i dati di Google Search Console tramite Query Streams?

Tutto questo, da un'unica connessione: Excel, Fogli Google, MCP, API REST, Airtable, Baserow, SeaTable, Smartsheet, Anvil, Power BI, avvisi e report programmati. Collega l'account una sola volta e ogni strumento leggerà la stessa connessione di sola lettura: non è necessaria alcuna configurazione per ogni strumento e non ci sono seconde copie dei dati.

Devo aprire una porta del firewall per il mio account Google Search Console?

No. L'agente di rete Query Streams viene eseguito all'interno della rete locale e apre una singola connessione crittografata in uscita. Nessun altro sistema intercetta il traffico in entrata, non è necessaria una VPN e l'account mantiene le regole del firewall esistenti.

È possibile che Query Streams modifichi i dati in Google Search Console?

No. L'agente impone la sola lettura nel punto di esecuzione: un'istruzione alla volta, solo SELECT e simili. Le credenziali rimangono sull'agente e non vengono mai inviate a Query Streams.

Di cosa ha bisogno Query Streams per connettersi a Google Search Console?

Un host raggiungibile, un ruolo e la relativa password: l'agente ospita il driver, quindi non viene installato nulla sull'account. Autenticazione: una chiave dell'account di servizio Google, aggiunta come utente sulla proprietà. Ambito di sola lettura, mantenuto sull'agente. Proprietà: un URL del sito: https://example.com/ o sc-domain:example.com. Lascialo vuoto e tutte le proprietà che l'account può visualizzare verranno sincronizzate. Raggiungibile tramite: HTTPS dalla tua rete all'API di Search Console. Nessun traffico in entrata. Schema: gsc, quindi gsc.search_analytics, gsc.sitemaps.

Posso collegare Google Search Console a un altro database nella stessa query?

Sì, si tratta di una query federata. Un'unica istruzione può fare riferimento a Google Search Console e alle altre connessioni contemporaneamente, come indicato in `connection.schema.table`. Ogni origine esegue solo la parte di cui è competente e restituisce il risultato; l'unione avviene centralmente, quindi le origini non si connettono mai tra loro e nulla viene copiato o pianificato. La modalità di sola lettura si applica a ogni parte (solo SELECT, WITH ed EXPLAIN) e esiste un limite massimo alla quantità di dati che una singola origine può cedere per una singola query. Le query federate sono una funzionalità a pagamento; la pagina delle query federate riporta i limiti attuali relativi alle origini e alle dimensioni.

Metti Search Console dove si lavora

Installa l'agente, configuralo per connettersi al tuo account e scegli una destinazione.

Sola lettura Solo in uscita Le credenziali rimangono sull'agente