Come collegare Google Search Console a Claude Code con MCP

Perché collegare Search Console a un assistente per il codice?

Claude Code è utile quando il lavoro SEO riguarda il sito stesso. Nello stesso ambiente di sviluppo puoi ispezionare i template, correggere i redirect, cambiare i title delle pagine, provare una build e rivedere una sitemap. Ma il tuo codice sorgente non può dirti quale pagina ha perso 300 clic da Google la settimana scorsa.

Senza accesso a Search Console, un assistente può guardare una pagina e fare suggerimenti sensati. Non riesce però a distinguere un problema ad alta priorità da qualcosa che nessuno cerca. Quando hai poco tempo, questa differenza conta.

Una connessione MCP aggiunge la fonte di prove che mancava. Puoi chiedere a Claude Code di individuare da Search Console gli URL interessati, confrontarli con i template locali delle pagine e preparare modifiche al codice basate su un’indagine vera.

Questa guida riguarda il flusso di lavoro da terminale di Claude Code, non il normale connettore del sito web di Claude. Se lavori soprattutto nel browser, usa la nostra guida alla configurazione di Search Console in Claude.

Cosa serve prima di eseguire un comando

Ti servono Claude Code installato e funzionante in un terminale, un account Google con accesso alla proprietà di Search Console desiderata e un server MCP in grado di ottenere i dati di quella proprietà. Il server può essere in self-hosting o remoto.

I passaggi che seguono usano l’endpoint in hosting di GSC Magic. Secondo la documentazione di GSC Magic, accetta il trasporto Streamable HTTP e supporta l’accesso basato su OAuth oppure un token di accesso. Il tuo account deve essere attivato e il servizio raggiungibile: inserire un URL valido non significa che l’autenticazione sia riuscita.

Per prima cosa, verifica che Claude Code stesso funzioni. Aprilo in un progetto qualsiasi e controlla di poter scrivere dei prompt. Per provare una connessione a Search Console in sola lettura non serve clonare tutto il tuo sito di produzione.

Prima di collegarti, decidi se il lavoro riguarda un solo sito o più siti. Se un account Google ha accesso a siti di clienti, domini di staging e vecchie proprietà con prefisso URL, è facile selezionare la proprietà sbagliata.

Passaggio 1: aggiungi l’endpoint MCP remoto

Apri il terminale ed esegui questo comando:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp

Ecco il significato di ogni parte. claude mcp add registra un server in Claude Code. Il trasporto http indica un servizio MCP remoto e non un eseguibile locale. --scope user rende il connettore disponibile nella tua configurazione a livello utente. Il nome breve gsc-magic è solo l’identificativo che vedrai nell’elenco dei tool.

L’URL è l’endpoint remoto documentato per GSC Magic. Non è l’URL della tua proprietà di Search Console, né la sitemap del tuo sito, né un endpoint delle API di Google.

Perché lo scope utente? Se fai SEO su più progetti locali, una connessione a livello utente è comoda. Per un repository condiviso o un ambiente cliente delicato, leggi le regole sugli scope di configurazione di Claude Code e la policy del tuo team prima di aggiungere integrazioni esterne.

I comandi MCP generali e le indicazioni sul trasporto sono nella documentazione di Claude Code di Anthropic. Consultala se un’opzione della CLI cambia in una versione più recente.

Passaggio 2: autenticati in Claude Code

Avvia Claude Code e digita:

/mcp

Seleziona il server gsc-magic. Se il client offre l’azione Authenticate, seguila e completa l’accesso dal browser. Usa l’account Google che ha i permessi corretti sulla proprietà di Search Console.

Non inviare la tua password di Google, il codice di autorizzazione OAuth o un token di accesso come normale messaggio di chat. L’autenticazione è un passaggio separato, gestito dal client e dal server. Se il browser si apre ma l’autorizzazione non si completa mai, torna al menu MCP e controlla lo stato della connessione prima di ripetere il tentativo.

In alcuni ambienti non è possibile completare l’OAuth dal browser. In quei casi GSC Magic documenta i token di accesso personali in Connect → Access tokens nella sua dashboard. Una connessione basata su token usa un’intestazione, per esempio:

claude mcp add --transport http --scope user gsc-magic https://mcp.gscmagic.com/mcp \
  --header "Authorization: Bearer gsm_YOUR_TOKEN"

È un modello, non una credenziale funzionante. Sostituisci il segnaposto in un flusso di configurazione locale sicuro e non committarlo su Git. Se ti servono solo report di analytics e di indicizzazione, crea un token in sola lettura. La documentazione della piattaforma spiega scadenza, revoca e permessi dei token.

Passaggio 3: verifica che la connessione funzioni

Non iniziare con «fai l’audit dell’intero sito e sistema tutto». Chiedi una risposta che puoi verificare.

Elenca le proprietà di Google Search Console a cui può accedere questa connessione. Includi gli identificatori esatti delle proprietà e, se disponibili, i livelli di permesso. Non analizzare nessuna proprietà finché non la seleziono io.

Con questo controlli più cose insieme: il client riesce a scoprire i tool del server, il server riesce ad autenticarsi su Google e il tuo account Google vede almeno una proprietà.

Seleziona l’identificatore esatto della proprietà che ti serve. Una proprietà del tipo sc-domain:example.com può includere i sottodomini. Una proprietà con prefisso URL come https://www.example.com/ copre un insieme più ristretto di URL. Una discrepanza che passa inosservata può far sembrare sbagliato un confronto di traffico anche se lo strumento funziona perfettamente.

Se l’elenco è vuoto, controlla prima l’account Google e i permessi sulla proprietà. Non dare per scontato che il server sia rotto.

Passaggio 4: esegui un primo confronto SEO utile

Un buon primo compito è circoscritto, misurabile e facile da ripetere:

Per la proprietà di Search Console selezionata, confronta gli ultimi 28 giorni di report completi con i 28 precedenti. Mostra gli intervalli di date esatti, i clic, le impressioni e il CTR totali, poi elenca le dieci pagine con le maggiori perdite assolute di clic. Usa i dati di Search Console, non stime. Etichetta le possibili spiegazioni come ipotesi.

Puoi controllare quel report nell’interfaccia Rendimento di Search Console. Se i totali differiscono, verifica le scelte di aggregazione, i fusi orari, i tipi di ricerca e se i dati sono definitivi. Google conta clic e impressioni secondo le proprie definizioni di reporting, non secondo le regole delle sessioni di GA4.

Poi chiedi a Claude Code di approfondire una pagina:

Per l’URL con la perdita maggiore, confronta le sue dieci query principali tra i due periodi. Raggruppa le variazioni rilevanti per dispositivo e paese. Dimmi quali osservazioni giustificano di indagare sul template della pagina e quali no.

Qui un assistente per il codice diventa utile. Se la pagina ha perso visibilità da mobile, potresti rivedere la navigazione mobile, il layout responsive e il rendering. Se ha perso impressioni per un gruppo ristretto di query, potresti esaminare i contenuti della pagina e i link interni. Ma non lasciare che il modello scambi una correlazione per una prova.

Passaggio 5: collega i dati al codice del tuo sito

Supponi che Search Console individui un URL prodotto importante con un click-through rate in calo. Chiedi a Claude Code di trovare la route o il template responsabile di title HTML, description e intestazioni della pagina.

Una sequenza sensata è questa:

1. Individua la pagina o il template nel tuo progetto.
2. Ispeziona il title esistente, l’URL canonico, la struttura delle intestazioni e il contenuto principale.
3. Leggi le query che hanno generato impressioni per la pagina.
4. Suggerisci un miglioramento limitato, coerente con il contenuto reale della pagina.
5. Mostra un diff prima di applicare le modifiche.
6. Esegui la tua build e i tuoi test abituali.
7. Annota la data di rilascio, così potrai confrontare più avanti.

Non tutte le pagine con CTR basso hanno bisogno di un nuovo title. Una pagina può posizionarsi per query informative generiche con poca propensione al clic, oppure la sua posizione media può essere cambiata. Prima di riscrivere i metadati sulla base di un solo numero, consulta la guida all’analisi dei CTR bassi.

Non dire mai a Claude Code di eliminare o reindirizzare pagine solo perché due URL condividono una query. Si rischia di fare più danni del problema iniziale.

Come costruire un flusso di lavoro settimanale ripetibile

Puoi salvare il prompt di analisi nei tuoi appunti o nel runbook interno del progetto. Claude Code non ha bisogno di ricordare la conversazione precedente, se il prompt specifica i parametri del report.

Chiedi ogni volta le stesse finestre complete di 7 o 28 giorni e indica la proprietà selezionata. Fai restituire all’assistente una tabella con URL, clic in ciascun periodo, variazione assoluta, variazione relativa e il maggiore contributo a livello di query. Tieni la prima versione in sola lettura.

Dopo il report, chiedi un piano d’azione limitato a tre punti. Un buon punto d’azione ha un segnale osservato, una verifica proposta, un responsabile e un modo per misurare il risultato.

Ad esempio: «La pagina della documentazione ha perso 120 clic, soprattutto per query legate alla configurazione da desktop. Controlla se la pagina risponde ancora alla versione attuale delle istruzioni di integrazione; aggiornala solo se il contenuto è obsoleto.» È molto più concreto di «Migliora la qualità dei contenuti».

Se pianifichi script o agenti, tieni sotto controllo le chiamate ripetute e rispetta le quote dell’API di Search Console. Un report settimanale non dovrebbe richiedere centinaia di richieste duplicate.

Risoluzione dei problemi più comuni

Se l’assistente segnala un errore di un tool, leggi l’errore effettivo prima di provare un altro prompt. Riformulare una query non risolve un token revocato o un sito a cui il tuo account non può accedere.

Il riferimento dell’API Search Analytics di Google documenta limiti di date, dimensioni, limiti e aggregazione. Capire questi vincoli evita una quantità sorprendente di false diagnosi SEO.

Permessi e sicurezza quando codice e dati di ricerca si incontrano

Collegare i dati di Search Console a un assistente per il codice è potente perché l’assistente può avere anche accesso al filesystem. Proprio per questo conviene separare indagine e implementazione.

Tratta gli strumenti di reporting come in sola lettura, ogni volta che è possibile. Chiedi di proporre i diff del codice e rivedili prima che l’assistente scriva o rilasci qualsiasi cosa. Usa il tuo normale flusso Git e i controlli abituali. Se lavori con proprietà di clienti, evita di mescolare in un unico report i dati di clienti non collegati tra loro.

GSC Magic documenta i token in sola lettura e controlli separati per la modalità scrittura. I suoi tool per Google Search Console includono la lettura di analytics e dello stato degli URL indicizzati, mentre le azioni amministrative, come l’invio di una sitemap, richiedono un permesso più forte. Questa separazione conta più di quanti tool elenca il connettore.

Ricorda che la URL Inspection API di Google non richiede l’indicizzazione. I suoi risultati sulla versione indicizzata sono diversi da un test dell’URL live. La Google Indexing API, a parte, ha tipi di contenuto supportati limitati e non va usata come scorciatoia per le pagine normali.

Domande frequenti

Claude Code può accedere direttamente a Google Search Console, senza MCP?

Non di default. Servirebbe un altro percorso autorizzato, come uno script API personalizzato o un export importato. MCP è un modo standard per esporre quelle chiamate come tool che Claude Code può usare.

È la stessa configurazione di Claude sul web?

No. Claude Code usa una configurazione MCP gestita dalla CLI. L’app web di Claude ha una propria interfaccia per i connettori. La fonte dei dati può essere la stessa, ma i passaggi di connessione sono diversi.

Claude Code può risolvere in automatico i problemi di SEO tecnica?

Può aiutare a modificare i file a cui ha il permesso di accedere, ma le prove di Search Console non dimostrano che ogni modifica suggerita sia corretta. Rivedi i diff, prova le build e richiedi l’approvazione umana per il rilascio.

L’agente conoscerà le mie conversioni di Google?

Solo se autorizzi una fonte di analytics adeguata. Search Console riporta clic e impressioni di ricerca; per sessioni ed eventi chiave serve GA4.

Quale attività conviene provare per prima?

Parti da un confronto tra due periodi completi di 28 giorni e dalle dieci pagine con i maggiori cali di clic. Puoi confermare quei numeri prima di toccare il codice.

In pratica

Claude Code rende al meglio come ponte tra il comportamento di ricerca misurato e il sito che puoi davvero migliorare. Usa il connettore per individuare un problema, il codice per indagarlo e il tuo normale processo di revisione per fare le modifiche in sicurezza.

Se vuoi sapere con precisione quali tool, tipi di token e opzioni di connessione sono documentati oggi, tieni aperta la documentazione di GSC Magic mentre configuri il client. Per altre idee di analisi, usa i nostri 25 prompt per agenti SEO.