Vai al contenuto principale
Google Search Console · MCP
Google Search Console · MCP

GSC MCP per Google Search Console.

mcp-gsc collega Google Search Console a Claude, ChatGPT, Cursor e altri client MCP tramite Google OAuth.

Modalità consigliata
Read-only
Autenticazione
Google OAuth
Modalità
npm / Worker
Licenza
MIT
GSC MCP per Google Search Console | DigestSEO
mcp-gsc collega Google Search Console a Claude, ChatGPT, Cursor e altri client MCP tramite Google OAuth.

npm · Google Search Console MCP

Installa GSC MCP in locale con npm

npm avvia un server Streamable HTTP sul tuo computer. Prima servono Google OAuth e credenziali configurate: non è una connessione con un clic.

1. Prepara l'accesso a Google

  1. Node.js ^22.18.0 / >=24.11.0 + npm
  2. Usa un account Google con accesso alla proprietà Search Console da analizzare.
  3. Crea un client OAuth in Google Cloud, abilita le API necessarie e registra l'URI di reindirizzamento locale esatto.
  4. Imposta queste tre variabili d'ambiente seguendo la guida di questa versione. TOKEN_ENCRYPTION_KEY deve essere un base64 valido di esattamente 32 byte casuali.
    GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY

Registra questo URI esatto in Google Cloud. Host, porta e percorso devono corrispondere; localhost e 127.0.0.1 sono diversi.

http://127.0.0.1:8080/google/callback

localhost ≠ 127.0.0.1

Guida completa (SETUP.md)

2. Avvia il server locale

Dopo aver configurato le credenziali nel terminale, esegui il pacchetto npm. Per l'analisi usa la modalità di sola lettura adatta alla shell.

Il launcher usa readwrite per impostazione predefinita. Per la sola analisi scegli readonly prima di autorizzare Google; i tool di scrittura non vengono registrati.

Terminale Bash / zsh

export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gsc

PowerShell

$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc

Endpoint locale · Streamable HTTP

http://127.0.0.1:8080/mcp

3. Collega il client MCP

Lascia il launcher in esecuzione e collega un client sullo stesso computer all'endpoint Streamable HTTP, non stdio.

Claude Code

claude mcp add --transport http gsc http://127.0.0.1:8080/mcp

Collega Codex CLI / IDE

codex mcp add gsc --url http://127.0.0.1:8080/mcp

Cursor

In Cursor aggiungi un server MCP Streamable HTTP chiamato gsc con questo URL (Cursor locale).

http://127.0.0.1:8080/mcp

ChatGPT / Claude.ai

ChatGPT e Claude nel cloud non raggiungono 127.0.0.1 sul tuo computer. Usa un tuo Worker HTTPS o un tunnel MCP sicuro disponibile, se consentito dal tuo account.

Preferisci l'accesso remoto?

Preferisci l'accesso remoto?

Resta disponibile il self-hosting su Cloudflare Workers con configurazione Cloudflare e Google OAuth. L'esempio seguente usa Bash; consulta SETUP.md per i passaggi completi.

Informazioni

Che cos’è mcp-gsc?

mcp-gsc è un server Model Context Protocol che puoi ospitare tu e che collega il tuo client IA direttamente all’API ufficiale di Google Search Console.

Esegui il pacchetto npm in locale tramite HTTP loopback oppure distribuisci un Worker Cloudflare di tua proprietà con endpoint HTTPS. Entrambi usano Google OAuth.

Il launcher salva per impostazione predefinita lo stato cifrato in ~/.mcp-gsc/state; un Worker usa lo spazio nel tuo account Cloudflare. Non è un connettore gestito da DigestSEO.

Importa il report Web: multimodal per valutare pagine, impressioni e clic. Non riconosce immagini né modifica file. Analisi SEO di Google Lens e della ricerca multimodale.

Confronta la scoperta su Google dei tuoi account autorizzati, non like, follower o visualizzazioni nell'app. Confronta i risultati dei tuoi contenuti social su Google.

Strumenti

Funzionalità esposte dal server

Strumenti mirati coprono analisi, controllo URL, sitemap, indicizzazione, diagnosi SEO e il riepilogo settimanale del rendimento.

L'elenco comprende tool di scrittura opzionali. GSC_ACCESS_MODE=readonly espone solo i tool non modificanti; Google limita la Indexing API ai tipi di contenuto ammessi.

01get_capabilities

Elenca le funzionalità disponibili e lo stato dell’autenticazione.

02list_sites

Elenca le proprietà Search Console a cui l’account collegato può accedere.

03query_search_analytics

Interroga clic, impressioni, CTR e posizione su intervalli personalizzati.

04inspect_url

Recupera i report di controllo URL in tempo reale e i dettagli di indicizzazione.

05list_sitemaps

Elenca le sitemap inviate con lo stato di scansione e gli avvisi.

06add_site

Aggiunge una proprietà Search Console all’account collegato.

07delete_site

Rimuove una proprietà Search Console dall’account.

08submit_sitemap

Invia una sitemap per una proprietà Search Console.

09delete_sitemap

Rimuove una sitemap inviata da una proprietà.

10get_sitemap

Recupera lo stato dettagliato di una singola sitemap inviata.

11identify_quick_wins

Trova le query con molte impressioni posizionate tra l’8ª e la 20ª posizione.

12detect_cannibalization

Trova le query per cui più pagine competono per la visibilità.

13detect_content_decay

Individua le pagine con il calo maggiore di clic dalla ricerca.

14request_indexing

Richiede l’indicizzazione tramite l’Indexing API di Google. Al momento Google limita questa API alle pagine con dati strutturati JobPosting o alle dirette con BroadcastEvent dentro VideoObject. Non è disponibile per l’invio di pagine generiche.

15list_indexed_pages

Elenca le pagine che hanno ricevuto impressioni in Search Console.

16compare_performance

Confronta clic, impressioni, CTR e posizione tra periodi diversi.

17weekly_digest

Genera un report SEO settimanale in linguaggio semplice.

Distribuzione

Preferisci l'accesso remoto?

Resta disponibile il self-hosting su Cloudflare Workers con configurazione Cloudflare e Google OAuth. L'esempio seguente usa Bash; consulta SETUP.md per i passaggi completi.

~/digestseo · deploy
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deploy

Metti una stella al repository e porta Search Console dentro Claude.

Open source e self-hosted. Segui la guida Google OAuth o distribuisci un Worker personale.