Search Insights einrichten: Schritt für Schritt

Diese Anleitung führt Sie Schritt für Schritt durch die Einrichtung von Search Insights in Baza Helper. Sie benötigen Administratorzugriff auf Ihre WordPress-Website und Zugriff auf das Google-Konto, dem die Search-Console-Property gehört. Die Einstellungen finden Sie unter Baza Helper > Search Insights > Settings.

Schritt 1: Ein Dienstkonto in Google Cloud erstellen

Öffnen Sie die Google Cloud Console und erstellen Sie ein Projekt oder wählen Sie ein vorhandenes aus.
Öffnen Sie APIs and services und aktivieren Sie die Google Search Console API für das Projekt.
Öffnen Sie IAM and admin > Service accounts und erstellen Sie ein Dienstkonto. Ein Name wie baza-helper reicht aus. Das Konto benötigt keine Rollen in Google Cloud.
Öffnen Sie das Dienstkonto, wechseln Sie zu Keys, wählen Sie Add key > Create new key, dann JSON und laden Sie die Datei herunter. Geben Sie diese nicht an Unbefugte weiter.

Schritt 2: Dem Dienstkonto Zugriff auf Search Console geben

Kopieren Sie die E-Mail-Adresse des Dienstkontos. Sie endet auf iam.gserviceaccount.com.
Öffnen Sie Google Search Console und wählen Sie die Property aus.
Gehen Sie zu Settings > Users and permissions und klicken Sie auf Add user.
Fügen Sie die E-Mail-Adresse ein und wählen Sie Restricted, also Lesezugriff. Vollständiger Zugriff ist nicht nötig, da Search Insights nur Daten liest.

Schritt 3: Die Speicherung des Schlüssels wählen

Wählen Sie im Tab Settings Service account (recommended) und anschließend eine der drei Möglichkeiten zur Speicherung:

Schlüssel hochladen oder einfügen. Klicken Sie auf Choose the key file (.json) oder ziehen Sie die heruntergeladene JSON-Datei in das Feld. Die Datei wird im Browser gelesen und nach einem Klick auf Save changes verschlüsselt gespeichert. Unter dem Feld können Sie den Schlüssel auch als Text einfügen.
Eine Datei auf dem Server außerhalb des öffentlich zugänglichen Webverzeichnisses. Tragen Sie den Pfad in den Einstellungen ein.
Eine Konstante in wp-config.php: BAZA_HELPER_GSC_KEY_FILE für den Dateipfad, BAZA_HELPER_GSC_KEY_JSON für den Schlüssel selbst und BAZA_HELPER_GSC_PROPERTY für die Property. So gelangt der Schlüssel nicht in die Datenbank.

Schritt 4: Die Property auswählen

Tragen Sie die Property genau so ein, wie sie in Search Console steht. Eine Domain-Property hat die Form sc-domain:example.com. Eine URL-Präfix-Property wird als vollständige Adresse angegeben, etwa https://example.com/. Über Load my properties wählen Sie aus der Liste der Properties, auf die das Konto zugreifen kann.

Schritt 5: Die Verbindung testen

Klicken Sie auf Test the connection. Der Test prüft die einzelnen Schritte nacheinander und erklärt verständlich, wo und warum etwas fehlschlägt. Beheben Sie das genannte Problem und testen Sie erneut.

Alternative: Google OAuth

Erstellen Sie in Google Cloud einen OAuth-Client vom Typ Web application.
Fügen Sie die im Tab Settings von Search Insights angezeigte Weiterleitungsadresse zur Liste der autorisierten Weiterleitungs-URIs hinzu.
Tragen Sie Client ID und Client secret in den Einstellungen ein und klicken Sie auf Connect with Google.
Erlauben Sie auf dem Google-Zustimmungsbildschirm den Lesezugriff. Die Website speichert nur das Refresh-Token in verschlüsselter Form.

Schritt 6: Den täglichen Datenabruf einrichten

Daily copy: täglichen Abruf ein- oder ausschalten und die Uhrzeit in der Zeitzone der Website wählen.
Days for the first fill: 7 bis 485 Tage. Nach der ersten Verbindung wird der gewählte Zeitraum in kleinen Schritten geladen.
Days to keep: 30 bis 485 Tage. Ältere Zeilen werden gelöscht.
Row limit per day und das Überspringen von Zeilen mit wenigen Impressionen begrenzen die Größe der Tabelle.
Search type: web, image, video, news, Discover oder Google News.
Final or fresh data: endgültige Daten sind vollständig, aber etwa zwei Tage verzögert; frische Daten sind neuer, können sich jedoch noch ändern.
Klicken Sie auf Sync now, um sofort Daten abzurufen. Der Fortschrittsbalken zeigt den Stand an.

Schritt 7: Zugriff für Ihren Assistenten freigeben

Öffnen Sie den Tab Assistant und aktivieren Sie REST, MCP oder beides.
Legen Sie fest, wer mit einem Passwort Daten lesen darf: nur Administratoren oder Redakteure und Administratoren.
Klicken Sie auf New token, vergeben Sie einen Namen und wählen Sie die Gültigkeit: unbegrenzt, 30 Tage, 90 Tage oder 1 Jahr. Kopieren Sie das Token sofort; die Website speichert nur seinen Hash.
Legen Sie fest, wie viele Anfragen pro Minute das Token erlaubt.

Einen Assistenten verbinden

Claude Code: Fügen Sie den MCP-Server mit dem Befehl aus dem Tab Assistant hinzu, etwa claude mcp add mit der MCP-Adresse und dem Token im Authorization-Header.
Cursor: Fügen Sie den mcp.json-Block aus dem Tab Assistant in die MCP-Einstellungen ein.
Jeder Chat, der Webanfragen senden kann: Kopieren Sie die Anweisung aus dem Tab Assistant. Adresse und API-Routen sind bereits enthalten.
Die Web-Konnektoren von ChatGPT und claude.ai benötigen OAuth, das für diese Verbindung noch nicht unterstützt wird.

Schritt 8: IndexNow einrichten

Öffnen Sie den Tab Indexing und suchen Sie die IndexNow-Karte.
Prüfen Sie den Schlüssel. Das Plugin stellt die Schlüsseldatei selbst bereit; der Test bestätigt ihre Erreichbarkeit.
Senden Sie eine Adressliste manuell oder aktivieren Sie das automatische Senden beim Veröffentlichen, Aktualisieren oder Löschen eines Beitrags.
Wählen Sie die Suchmaschinen aus. IndexNow funktioniert mit Bing und anderen Suchmaschinen, die das Protokoll unterstützen. Google unterstützt IndexNow nicht.
Im Protokoll sehen Sie, welche Adressen gesendet wurden und ob eine Suchmaschine geantwortet hat.

Häufige Fehler und ihre Ursachen

403, no permission: Das Dienstkonto wurde der Property nicht hinzugefügt oder hat keinen Zugriff darauf. Prüfen Sie Schritt 2.
Property not found: Der Property-Name stimmt nicht mit Search Console überein. Eine Domain-Property benötigt das Präfix sc-domain:, eine URL-Präfix-Property die genaue Adresse mit Schrägstrich. Prüfen Sie Schritt 4.
API not enabled: Die Google Search Console API ist im Google-Cloud-Projekt nicht aktiviert. Prüfen Sie Schritt 1.
URL Inspection limit: Google erlaubt etwa 2000 URL-Inspection-Prüfungen pro Property und Tag. Warten Sie bis zum nächsten Tag oder prüfen Sie weniger Seiten.
No data yet: Der erste Datenabruf läuft noch oder Google hat die neuesten Tage noch nicht veröffentlicht. Die Verzögerung beträgt meist zwei bis drei Tage.

Tabs und Einstellungen

Search Insights hat sieben Tabs: Overview, Pages, Queries, Opportunities, Indexing, Assistant und Settings. Die Schaltfläche Scan all pages of the site finden Sie unter Indexing. Speichern Sie den Schlüssel und die übrigen Einstellungen mit Save changes unten auf der Seite.

Die Schlüsseldatei lässt sich bei beiden Speicherarten auswählen oder per Drag-and-drop hinzufügen: verschlüsselt in der Datenbank oder im geschützten Ordner baza-helper-private auf dem Server.

Zuletzt geändert: 01.11.2026