google-search-console-mcp

# 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: ```bash git clone https://github.com/yourusername/google-search-console-mcp.git cd google-search-console-mcp ``` 3. Maak een virtuele omgeving en installeer dependencies: ```bash python3 -m venv .venv source .venv/bin/activate # Op Windows: .venv\Scripts\activate pip install -r requirements.txt ``` 4. Maak het script uitvoerbaar: ```bash chmod +x google_search_console_server.py chmod +x setup-credentials.sh ``` 5. Setup je service account credentials: ```bash ./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](https://search.google.com/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](https://console.cloud.google.com/) 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: ```json { "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 ```json { "tool": "list_sites", "parameters": {} } ``` ### Voorbeeld 2: Top 10 pagina's van de afgelopen 30 dagen ```json { "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 ```json { "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: ```bash 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.