Search-Console- und Bing-Daten per API abrufen

Ein Google-Dienstkonto mit Lesezugriff und ein Bing-API-Schlüssel für ein wöchentliches Skript, Schritt für Schritt in den deutschen Oberflächen eingerichtet.

Artikel Erstellt Aktualisiert Auch auf Englisch: Fetching Search Console and Bing Data via API

Noch nicht von einer Person geprüft

Nachdem die Website bei Google und Bing angemeldet war (Eine Website bei Google und Bing anmelden), wollte ich die Zahlen haben, ohne jede Woche durch zwei Oberflächen zu klicken. Jetzt holt ein Skript auf meinem Server sie jeden Montag, und eine geplante Claude-Aufgabe macht daraus einen Bericht mit Vorschlägen. Das Skript braucht zwei Schlüssel, und die kann nur ich anlegen, weil sie zu meinen Konten gehören. Eingerichtet habe ich beides am 21. November 2026; die Menünamen unten sind die, die die deutschen Oberflächen an dem Tag zeigten.

Wie es zusammenhängt

  • ~/bin/seo-report läuft auf dem Server jeden Montag um 5:30 UTC per Cron und legt pro Woche eine JSON-Datei in /srv/adrian-altner-com/seo/ ab.
  • Es hat vier Teile: Google Search Console, Bing Webmaster Tools, Matomo und eine eigene Prüfung aller Seiten aus der Sitemap. Ein Teil ohne Schlüssel wird übersprungen, die anderen laufen trotzdem. Mit --only google,bing laufen einzelne Teile.
  • Montagmorgens holt eine geplante Claude-Aufgabe die Datei, vergleicht sie mit der Vorwoche, schaut in die Wissensdatenbank und die letzten Kurzmeldungen und legt einen Bericht mit Checklisten in die Inbox dieser Wissensdatenbank.

Ein Probelauf vor den Schlüsseln zeigte, was ohne sie passiert: google: übersprungen (kein GSC_CREDENTIALS) und dasselbe für Bing. Die Seitenprüfung allein braucht bei etwa 780 Seiten mehr als fünf Minuten.

Google › Projekt und Dienstkonto

Die Search-Console-API nimmt nur OAuth 2.0. Für ein Skript, vor dem niemand sitzt, heißt das: ein Dienstkonto, also ein technisches Google-Konto mit eigenem Schlüssel. Lesezugriff reicht, das Skript nutzt den Scope webmasters.readonly.

  1. Die Google Cloud Console öffnen. Ohne Projekt zeigt sie einen Knopf Projekt erstellen.
  2. Das Projekt benennen, bei mir adrian-altner-com-seo. Die Projekt-ID folgt dem Namen und lässt sich später nicht ändern. Übergeordnete Ressource: Keine Organisation. Der gelbe Hinweis zum Projektkontingent ist nur eine Information.
  3. Menü, IAM und Verwaltung, Dienstkonten, Dienstkonto erstellen. Name seo-report, als Beschreibung zum Beispiel „Liest Search-Console-Daten für den Wochenbericht“. Vor dem Erstellen die ID prüfen: Auch sie bleibt für immer, und ein Tippfehler (bei mir zuerst see-report) stünde dauerhaft in der Adresse.
  4. Schritt 2 und 3 (Berechtigungen und Hauptkonten) mit Erstellen und schließen überspringen. Das Dienstkonto braucht keine Rollen im Projekt. Deshalb taucht es auf der Seite IAM nicht auf, und dort ist nichts zu ändern.
  5. In der Liste der Dienstkonten unter Aktionen, ⋮, Schlüssel verwalten, Schlüssel hinzufügen, Neuen Schlüssel erstellen, JSON. Der Browser lädt die Datei herunter. Sie enthält den privaten Schlüssel, also wie ein Passwort behandeln und nie in einen Chat einfügen.
  6. Die Adresse des Dienstkontos notieren: [email protected].

Google › API aktivieren

APIs und Dienste steht nicht in der Seitenleiste von IAM. Am schnellsten geht es über die Suchleiste oben: „Google Search Console API“ eingeben, öffnen und Aktivieren klicken. Die Seite zeigt danach den Status Aktiviert.

Mehr braucht es in der Cloud Console nicht. Unter Anmeldedaten gibt es ein Menü Anmeldedaten erstellen mit API-Schlüssel, OAuth-Client-ID und Dienstkonto: Das Skript braucht nichts davon, und der gelbe Hinweis zum Zustimmungsbildschirm betrifft nur OAuth-Clients.

Google › Dem Dienstkonto Lesezugriff geben

Die Search Console ist eine eigene Website und gehört nicht zur Cloud Console. Der direkte Link zu den Nutzern einer Domain-Property ist https://search.google.com/search-console/users?resource_id=sc-domain:adrian-altner.com; sonst Einstellungen, Nutzer und Berechtigungen.

  1. Nutzer hinzufügen.
  2. E-Mail-Adresse: die Adresse des Dienstkontos. Im Dialog stand meine eigene Gmail-Adresse, die hier falsch ist.
  3. Berechtigung: Eingeschränkt, die Stufe nur zum Lesen. Vorausgewählt war Uneingeschränkt, und das ist zu viel.
  4. Hinzufügen. Die Liste zeigt danach zwei Nutzer: mich als Inhaber und seo-report mit „Eingeschränkt“.

Google › Der Schlüssel auf dem Server

Die Datei habe ich selbst vom Mac kopiert, damit der Schlüssel nie durch einen Chat lief:

ls ~/Downloads/adrian-altner-com-seo-*.json
scp ~/Downloads/<datei>.json yaksha:/srv/adrian-altner-com/gsc-service-account.json
ssh yaksha 'chmod 600 /srv/adrian-altner-com/gsc-service-account.json && printf "GSC_CREDENTIALS=/srv/adrian-altner-com/gsc-service-account.json\n" >> /srv/adrian-altner-com/.env'
rm ~/Downloads/<datei>.json

Bing › Der API-Schlüssel

  1. In den Bing Webmaster Tools die Website wählen, dann oben rechts das Zahnrad (Einstellungen), API-Zugriff.
  2. Beim ersten Mal die Bedingungen annehmen, dann den API-Schlüssel erzeugen.

Es gibt einen Schlüssel pro Nutzer, und er gilt für alle Websites des Kontos. Gerät er in falsche Hände, auf derselben Seite löschen und einen neuen erzeugen.

Auf dem Mac schreibt das hier ihn auf den Server, ohne ihn anzuzeigen und ohne Spur in der Shell-History (zsh):

read -rs "BING?Bing-Schlüssel: " && echo && printf 'BING_WEBMASTER_KEY=%s\n' "$BING" | ssh yaksha 'cat >> /srv/adrian-altner-com/.env' && unset BING

Nach der Abfrage den Schlüssel einfügen und Enter drücken; beim Tippen erscheint nichts.

Ausprobieren

~/bin/seo-report --only google --stdout
~/bin/seo-report --only bing --stdout

Beide sollten ok melden, ohne Einträge unter skipped und errors. Meine ersten Ergebnisse, drei Tage nach der Anmeldung:

  • Google: Property sc-domain:adrian-altner.com, Daten bis zum 18. November, weil die Search Console zwei bis drei Tage hinterher ist. 0 Klicks, 0 Impressionen. Die Sitemap wurde am 18. November ohne Fehler und Warnungen gelesen: 751 URLs eingereicht, noch 0 indexiert.
  • Bing: funktioniert mit der Standardadresse https://adrian-altner.com/, BING_SITE_URL braucht es bei einer als Domain-Property importierten Website also nicht. Bisher 0 Klicks. Die Crawl-Statistik zeigte elf 301 und einen 5xx. Laut Caddy-Log bekam der echte Bingbot seit dem 18. November nur 200; der 5xx stammt vermutlich vom 17. November, als die Seite eine Zeit lang mit 502 antwortete.
  • Bots, die sich als Bingbot ausgeben, suchen nach .env und server.key und bekommen 404 oder 429. Der User-Agent allein beweist nichts.

IndexNow in Bing

Die Bing Webmaster Tools haben einen Bereich IndexNow. Solange Bing die Website noch nicht zugeordnet hat, zeigt er eine Einführung mit Get Started und einem frisch erzeugten Schlüssel. Beides ignorieren. Mein Schlüssel liegt schon als INDEXNOW_KEY in der Umgebungsdatei, und die Schlüsseldatei im Wurzelverzeichnis der Website antwortet mit 200 und dem richtigen Inhalt. Das Skript ~/bin/indexnow meldet nach jedem Push der Wissensdatenbank die geänderten Seiten, bisher immer mit HTTP 200. Ein zweiter Schlüssel würde nur Verwirrung stiften. Die Statistik erscheint, sobald Bing die Meldungen der Website zugeordnet hat, und das dauert einige Tage.

Was offen ist

  • Der erste vollständige Wochenlauf mit allen vier Teilen ist am 23. November 2026.
  • Wann Google die ersten Seiten indexiert und wann der IndexNow-Bereich in Bing die Meldungen zeigt.
  • Microsoft empfiehlt OAuth 2.0 statt API-Schlüsseln. Für ein wöchentliches Skript, das auf meinem eigenen Server nur liest, reicht der Schlüssel vorerst.

Beruht auf

  • Weekly search report for adrian-altner.com: setup (raw/2026/2026-11-18/weekly-search-report-for-adrian-altner-com-setup.md) [notes]
  • Setting up the Search Console and Bing keys for seo-report (raw/2026/2026-11-21/setting-up-the-search-console-and-bing-keys-for-seo-report.md) [chat-2026-11-21]

Mehr dazu

Thema

  • Suchmaschinenoptimierung Alles, was Suchmaschinen hilft, Seiten zu finden, zu verstehen und richtig anzuzeigen. Die Basis sind stabile URLs, klare Titel und interne Links.

Baut auf

Siehe auch

In der Graph-Ansicht zeigen