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
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
Node.js ^22.18.0 / >=24.11.0+npm- Usa un account Google con accesso alla proprietà Search Console da analizzare.
- Crea un client OAuth in Google Cloud, abilita le API necessarie e registra l'URI di reindirizzamento locale esatto.
- 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
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.
get_capabilitiesElenca le funzionalità disponibili e lo stato dell’autenticazione.
list_sitesElenca le proprietà Search Console a cui l’account collegato può accedere.
query_search_analyticsInterroga clic, impressioni, CTR e posizione su intervalli personalizzati.
inspect_urlRecupera i report di controllo URL in tempo reale e i dettagli di indicizzazione.
list_sitemapsElenca le sitemap inviate con lo stato di scansione e gli avvisi.
add_siteAggiunge una proprietà Search Console all’account collegato.
delete_siteRimuove una proprietà Search Console dall’account.
submit_sitemapInvia una sitemap per una proprietà Search Console.
delete_sitemapRimuove una sitemap inviata da una proprietà.
get_sitemapRecupera lo stato dettagliato di una singola sitemap inviata.
identify_quick_winsTrova le query con molte impressioni posizionate tra l’8ª e la 20ª posizione.
detect_cannibalizationTrova le query per cui più pagine competono per la visibilità.
detect_content_decayIndividua le pagine con il calo maggiore di clic dalla ricerca.
request_indexingRichiede 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.
list_indexed_pagesElenca le pagine che hanno ricevuto impressioni in Search Console.
compare_performanceConfronta clic, impressioni, CTR e posizione tra periodi diversi.
weekly_digestGenera 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.
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 deployMetti 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.