Predictive SEO — Vollständige Dokumentation

Überblick

DataFirefly Predictive SEO verbindet Ihren PrestaShop mit Google Search Console, wendet eine eingebettete ML-Vorhersage-Engine auf die Suchhistorie an und identifiziert automatisch kommende saisonale Peaks. Für jede erkannte Chance können Sie mit einem Klick ein strukturiertes Content-Briefing via Mistral, OpenAI oder Claude generieren.

Voraussetzungen

• PrestaShop 8.0+ oder PrestaShop 9.x
• PHP 8.1 minimum
• MySQL 5.7+ oder MariaDB 10.3+
• Ein Google-Konto mit Zugriff auf die Search Console Property des Shops
• Einen API-Schlüssel eines KI-Anbieters (Mistral, OpenAI oder Anthropic — Mistral standardmäßig, ca. 0,002 € pro Briefing)
• Mindestens 60 bis 90 Tage GSC-Historie für zuverlässige Vorhersagen

Installation

Installation aus dem ZIP

1. Laden Sie das ZIP dfpredictiveseo.zip aus Ihrem DataFirefly Kundenbereich herunter.
2. Im PrestaShop Back-Office gehen Sie zu Module → Module Manager.
3. Klicken Sie auf Modul hochladen und ziehen Sie das ZIP hinein.
4. Das Modul installiert sich automatisch, erstellt die 7 dfpseo_*-Tabellen, registriert die 6 Tabs unter IMPROVE und generiert ein eindeutiges Cron-Token.
5. Nach der Installation finden Sie das Modul im Menü Verbessern → Predictive SEO.

Datenbankschema

Die Installation erstellt 7 Tabellen mit dem Präfix dfpseo_:

• dfpseo_keyword — Keywords aus GSC getrackt
• dfpseo_history — tägliche Historie (Impressionen, Klicks, CTR, Position)
• dfpseo_forecast — tägliche Vorhersagen mit Konfidenzintervallen
• dfpseo_opportunity — erkannte saisonale Chancen
• dfpseo_recommendation — von der KI generierte Content-Briefings
• dfpseo_seasonality — saisonale Indizes (Wochentag × Monat) pro Keyword
• dfpseo_sync_log — Journal der GSC-Synchronisationen

Google Search Console Einrichtung

Das Modul verwendet das standardisierte OAuth2-Protokoll. Sie erstellen einen OAuth Client in Google Cloud, fügen die Anmeldedaten in die Einstellungen ein und starten den Autorisierungsflow über die Verbinden-Schaltfläche.

Schritt 1 — Google Cloud Projekt erstellen

1. Gehen Sie zu console.cloud.google.com und melden Sie sich mit dem Google-Konto an, das Zugriff auf Ihre Search Console Property hat.
2. Klicken Sie auf den Projektauswähler oben links, dann auf Neues Projekt.
3. Nennen Sie es beispielsweise DataFirefly Predictive SEO und erstellen Sie es.

Schritt 2 — Search Console API aktivieren

1. Im linken Menü gehen Sie zu APIs & Dienste → Bibliothek.
2. Suchen Sie nach Search Console API und klicken Sie auf Aktivieren.

Schritt 3 — OAuth-Zustimmungsbildschirm konfigurieren

1. Gehen Sie zu APIs & Dienste → OAuth-Zustimmungsbildschirm.
2. Nutzertyp: Extern.
3. Füllen Sie App-Name, Support-E-Mail, autorisierte Domain (Ihren Shop) aus.
4. Unter Bereiche fügen Sie https://www.googleapis.com/auth/webmasters.readonly hinzu (Search Console nur lesen).
5. Im Testmodus fügen Sie Ihre E-Mail unter Testnutzer hinzu. Sie können später ohne Modulanpassung in die Produktion wechseln.

Schritt 4 — OAuth Client erstellen

1. Gehen Sie zu APIs & Dienste → Anmeldedaten.
2. Klicken Sie auf Anmeldedaten erstellen → OAuth-Client-ID.
3. Anwendungstyp: Webanwendung.
4. Name: frei wählbar (z. B. Predictive SEO Produktion).
5. Autorisierter Weiterleitungs-URI: Kopieren Sie den in den Moduleinstellungen angezeigten URI (Improve → Predictive SEO → Einstellungen → Google Search Console → Weiterleitungs-URI). Format: https://ihr-shop.com/module/dfpredictiveseo/settings/oauth_callback.
6. Klicken Sie auf Erstellen — Google zeigt client_id und client_secret an.

Schritt 5 — Modul verbinden

1. In den Predictive SEO Einstellungen fügen Sie client_id und client_secret ein.
2. Speichern.
3. Klicken Sie auf Mit Google Search Console verbinden.
4. Sie werden zur Zustimmungsseite von Google weitergeleitet. Erlauben Sie den schreibgeschützten Zugriff.
5. Zurück im Back-Office hat das Modul das verschlüsselte refresh_token gespeichert und ist synchronisationsbereit.
6. Wählen Sie dann die zu trackende Search Console Property im Dropdown aus (das Modul erkennt sie automatisch nach der Verbindung).

KI-Anbieter Einrichtung

Das Modul unterstützt 3 KI-Anbieter zur Generierung von Content-Briefings. Sie benötigen nur einen, und Sie liefern Ihren eigenen API-Schlüssel des gewählten Anbieters — DataFirefly erhebt keine Gebühren auf die Nutzung.

Mistral (Standard, empfohlen)

• Modell: mistral-small-latest
• Indikativer Preis: ca. 0,002 € pro generiertem Briefing
• Schlüssel erstellen: console.mistral.ai → API Keys
• Schlüssel einfügen in Einstellungen → KI-Anbieter → Mistral API-Schlüssel

OpenAI

• Modell: gpt-4o-mini
• Indikativer Preis: ca. 0,005 € pro Briefing
• Schlüssel erstellen: platform.openai.com → API keys
• Schlüssel einfügen in Einstellungen → KI-Anbieter → OpenAI API-Schlüssel

Anthropic (Claude)

• Modell: claude-3-5-haiku-latest
• Indikativer Preis: ca. 0,004 € pro Briefing
• Schlüssel erstellen: console.anthropic.com → API Keys
• Schlüssel einfügen in Einstellungen → KI-Anbieter → Anthropic API-Schlüssel

Wählen Sie anschließend den aktiven Anbieter im Dropdown Aktiver KI-Anbieter. Bei einem Anbieterwechsel werden bereits generierte Briefings nicht automatisch neu erzeugt.

Datensynchronisation

Erste Synchronisation

Sobald die GSC-Verbindung steht, starten Sie eine erste manuelle Synchronisation: Einstellungen → Synchronisation starten. Das Modul ruft die Historie der letzten 90 Tage für die ausgewählte Property ab — bis zu 250 000 Zeilen pro Synchronisation, mit den Dimensionen Datum × Anfrage × Seite. Die erste Synchronisation kann je nach Volumen 30 Sekunden bis 2 Minuten dauern.

Täglicher Cron

Für automatische Synchronisationen konfigurieren Sie einen täglichen Cron (empfohlen: früh am Morgen, 4-6 Uhr Pariser Zeit), der den gesicherten Endpunkt des Moduls aufruft.

Die genaue URL und das Token werden in Einstellungen → Cron angezeigt. Generisches Format:

https://ihr-shop.com/module/dfpredictiveseo/cron/sync?token=IHR_GENERIERTES_TOKEN

Beispiel-Crontab-Zeile (Unix Cron):

0 5 * * * curl -s "https://ihr-shop.com/module/dfpredictiveseo/cron/sync?token=IHR_TOKEN" > /dev/null 2>&1

Pipeline einer Synchronisation

Jede Synchronisation läuft in folgender Reihenfolge ab:

1. GSC-Pull über die letzten 90 rollenden Tage (Dimensionen Datum/Anfrage/Seite)
2. Einfügen/Aktualisieren in dfpseo_keyword und dfpseo_history
3. Neuberechnung der saisonalen Indizes (pro Keyword mit ausreichender Historie)
4. Generierung der Forecasts über den konfigurierten Horizont
5. Erkennung von Chancen über das Zukunftsfenster
6. Logging in dfpseo_sync_log

Dashboard

Das Dashboard (Improve → Predictive SEO → Dashboard) bündelt die wichtigsten Indikatoren:

• 4 KPI-Karten: getrackte Keywords, kommende Chancen, vorhergesagte Klicks in 14 Tagen, letzte GSC-Synchronisation
• Hauptdiagramm: aggregierte Historienkurve (90 Tage) + Forecast (konfigurierter Horizont, 30 Tage standardmäßig), mit 95% Konfidenzband
• Top-Chancen: die 10 nächsten saisonalen Peaks nach Score sortiert
• Sync-Journal: die 5 letzten Synchronisationen mit ihrem Status

Verbindungsstatus

Zwei Badges oben im Dashboard zeigen den Status der Integrationen an: GSC verbunden (grün/rot) und KI-Anbieter konfiguriert (grün/rot). Wenn einer rot ist, folgen Sie dem direkten Link zu den entsprechenden Einstellungen.

Keywords & Vorhersagen

Keyword-Liste

Der Tab Keywords zeigt das native PrestaShop-Grid mit allen synchronisierten Anfragen. Spalten: Anfrage, Landing Page, 30-Tage-Impressionen, 30-Tage-Klicks, CTR, durchschnittliche Position, letzte Aktualisierung. Sie können filtern, sortieren und exportieren.

Detailansicht pro Keyword

Ein Klick auf ein Keyword öffnet seine Karte:

• Individuelle Historie + persönliche Forecast-Kurve
• 95% Konfidenzintervall um die Vorhersage
• 12 × 7 saisonale Heatmap (Monat × Wochentag)
• Berechnete saisonale Indizes
• Liste der mit diesem Keyword verknüpften Chancen

Saisonalitäts-Heatmap

Die Heatmap visualisiert die multiplikativen saisonalen Indizes. Lesart:

• Zelle bei 1,00 → durchschnittlicher Traffic für diese Monat × Tag-Kombination
• Zelle bei 1,50 → Traffic 50% über dem Durchschnitt (saisonaler Peak)
• Zelle bei 0,60 → Traffic 40% unter dem Durchschnitt (Tief)

Die Zellen sind von blassblau (Tief) zu tiefblau und orangerot (Peak) gefärbt. Ein Blick genügt, um die zu nutzenden Wochen zu erkennen.

Saisonale Chancen

Automatische Erkennung

Eine Chance wird erkannt, wenn über ein 14-Tage-Zukunftsfenster (konfigurierbar via DFPSEO_OPPORTUNITY_LOOKAHEAD_DAYS):

• Die Vorhersage die Baseline des Keywords × 1,25 übersteigt (Peak-Schwellwert)
• UND der saisonale Index der Monat × Tag-Kombination größer als 1,10 ist

Zusammenhängende Peaks (Lücke ≤ 2 Tage) werden zu einer einzigen Chance gruppiert, die das gesamte Fenster abdeckt.

Chancen-Score

Der Score kombiniert drei Faktoren:

score = erwartete_klicks × lift × konfidenz

• erwartete_klicks: Summe der vorhergesagten Klicks über das Fenster
• lift: Peak / Baseline Verhältnis
• konfidenz: Breite des Vorhersageintervalls (je schmaler, desto höher der Score)

Ein Score > 80 weist auf eine Chance mit hohem Potenzial und starkem saisonalen Signal hin. Ein Score 40-80 weist auf eine moderate Chance hin. Unter 40 ist das Signal zu schwach oder zu unsicher, um eine prioritäre Aktion zu rechtfertigen.

Chancen-Workflow

Jede Chance hat einen Status:

• Neu — frisch erkannt, wartet auf Entscheidung
• In Bearbeitung — ein Briefing wurde generiert, in redaktioneller Arbeit
• Erledigt — Content veröffentlicht, Chance genutzt
• Ignoriert — Entscheidung, nicht zu verarbeiten (False Positive, außerhalb der Strategie)

KI-Empfehlungen

Ein Briefing generieren

Von jeder Chance aus klicken Sie auf Briefing generieren. Das Modul sendet eine Anfrage an den aktiven KI-Anbieter mit dem Kontext des Keywords (Volumen, Saisonalität, aktuelle Position, betroffene Seite) und erhält ein strukturiertes JSON-Briefing mit:

• summary — strategische Zusammenfassung des Briefings
• meta_description — SEO Meta-Description zum Einfügen (150-160 Zeichen)
• search_intent — dominante Suchintention (informational / transaktional / navigational / kommerziell)
• outline — detaillierter h1/h2/h3-Plan des Artikels oder der Seite
• keywords_to_include — einzuschließende semantische Keywords
• internal_links — Vorschläge für interne Verlinkung zu anderen Seiten der Site
• rationale — strategische Begründung der Empfehlung

Die Generierung dauert je nach Anbieter 1 bis 3 Sekunden.

Genehmigungs-Workflow

Jedes Briefing durchläuft die Statuus:

1. Pending — generiert, wartet auf Review
2. Approved — für die Redaktion validiert
3. Published — Content online (manuell zu markieren)
4. Rejected — abgelehnt (schlechte Qualität oder Off-Topic)
5. Draft — in Bearbeitung

Der Workflow ermöglicht eine klare Nachverfolgung dessen, was bearbeitet wurde.

Technische Architektur

Stack

• PSR-4 Architektur, Namespace DfPredictiveSeo → src/
• Symfony-Controller, die FrameworkBundleAdminController erweitern
• Doctrine DBAL Repositories (kein ObjectModel)
• GSC direkt per REST über cURL + OAuth2 erreicht (kein google/apiclient, um leichtgewichtig zu bleiben)
• Keine zwingende Composer-Abhängigkeit bei der Installation (eingebetteter PSR-4 Autoloader)

ML-Pipeline

1. Multiplikative saisonale Zerlegung: Wochentag- und Monatsindizes berechnet via 28-Tage zentriertem gleitenden Durchschnitt und 10% gestutztem Mittel
2. OLS-Regression auf log(impressionen+1) zur Modellierung des log-linearen Trends
3. Forecast: exp(prediction_log) × saisonaler_index_tag × saisonaler_index_monat
4. 95% Intervalle: Student-Approximation auf dem Residualfehler der Regression, progressive Verbreiterung mit dem Horizont

Cron-Endpunkt

Der Endpunkt ist öffentlich, aber Token-geschützt. PHP-Beispiel für programmatische Aufrufe:

$token = 'ihr_cron_token';
$url = 'https://ihr-shop.com/module/dfpredictiveseo/cron/sync?token=' . $token;
$response = file_get_contents($url);
$data = json_decode($response, true);
// $data['status'] = 'ok' | 'error'
// $data['keywords_synced'] = Anzahl der aktualisierten Keywords
// $data['opportunities_detected'] = Anzahl der neu erkannten Chancen

Konfigurationsvariablen

Das Modul speichert 18 Konfigurationsschlüssel in der Tabelle ps_configuration:

• DFPSEO_GSC_CLIENT_ID, DFPSEO_GSC_CLIENT_SECRET, DFPSEO_GSC_REFRESH_TOKEN (verschlüsselt), DFPSEO_GSC_PROPERTY
• DFPSEO_AI_PROVIDER, DFPSEO_AI_MISTRAL_KEY, DFPSEO_AI_OPENAI_KEY, DFPSEO_AI_ANTHROPIC_KEY
• DFPSEO_FORECAST_HORIZON_DAYS (Standard: 30)
• DFPSEO_OPPORTUNITY_LOOKAHEAD_DAYS (Standard: 14)
• DFPSEO_PEAK_THRESHOLD (Standard: 1.25)
• DFPSEO_SEASONAL_THRESHOLD (Standard: 1.10)
• DFPSEO_CRON_TOKEN (bei der Installation generiert)
• DFPSEO_LAST_SYNC, DFPSEO_LAST_FORECAST

Fehlerbehebung

redirect_uri_mismatch Fehler beim Verbinden mit GSC

Der in Google Cloud konfigurierte Weiterleitungs-URI stimmt nicht exakt mit dem vom Modul erwarteten überein. Überprüfen Sie:

• Protokoll: https:// und nicht http://
• Kein Trailing Slash: ...oauth_callback und nicht ...oauth_callback/
• Subdomain: www. oder nicht je nach Ihrem Shop, muss übereinstimmen

Die GSC-Synchronisation liefert keine Keywords

• Überprüfen Sie, dass die in den Einstellungen ausgewählte Property tatsächlich SEO-Traffic erhält (und keine leere Domain-Property)
• Überprüfen Sie, dass das verbundene Google-Konto Inhaber oder autorisierter Benutzer dieser Property ist
• Die Property muss mindestens einige Tage indexierte Historie haben (Google Search Console veröffentlicht Daten mit 2-3 Tagen Verzögerung)

Die Vorhersagen scheinen unzuverlässig

• Überprüfen Sie, dass Sie mindestens 60-90 Tage Historie haben. Darunter können die saisonalen Indizes nicht korrekt geschätzt werden
• Für erratische Keywords (wenig Signal, viel Rauschen) wird die 95%-Intervallbreite absichtlich erweitert — das Modul zeigt explizit eine niedrige Konfidenz an
• Für präzisere Vorhersagen über lange Horizonte (60-90 Tage) warten Sie, bis Sie 6-12 Monate Historie angesammelt haben. Die Engine verbessert sich mit der Zeit

Cron-Endpunkt gibt Fehler 403 zurück

Das in der Query-String übergebene Token entspricht nicht DFPSEO_CRON_TOKEN. Überprüfen Sie den exakten Wert in Einstellungen → Cron. Im Zweifelsfall regenerieren Sie das Token und aktualisieren Ihre Crontab.

Das KI-Briefing wird nicht generiert

• Überprüfen Sie, dass Sie einen gültigen API-Schlüssel für den ausgewählten aktiven Anbieter eingefügt haben
• Überprüfen Sie Ihr Guthaben auf der Anbieter-Konsole (Mistral, OpenAI oder Anthropic)
• Wenn der Anbieter einen Rate-Limit-Fehler zurückgibt, warten Sie einige Minuten und versuchen Sie es erneut
• Generierte Briefings werden in dfpseo_recommendation gespeichert; bei einem Fehler wird der Fehler auch in dieser Tabelle mit dem Status error protokolliert

FAQ

Funktioniert das Modul ohne Google Search Console?

Nein, GSC ist die primäre Datenquelle. Das Modul benötigt mindestens 60 bis 90 Tage Historie, um zuverlässige Vorhersagen zu produzieren und Saisonalität zu berechnen. Wenn Ihr Shop gerade gestartet wurde, warten Sie, bis Sie mindestens 2 Monate indexierte Daten haben, bevor Sie das Modul installieren.

Was kostet ein KI-Briefing?

Das hängt vom gewählten Anbieter ab. Mit Mistral (Standard) rechnen Sie mit ca. 0,002 € pro Briefing. OpenAI GPT-4o-mini ca. 0,005 €. Claude Haiku ca. 0,004 €. Sie liefern Ihren eigenen API-Schlüssel und zahlen direkt an den Anbieter — DataFirefly erhebt keine Gebühren.

Wie viele Keywords kann das Modul tracken?

Es gibt keine fest codierte Grenze. Eine Standard-Synchronisation ruft bis zu 250 000 Zeilen (Datum × Anfrage × Seite) pro Aufruf ab — das deckt nahezu alle Shops ab. Darüber hinaus erhöhen Sie den dem Cron-Worker zugewiesenen PHP-Speicher.

Ist das Modul mit anderen SEO-Modulen kompatibel?

Ja, Predictive SEO schreibt nie auf Produktseiten oder Meta — es liest nur GSC und produziert Empfehlungen. Es ist vollständig kompatibel mit allen vorhandenen SEO-Modulen (DataFirefly oder Drittanbieter).

Werden meine GSC-Daten bei DataFirefly gespeichert?

Nein. Alle Daten bleiben auf Ihrem Server, in Ihrer PrestaShop-Datenbank. Das Modul ruft die Google API direkt mit Ihren OAuth-Anmeldedaten auf und ruft die KI-Anbieter direkt mit Ihrem API-Schlüssel auf. Keine Daten passieren die DataFirefly-Server.

Welcher Vorhersagehorizont ist am zuverlässigsten?

Der Horizont 7-14 Tage ist sehr zuverlässig (schmales 95%-Intervall). Der Horizont 30-60 Tage ist indikativ (erweitertes Intervall). Über 90 Tage hinaus werden Vorhersagen für operative Entscheidungen wenig nützlich — das Modul berechnet sie, zeigt aber eine niedrige Konfidenz an.