GSC-SEO-Report mit n8n und Claude einrichten.
Vom JSON-Import bis zum ersten automatischen Report: die komplette Anleitung mit allen Stellen, die du anpassen musst. Gehört zum Workflow-Download aus dem Werkstatt-Artikel „SEO-Report auf Autopilot".
1. Was du hier einrichtest
Der Workflow zieht am 1. und 15. eines Monats deine Search-Console-Daten, bereitet sie auf, lässt Claude daraus einen strukturierten SEO-Report schreiben und verschickt das Ergebnis als HTML-Mail.
Am 1. und 15., jeweils 07:00 Uhr nach Server-Zeitzone.
Rollierende 30 Tage mit drei Tagen Datenverzögerung.
Executive Summary, Traffic, Seitentypen, Query-Cluster, Potenziale, Tickets.
API-Keys liegen als n8n-Credential vor, nicht im Workflow-JSON.
2. Voraussetzungen
Cloud oder self-hosted. Du brauchst die Berechtigung, Workflows und Credentials anzulegen.
Dein Google-Konto braucht Zugriff auf die Property, die ausgewertet werden soll.
Der Workflow nutzt die Claude Messages API. Den Key hinterlegst du als Header-Auth-Credential.
Der Versand läuft über einen Gmail-Node. Du kannst den Versand-Node später gegen einen anderen Mail-Dienst tauschen.
3. Einrichtung Schritt für Schritt
-
Workflow importieren
Lege in n8n einen neuen Workflow an und wähle im Drei-Punkte-Menü
Import from File. Lade die heruntergeladene JSON-Datei hoch. Danach stehen 13 verdrahtete Nodes auf der Fläche, der Workflow ist zunächst deaktiviert. -
Google-Credentials verbinden
Öffne nacheinander die fünf GSC-Nodes und wähle dein Credential vom Typ
Google Search Console OAuth2 API. Öffne danach den Gmail-Node und verbinde dein Gmail-OAuth-Credential. -
Anthropic-Credential anlegen
Erstelle in n8n ein Credential vom Typ
Header Auth:Header AuthHeader-Name: x-api-key Header-Wert: DEIN_ANTHROPIC_API_KEY
Wähle dieses Credential im Node „Claude API aufrufen" aus. API-URL, Anthropic-Version und Content-Type sind schon gesetzt.
-
GSC-Property eintragen
Öffne den Node „Datumsbereiche berechnen". Ganz oben im Code steht die Konstante
PROPERTY. Du änderst genau diese eine Zeile, alle anderen Nodes ziehen sich die Domain von dort.Domain-Propertyconst PROPERTY = 'sc-domain:deine-domain.de';
URL-Property als Alternativeconst PROPERTY = 'https://www.deine-domain.de/';
Exakt wie in der Search Console eintragen. Eine Domain-Property beginnt mitsc-domain:. Eine URL-Präfix-Property enthält das vollständige Protokoll und meist den abschließenden Slash. -
Empfängeradresse ändern
Öffne den Gmail-Node und ersetze im Feld
Toden Platzhalter[email protected]. Mehrere Empfänger trennst du per Komma. Subject und Message kommen automatisch aus dem vorherigen Node, die fasst du nicht an.
4. URL-Muster an deinen Shop anpassen
Im Node „Daten aufbereiten" entscheidet PAGE_TYPE_PATTERNS, ob eine URL als Produktdetailseite, Ratgeber, Markenseite oder statische Seite gezählt wird. Alles ohne Treffer landet bei den Kategorieseiten. Die Vorlage kommt mit einem generischen Muster: Produktseiten enden auf .html, Ratgeber liegen unter /ratgeber/.
const PAGE_TYPE_PATTERNS = {
'Produktdetailseiten': ['.html'],
'Upper Funnel / Ratgeber': ['/ratgeber/'],
'Marken / Brand-Seiten': ['/marken/'],
'Statische Seiten': [
'/kontakt', '/ueber-uns', '/about', '/faq',
'/service/', '/impressum', '/datenschutz', '/agb'
],
};const PAGE_TYPE_PATTERNS = {
'Produktdetailseiten': ['/products/'],
'Upper Funnel / Ratgeber': ['/blogs/'],
'Marken / Brand-Seiten': ['/collections/vendors'],
'Statische Seiten': [
'/pages/kontakt', '/pages/ueber-uns', '/pages/faq',
'/policies/', '/pages/impressum', '/pages/agb'
],
};const PAGE_TYPE_PATTERNS = {
'Produktdetailseiten': ['/produkt/'],
'Upper Funnel / Ratgeber': ['/ratgeber/', '/blog/'],
'Marken / Brand-Seiten': ['/marke/'],
'Statische Seiten': [
'/kontakt/', '/ueber-uns/', '/faq/',
'/impressum/', '/datenschutz/', '/agb/'
],
};5. Claude den richtigen Kontext geben
Im Node „Claude-Prompt bauen" sind zwei Stellen mit PASSE AN markiert: dein Sortiment und deine Saison. Dieser Kontext entscheidet, ob der Report Zahlen vorliest oder einordnet.
Analysiere diese GSC-Daten für unseren Online-Shop für Kaffee, Mühlen und Brüh-Zubehör. Der Shop läuft auf Shopify. Saisonaler Kontext: Oktober bis Dezember ist Geschenksaison und unser stärkster Zeitraum. Im Januar starten viele Kunden mit dem eigenen Brüh-Setup. Der Sommer ist die ruhigste Phase, Cold-Brew-Themen fangen einen Teil davon auf.
- Nenne die wichtigsten Produktgruppen und Zielgruppen.
- Erkläre, wann Hochsaison, Nebensaison und Aktionsphasen liegen.
- Nenne das Shopsystem und Besonderheiten der URL-Struktur.
- Aktualisiere die Saison-Hinweise zweimal im Jahr.
6. Du bist nicht an Claude gebunden
Die Vorlage nutzt die Anthropic API, weil der Workflow mit Claude gebaut wurde. Der Analyse-Schritt läuft aber genauso über die OpenAI API, Googles Gemini API oder jeden anderen Dienst, der einen Prompt annimmt und Text zurückgibt. Auch ein selbst gehosteter, OpenAI-kompatibler Endpunkt funktioniert, wenn deine n8n-Instanz ihn erreicht.
$json.content[0].text, das ist die Struktur der Anthropic-API. Bei OpenAI oder Gemini liegt der Text woanders. Am saubersten normalisierst du die Antwort direkt nach dem API-Aufruf auf ein einheitliches Feld wie analysisText.Was beim Wechsel unverändert bleibt:
- Die fünf Search-Console-Abfragen und die Datenaggregation.
- Der Analyse-Prompt mit seinen acht Report-Kapiteln.
- HTML-Aufbereitung und Gmail-Versand, sobald der Text wieder im erwarteten Feld liegt.
- Der Zeitplan am 1. und 15.
7. Testlauf und Aktivierung
-
Manuell ausführen
Klicke auf
Execute Workflow. Prüfe, ob alle fünf GSC-Nodes Daten liefern und der Claude-Aufruf durchläuft. -
Report prüfen
Öffne die Mail und kontrolliere Zahlen, Seitentyp-Zuordnung, Produktnamen und die vorgeschlagenen Tickets.
-
Erst dann aktivieren
Stelle den Workflow auf
Active. Der Cron-Ausdruck übernimmt ab da:Cron-Ausdruck der Vorlage0 7 1,15 * *
Wöchentlich statt alle 14 Tage?
0 7 * * 1feuert jeden Montag. Monatlich reicht0 7 1 * *.
8. API-Key und Daten sicher behandeln
Die Download-Version enthält keine echten API-Keys, Tokens, Domains oder GSC-Daten. Die sichtbaren Credential-Namen sind nur Referenzen und funktionieren in deinem n8n-Account nicht automatisch.
Im Betrieb gehen Suchanfragen, URLs, Klicks, Impressionen und Positionen an die Claude API. Wenn du den Workflow für Kunden einsetzt, kläre vorher deine vertraglichen und datenschutzrechtlichen Anforderungen.
9. Troubleshooting
Die GSC-Nodes liefern 403 oder „insufficient permissions"
Die GSC-Nodes laufen, liefern aber keine Rows
Der Claude-Node meldet 401 oder 403
x-api-key lauten. Prüfe außerdem, ob der Key aktiv ist und dein Anthropic-Konto Guthaben oder eine hinterlegte Abrechnung hat.Der Claude-Node meldet einen Modellfehler
model durch ein Modell, das in deinem API-Konto verfügbar ist.Nach dem Wechsel zu OpenAI oder Gemini bleibt der Report leer
$json.content[0].text aus, das ist Anthropic-Struktur. Passe den Pfad an den neuen Anbieter an oder normalisiere die Antwort vorher auf ein einheitliches Feld.Produkt- und Kategorieseiten werden falsch zugeordnet
PAGE_TYPE_PATTERNS an. Die Reihenfolge ist relevant: Sobald ein Muster passt, bekommt die URL diesen Seitentyp.Die Mail kommt nicht an
Der Workflow läuft zur falschen Uhrzeit
0 7 1,15 * *.10. Abschluss-Checkliste
Erst aktivieren, wenn jeder Punkt sitzt.
- Workflow-JSON importiert, alle 13 Nodes sichtbar.
- Search-Console-Credential in allen fünf GSC-Nodes ausgewählt.
- Gmail-Credential verbunden.
- Anthropic Header Auth mit
x-api-keyangelegt, oder alternativen Anbieter vollständig konfiguriert. - Bei Anbieterwechsel: Antwortpfad für den generierten Text angepasst.
- GSC-Property exakt eingetragen.
- URL-Muster an Shop- und Sprachstruktur angepasst.
- Sortiment, Shopsystem und Saison im Prompt ergänzt.
- Empfängeradresse im Gmail-Node geändert.
- Manueller Testlauf ohne Fehler durchgelaufen.
- Mail inhaltlich geprüft, erst danach aktiviert.
Du hängst bei der Einrichtung oder willst mehr?
Anderes Modell, eigene Seitentyp-Logik, zusätzliche Datenquellen oder ein Report, der wirklich zu deinem Shop passt: Schreib mir kurz, wo du stehst.
Support anfragen© 2026 Oliver Dahm · SEO- und AI-Consultant für Online-Shops · oliverdahm.de