Breng je Search Console-gegevens naar je assistent.
mcp-gsc verbindt Google Search Console met Claude, ChatGPT, Cursor of een andere MCP-client.
- Aanbevolen modus
- Read-only
- Authenticatie
- Google OAuth
- Uitvoeropties
- npm / Worker
- Licentie
- MIT
npm · Google Search Console MCP
GSC MCP lokaal installeren met npm
npm start een Streamable HTTP-server op je eigen computer. Je moet eerst Google OAuth en de inloggegevens instellen; het is geen verbinding met één klik.
1. Google-toegang voorbereiden
Node.js ^22.18.0 / >=24.11.0+npm- Gebruik een Google-account met toegang tot de Search Console-property die je wilt analyseren.
- Maak een OAuth-client in Google Cloud, activeer de benodigde API's en registreer de exacte lokale omleidings-URI.
- Stel deze drie omgevingsvariabelen in volgens de handleiding van deze versie. TOKEN_ENCRYPTION_KEY moet geldige base64 zijn van precies 32 willekeurige bytes.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Registreer deze URI exact in Google Cloud. Host, poort en pad moeten overeenkomen; localhost en 127.0.0.1 zijn niet uitwisselbaar.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. De lokale server starten
Start het npm-pakket nadat je de inloggegevens in je terminal hebt ingesteld. Gebruik voor analyses de alleen-lezen instelling voor jouw shell.
De standaardmodus is readwrite. Kies readonly vóór Google-autorisatie voor analyses; schrijfbewerkingen zijn dan niet beschikbaar.
Opdrachten voor Bash / zsh
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gsc PowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc Lokaal eindpunt · Streamable HTTP
http://127.0.0.1:8080/mcp 3. Je MCP-client verbinden
Laat het proces draaien en verbind een client op dezelfde computer met het lokale Streamable HTTP-endpoint, niet via stdio.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcp Codex CLI / IDE koppelen
codex mcp add gsc --url http://127.0.0.1:8080/mcp Cursor
Voeg in Cursor een Streamable HTTP MCP-server met de naam gsc en deze URL toe (lokale Cursor).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT en Claude in de cloud bereiken 127.0.0.1 op jouw computer niet. Gebruik een eigen HTTPS Worker of een ondersteunde beveiligde MCP-tunnel, afhankelijk van je accountrechten.
Toch toegang op afstand?Toch toegang op afstand?
Zelf hosten met Cloudflare Workers blijft mogelijk, met een eigen Cloudflare- en Google OAuth-configuratie. Het voorbeeld hieronder gebruikt Bash; raadpleeg SETUP.md voor alle stappen.
Over dit product
Wat is mcp-gsc?
Voer het npm-pakket lokaal uit via loopback-HTTP of zet je eigen Cloudflare Worker in voor een HTTPS-endpoint op afstand. Beide gebruiken Google OAuth.
De lokale launcher bewaart versleutelde sessiegegevens standaard in ~/.mcp-gsc/state; de Worker gebruikt opslag in je Cloudflare-account. DigestSEO host geen beheerde connector.
Importeer de prestaties van Web: multimodaal. Vergelijk pagina's en cijfers, zonder foto's te doorzoeken of bestanden te optimaliseren. Google Lens en multimodale zoekprestaties analyseren.
Vergelijk hoe Google je eigen socialmedia-accounts vindt, niet de likes of weergaven binnen apps. Vergelijk Google-zoekprestaties van je socialmediacontent.
Tools
Mogelijkheden van de server
Tools voor zoekstatistieken, URL-inspectie, sitemaps, indexering en SEO-diagnoses.
De lijst bevat optionele schrijftools. Met GSC_ACCESS_MODE=readonly zijn alleen niet-wijzigende tools beschikbaar; Google beperkt de Indexing API tot geschikte inhoudstypen.
get_capabilitiesToont de beschikbare mogelijkheden en de authenticatiestatus.
list_sitesToont de Search Console-property's waartoe het gekoppelde account toegang heeft.
query_search_analyticsVraagt kliks, vertoningen, CTR en positie op over zelfgekozen periodes.
inspect_urlHaalt actuele URL-inspectierapporten en indexeringsdetails op.
list_sitemapsToont ingediende sitemaps met hun crawlstatus en waarschuwingen.
add_siteVoegt een Search Console-property toe aan het gekoppelde account.
delete_siteVerwijdert een Search Console-property uit het account.
submit_sitemapDient een sitemap in voor een Search Console-property.
delete_sitemapVerwijdert een ingediende sitemap uit een property.
get_sitemapHaalt de gedetailleerde status van één ingediende sitemap op.
identify_quick_winsVindt zoekopdrachten met veel vertoningen op posities 8 tot en met 20.
detect_cannibalizationVindt zoekopdrachten waarbij meerdere pagina's om dezelfde zichtbaarheid strijden.
detect_content_decayWijst de pagina's aan met de grootste terugval in zoekkliks.
request_indexingVraagt indexering aan via de Indexing API van Google. Google beperkt die API momenteel tot pagina's met JobPosting-gestructureerde data of livestreampagina's met BroadcastEvent binnen VideoObject. Voor gewone pagina's is hij niet beschikbaar.
list_indexed_pagesToont de pagina's die vertoningen in Search Console hebben gekregen.
compare_performanceVergelijkt kliks, vertoningen, CTR en positie tussen periodes.
weekly_digestGenereert een wekelijks SEO-rapport in gewone taal.
Implementeren
Toch toegang op afstand?
Zelf hosten met Cloudflare Workers blijft mogelijk, met een eigen Cloudflare- en Google OAuth-configuratie. Het voorbeeld hieronder gebruikt Bash; raadpleeg SETUP.md voor alle stappen.
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 deployGSC MCP lokaal installeren met npm
Open source en zelf te hosten. Volg de Google OAuth-handleiding of implementeer je eigen Worker.