Google Search Console MCP Server

Een MCP server die de Google Search Console API beschikbaar maakt voor gebruik in n8n workflows via de MCP Client node.

Functionaliteiten

• Lijst alle Search Console sites op
• Ophalen van search analytics data
• Top zoektermen en pagina's bekijken
• URL indexeringsstatus controleren
• Sitemap informatie opvragen

Installatie

1. Zorg dat Python 3.7+ is geïnstalleerd op je server

2. Clone de repository:

   git clone https://github.com/yourusername/google-search-console-mcp.git
   cd google-search-console-mcp
   

3. Maak een virtuele omgeving en installeer dependencies:

   python3 -m venv .venv
   source .venv/bin/activate  # Op Windows: .venv\Scripts\activate
   pip install -r requirements.txt
   

4. Maak het script uitvoerbaar:

   chmod +x google_search_console_server.py
   chmod +x setup-credentials.sh
   

5. Setup je service account credentials:

   ./setup-credentials.sh
   

   Je kunt een bestaand service account credentials bestand gebruiken of de JSON direct plakken.

Google API Credentials

Bestaand service account hergebruiken

Als je al een service account hebt (bijvoorbeeld voor Google Ads), kun je dezelfde gebruiken voor Search Console:

1. Voer het setup script uit: ./setup-credentials.sh
2. Kies optie 1 of 2 om je bestaande credentials in te voeren
3. Geef het service account toegang tot je Search Console properties:
   • Ga naar Google Search Console
   • Selecteer de property
   • Klik op Instellingen > Gebruikers en machtigingen
   • Voeg het service account e-mailadres toe als gebruiker

Nieuw service account aanmaken

Als je nog geen service account hebt:

1. Ga naar Google Cloud Console
2. Maak een nieuw project of gebruik een bestaand project
3. Activeer de Google Search Console API
4. Maak een Service Account aan
5. Download het JSON credentials bestand
6. Gebruik het setup script om je credentials in te stellen: ./setup-credentials.sh

Gebruik met n8n

1. Open n8n en voeg een MCP Client (STDIO) node toe
2. Configureer de credentials:
   • Command: /pad/naar/.venv/bin/python (bijv. /home/username/google-search-console-mcp/.venv/bin/python)
   • Arguments: /pad/naar/google_search_console_server.py (bijv. /home/username/google-search-console-mcp/google_search_console_server.py)
   • Environment:

     SERVICE_ACCOUNT_JSON=/pad/naar/service_account_credentials.json
     

Voorbeeld: Ophalen van top zoektermen

1. Voeg een MCP Client node toe aan je workflow
2. Selecteer de operatie 'Execute Tool'
3. Kies tool: 'get_top_queries'
4. Parameters:

   {
     "site_url": "sc-domain:example.com",
     "start_date": "2023-01-01",
     "end_date": "2023-01-31"
   }
   

Beschikbare tools

• list_sites: Lijst alle Search Console sites op
• get_search_analytics: Haal search analytics data op voor een site
• get_top_queries: Haal top zoektermen op voor een site
• get_top_pages: Haal top pagina's op voor een site
• get_queries_for_url: Haal zoektermen op voor een specifieke URL
• inspect_url: Controleer URL indexeringsstatus
• list_sitemaps: Lijst alle sitemaps voor een site

Voorbeelden voor n8n workflow

Voorbeeld 1: Lijst van alle sites ophalen

{
  "tool": "list_sites",
  "parameters": {}
}

Voorbeeld 2: Top 10 pagina's van de afgelopen 30 dagen

{
  "tool": "get_top_pages",
  "parameters": {
    "site_url": "sc-domain:example.com",
    "start_date": "2023-03-01",
    "end_date": "2023-03-31",
    "row_limit": 10
  }
}

Voorbeeld 3: URL indexeringsstatus controleren

{
  "tool": "inspect_url",
  "parameters": {
    "site_url": "sc-domain:example.com",
    "url": "https://example.com/pagina"
  }
}

Automatische installatie

Voor een volledig automatische installatie kun je ook het install.sh script gebruiken:

chmod +x install.sh
./install.sh

Veiligheid

• Service account credentials worden lokaal opgeslagen en NIET naar Git gepusht (via .gitignore)
• Gebruik altijd een veilige locatie voor je credentials.json bestand
• Geef het service account alleen toegang tot de Search Console properties die het nodig heeft

Licentie

MIT

Bijdragen

Pull requests zijn welkom. Voor grote wijzigingen, open eerst een issue om te bespreken wat je wilt veranderen.