Ga naar de hoofdinhoud
Google Search Console · MCP
Google Search Console · MCP

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
Google Search Console MCP in het Nederlands | DigestSEO
mcp-gsc verbindt Google Search Console met Claude, ChatGPT, Cursor of een andere MCP-client.

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

  1. Node.js ^22.18.0 / >=24.11.0 + npm
  2. Gebruik een Google-account met toegang tot de Search Console-property die je wilt analyseren.
  3. Maak een OAuth-client in Google Cloud, activeer de benodigde API's en registreer de exacte lokale omleidings-URI.
  4. 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

Volledige handleiding (SETUP.md)

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.

01get_capabilities

Toont de beschikbare mogelijkheden en de authenticatiestatus.

02list_sites

Toont de Search Console-property's waartoe het gekoppelde account toegang heeft.

03query_search_analytics

Vraagt kliks, vertoningen, CTR en positie op over zelfgekozen periodes.

04inspect_url

Haalt actuele URL-inspectierapporten en indexeringsdetails op.

05list_sitemaps

Toont ingediende sitemaps met hun crawlstatus en waarschuwingen.

06add_site

Voegt een Search Console-property toe aan het gekoppelde account.

07delete_site

Verwijdert een Search Console-property uit het account.

08submit_sitemap

Dient een sitemap in voor een Search Console-property.

09delete_sitemap

Verwijdert een ingediende sitemap uit een property.

10get_sitemap

Haalt de gedetailleerde status van één ingediende sitemap op.

11identify_quick_wins

Vindt zoekopdrachten met veel vertoningen op posities 8 tot en met 20.

12detect_cannibalization

Vindt zoekopdrachten waarbij meerdere pagina's om dezelfde zichtbaarheid strijden.

13detect_content_decay

Wijst de pagina's aan met de grootste terugval in zoekkliks.

14request_indexing

Vraagt 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.

15list_indexed_pages

Toont de pagina's die vertoningen in Search Console hebben gekregen.

16compare_performance

Vergelijkt kliks, vertoningen, CTR en positie tussen periodes.

17weekly_digest

Genereert 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.

~/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

GSC MCP lokaal installeren met npm

Open source en zelf te hosten. Volg de Google OAuth-handleiding of implementeer je eigen Worker.