GSC Bulk Domain Setup & Index-Checker
Wer viele Domains besitzt kennt das Problem: Domains manuell in der Search Console eintragen ist bei größeren Portfolios schlicht nicht machbar. Ich habe zwei Python-Skripte gebaut die das vollautomatisch erledigen – Domains eintragen, Indexierungsstatus prüfen, Ergebnis als CSV exportieren. Funktioniert auf Mac und Windows, keine Programmierkenntnisse nötig.Google Search Console – Bulk Domain Setup
Domain Management · Google Search Console APIBeliebig viele Domains automatisch in die Google Search Console eintragen und den Indexierungsstatus prüfen – ohne manuelle Arbeit.
- Plattformen: Mac & Windows
- Basis: Python 3.x
- Kosten: Kostenlos
- Voraussetzung: Kein Coding nötig
Inhalt
- Voraussetzungen
- Python installieren
- Google Cloud einrichten
- Python-Pakete installieren
- Dateien vorbereiten
- Domains eintragen
- Indexierung prüfen
- Fehlerbehebung
00 Voraussetzungen
Mac oder Windows: Mit aktiver Internetverbindung.
Google Account: Derselbe Account, der auch für die Search Console genutzt wird.
domains.txt: Eine einfache Textdatei mit einer Domain pro Zeile.- ⏱ Einrichtungszeit: Ca. 30 Minuten für die Ersteinrichtung, danach läuft alles vollautomatisch.
01 Python installieren
Mac
- Öffne das Terminal via
Cmd + Leertaste→ „Terminal" eingeben → Enter. - Prüfe, ob Python bereits vorhanden ist, mit dem Befehl:
python3 --version - Falls keine Versionsnummer erscheint: Rufe python.org/downloads auf und führe den macOS Installer aus.
Windows
- Rufe python.org/downloads auf und lade den Installer herunter.
- Starte den Installer.
- Wichtig: Setze unbedingt das Häkchen bei
Add Python to PATH. - Klicke auf „Install Now".
02 Google Cloud einrichten
2.1 — Projekt erstellen
- Rufe console.cloud.google.com auf.
- Klicke oben links auf „Projekt auswählen" → „Neues Projekt".
- Vergib den Namen:
gsc-bulk-domainsund klicke auf „Erstellen".
2.2 — Search Console API aktivieren
- Öffne das Menü → „APIs & Dienste" → „Bibliothek".
- Suche nach
Google Search Console API. - Klicke auf den Eintrag und wähle „Aktivieren".
2.3 — OAuth-Zustimmungsbildschirm konfigurieren
- Gehe zu Menü → „APIs & Dienste" → „OAuth-Zustimmungsbildschirm".
- Gib als App-Name
gsc-bulkein. - Wähle deine Support-E-Mail-Adresse aus.
- Klicke auf „Weiter" durch alle Schritte bis „Fertig".
- Wichtig: Klicke danach links auf „Zielgruppe" und setze den Status auf „In Produktion".
Achtung: Den Status auf „In Produktion" zu setzen ist zwingend erforderlich – sonst wird der Login später mit der Fehlermeldung „access_denied" blockiert.
2.4 — OAuth-Client-ID erstellen
- Gehe zu Menü → „APIs & Dienste" → „Anmeldedaten" → „Anmeldedaten erstellen" → „OAuth-Client-ID".
- Wähle als Anwendungstyp: Desktop-App.
- Name:
gsc-bulk-client→ Erstellen. - Klicke auf den neu erstellten Client und lade die JSON-Datei herunter.
- Benenne die heruntergeladene Datei exakt um zu:
client_secret.json
Mac-Falle: Beim Umbenennen keine zweite Endung hinzufügen – sonst heißt die Datei
client_secret.json.jsonund wird vom Skript nicht gefunden. Prüfe dies im Finder unter Ansicht → „Dateinamenerweiterungen einblenden".
03 Python-Pakete installieren
Öffne dein Terminal (Mac) oder die Eingabeaufforderung (Windows) und gib folgenden Befehl ein:pip3 install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-clientDie Installation war erfolgreich, wenn am Ende der Zeile
Successfully installedsteht.
04 Dateien vorbereiten
Erstelle einen neuen Ordner auf deinem Computer (z. B. einen Ordner namensgsc-bulk auf dem Desktop) und kopiere die folgenden vier Dateien hinein:gsc_bulk_domains.py— Das Skript zum Eintragen der Domainsgsc_check_index.py— Das Skript zum Prüfen des Indexierungsstatusclient_secret.json— Die Datei aus Schritt 2.4domains.txt— Deine Liste der Domains
domains.txt richtig erstellen
Erstelle eine einfache Textdatei. Schreibe genau eine Domain pro Zeile – ohnehttps://, ohne Slashes und ohne www (außer das www soll explizit mit zur Property gehören):Plaintext
Code:
meinedomain.de
beispiel.de
anderesdomain.de
05 Domains in Search Console eintragen
In den Ordner wechseln
Öffne das Terminal und navigiere in deinen vorbereiteten Ordner:cd ~/Desktop/gsc-bulkSkript starten
Führe den folgenden Befehl aus, um den Import zu starten:python3 gsc_bulk_domains.py --domains domains.txt --skip-indexingBeim ersten Start
- Dein Webbrowser öffnet sich automatisch.
- Logge dich mit dem entsprechenden Google Account ein und erlaube den Zugriff.
- Sobald das Browserfenster „The authentication flow has completed" anzeigt, kannst du es schließen.
- Das Skript läuft nun im Terminal automatisch durch alle Zeilen deiner Textdatei.
Terminal-Ausgabe verstehen
[OK] Eingetragen: sc-domain:meinedomain.de→ Domain wurde erfolgreich in der GSC angelegt.[SKIP] Bereits vorhanden: sc-domain:beispiel.de→ Die Domain existierte bereits in deinem Account (kein Problem).[QUOTA] Limit erreicht – warte 65s...→ Das API-Limit von Google wurde vorübergehend erreicht. Das Skript pausiert automatisch und versucht es nach der Wartezeit direkt noch einmal.
Bei Unterbrechung weitermachen
Sollte der Prozess abbrechen oder unterbrochen werden, kannst du das Skript ab einer bestimmten Zeilennummer (z. B. Zeile 200) fortsetzen lassen:python3 gsc_bulk_domains.py --domains domains.txt --skip-indexing --start-at 200Tipp für Mac-Nutzer: Lass den Mac während des Durchlaufs nicht in den Standby-Modus wechseln. Deaktiviere den Ruhezustand kurzzeitig in den Systemeinstellungen unter „Batterie" bzw. „Energie sparen".
06 Indexierungsstatus prüfen
Nachdem alle Domains erfolgreich eingetragen wurden, empfiehlt es sich, 1–2 Tage zu warten. Starte danach die Überprüfung mit:python3 gsc_check_index.py --domains domains.txtDas Skript arbeitet die Liste ab und generiert automatisch eine Datei namens
index_status.csv, die du direkt in Excel oder Numbers auswerten kannst.Bedeutung der Status-Werte in der CSV
| Status | Bedeutung |
|---|---|
| PASS | |
| FAIL | |
| NEUTRAL | |
| FEHLER | API-Fehler bei der Abfrage. |
⏱ Hinweis: Bei sehr großen Domain-Listen kann dieser Check mehrere Stunden in Anspruch nehmen. Am besten lässt du das Skript einfach über Nacht laufen. Bei einer Unterbrechung kannst du auch hier den Parameter--start-at [Nummer]anhängen.
07 Fehlerbehebung
- Fehler: Quota exceeded
- Lösung: Das Skript fängt diesen Fehler ab, wartet automatisch und versucht es bis zu 5-mal erneut. Falls es komplett abbricht, starte es einfach mit
--start-at [Zeilennummer]neu.
- Lösung: Überprüfe den Dateinamen. Besonders auf dem Mac schleicht sich oft die doppelte Endung
client_secret.json.jsonein.
- Lösung: Das Skript fängt diesen Fehler ab, wartet automatisch und versucht es bis zu 5-mal erneut. Falls es komplett abbricht, starte es einfach mit
Schnellübersicht (Ablauf auf einen Blick)
- Python installieren.
- Google Cloud Projekt erstellen & Google Search Console API aktivieren.
- OAuth-Client erstellen und die Datei als
client_secret.jsonherunterladen. - Die benötigten Python-Pakete per Terminal installieren.
- Arbeitsordner anlegen, Skripte, Secret und
domains.txthineinkopieren. gsc_bulk_domains.pystarten und einmalig im Browser authentifizieren.- 1–2 Tage warten, bis Google die Daten verarbeitet hat.
gsc_check_index.pyausführen und die finaleindex_status.csvauswerten.