searchconsole-mcp

MCP-Server, der die Google Search Console für Ihre Projekte automatisiert: Suchanalysen, Sitemap-Verwaltung, Site-Properties und URL-Inspektion.

Tools

Related MCP server: Google Search Console + GA4 MCP Server

Einmalige Google-Einrichtung

1. Erstellen Sie in der Google Cloud Console ein Projekt.

2. Aktivieren Sie die Google Search Console API (APIs & Dienste > Bibliothek).

3. Erstellen Sie ein Dienstkonto (IAM & Verwaltung > Dienstkonten) und laden Sie einen JSON-Schlüssel herunter.

4. Für jede Property in der Search Console: Einstellungen > Nutzer und Berechtigungen > Benutzer hinzufügen, E-Mail-Adresse des Dienstkontos einfügen (...@...iam.gserviceaccount.com) und die Rolle Eigentümer zuweisen (die Rolle Eigentümer ist für die URL-Inspektion-API erforderlich).

Konfiguration

Umgebungsvariablen:

Der Server lädt beim Start außerdem .env aus seinem Arbeitsverzeichnis.

In einem MCP-Client registrieren

opencode (~/.config/opencode/opencode.json oder .opencode/opencode.json im Projekt – dort auch für andere Clients):

{
  "mcp": {
    "searchconsole": {
      "type": "local",
      "command": ["node", "/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "environment": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "searchconsole": {
      "command": "node",
      "args": ["/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "env": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Entwicklung

npm install
npm run build     # tsc -> dist/
npm start         # run the server on stdio
npm run smoke     # boots the server and lists tools

Anmerkungen

• Suchdaten hinken ~2 Tage hinterher; übergeben Sie dataState: "all", um frische Teildaten einzubeziehen.

• Die API begrenzt Analytics-Zeilen auf 25.000 pro Anfrage; verwenden Sie startRow, um zu blättern.

• Eine Website, die über die API hinzugefügt wird, bleibt bis zur Bestätigung der Eigentümerschaft unverifiziert. Der einfachste Weg besteht darin, zuerst die E-Mail-Adresse des Dienstkontos in der Benutzeroberfläche als Eigentümer hinzuzufügen.