Google Search Console: Beliebig viele Domains automatisch eintragen + Indexierungsstatus prüfen [Anleitung + Skripte]

[horus]

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 API
Beliebig 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​

1. Voraussetzungen
2. Python installieren
3. Google Cloud einrichten
4. Python-Pakete installieren
5. Dateien vorbereiten
6. Domains eintragen
7. Indexierung prüfen
8. 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​

1. Öffne das Terminal via Cmd + Leertaste → „Terminal" eingeben → Enter.
2. Prüfe, ob Python bereits vorhanden ist, mit dem Befehl: python3 --version
3. Falls keine Versionsnummer erscheint: Rufe python.org/downloads auf und führe den macOS Installer aus.

Windows​

1. Rufe python.org/downloads auf und lade den Installer herunter.
2. Starte den Installer.
3. Wichtig: Setze unbedingt das Häkchen bei Add Python to PATH.
4. Klicke auf „Install Now".

02 Google Cloud einrichten​

2.1 — Projekt erstellen​

1. Rufe console.cloud.google.com auf.
2. Klicke oben links auf „Projekt auswählen" → „Neues Projekt".
3. Vergib den Namen: gsc-bulk-domains und klicke auf „Erstellen".

2.2 — Search Console API aktivieren​

1. Öffne das Menü → „APIs & Dienste" → „Bibliothek".
2. Suche nach Google Search Console API.
3. Klicke auf den Eintrag und wähle „Aktivieren".

2.3 — OAuth-Zustimmungsbildschirm konfigurieren​

1. Gehe zu Menü → „APIs & Dienste" → „OAuth-Zustimmungsbildschirm".
2. Gib als App-Name gsc-bulk ein.
3. Wähle deine Support-E-Mail-Adresse aus.
4. Klicke auf „Weiter" durch alle Schritte bis „Fertig".
5. 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​

1. Gehe zu Menü → „APIs & Dienste" → „Anmeldedaten" → „Anmeldedaten erstellen" → „OAuth-Client-ID".
2. Wähle als Anwendungstyp: Desktop-App.
3. Name: gsc-bulk-client → Erstellen.
4. Klicke auf den neu erstellten Client und lade die JSON-Datei herunter.
5. 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.json und 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-client

Die Installation war erfolgreich, wenn am Ende der Zeile Successfully installed steht.

04 Dateien vorbereiten​

Erstelle einen neuen Ordner auf deinem Computer (z. B. einen Ordner namens gsc-bulk auf dem Desktop) und kopiere die folgenden vier Dateien hinein:

1. gsc_bulk_domains.py — Das Skript zum Eintragen der Domains
2. gsc_check_index.py — Das Skript zum Prüfen des Indexierungsstatus
3. client_secret.json — Die Datei aus Schritt 2.4
4. domains.txt — Deine Liste der Domains

domains.txt richtig erstellen​

Erstelle eine einfache Textdatei. Schreibe genau eine Domain pro Zeile – ohne https://, ohne Slashes und ohne www (außer das www soll explizit mit zur Property gehören):
Plaintext

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-bulk

Skript starten​

Führe den folgenden Befehl aus, um den Import zu starten: python3 gsc_bulk_domains.py --domains domains.txt --skip-indexing

Beim ersten Start​

1. Dein Webbrowser öffnet sich automatisch.
2. Logge dich mit dem entsprechenden Google Account ein und erlaube den Zugriff.
3. Sobald das Browserfenster „The authentication flow has completed" anzeigt, kannst du es schließen.
4. 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 200

Tipp 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.txt
Das 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	Domain ist bei Google erfolgreich indexiert.
FAIL	Domain ist aktuell nicht indexiert.
NEUTRAL	Google hat die Domain zwar gecrawlt, aber (noch) nicht indexiert.
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.json ein.

Schnellübersicht (Ablauf auf einen Blick)​

1. Python installieren.
2. Google Cloud Projekt erstellen & Google Search Console API aktivieren.
3. OAuth-Client erstellen und die Datei als client_secret.json herunterladen.
4. Die benötigten Python-Pakete per Terminal installieren.
5. Arbeitsordner anlegen, Skripte, Secret und domains.txt hineinkopieren.
6. gsc_bulk_domains.py starten und einmalig im Browser authentifizieren.
7. 1–2 Tage warten, bis Google die Daten verarbeitet hat.
8. gsc_check_index.py ausführen und die finale index_status.csv auswerten.