AI Competitor — Wettbewerber-Preismonitoring

Überblick

AI Competitor überwacht die Preise Ihrer Wettbewerber direkt aus dem PrestaShop-Backoffice. Für jedes Produkt Ihres Katalogs hinterlegen Sie eine oder mehrere Wettbewerber-URLs; das Modul besucht sie nach Zeitplan, extrahiert den angezeigten Preis (mit KI-Fallback, wenn klassische Methoden versagen), erkennt signifikante Änderungen, benachrichtigt Sie per E-Mail und schlägt einen angepassten Preis gemäß Ihrer Preisstrategie vor.

Installation

1. Öffnen Sie im Backoffice Module → Modul-Manager → Modul hochladen.
2. Laden Sie die Datei dfaicompetitor.zip hoch.
3. Das Modul installiert sich und legt automatisch seine drei Tabellen an (dfaicompetitor_url, dfaicompetitor_price, dfaicompetitor_alert) sowie das Menü Katalog → AI Competitor.

Bei der Installation wird ein eindeutiger Cron-Token generiert. Sie finden ihn auf dem Modul-Dashboard.

Erstkonfiguration

Öffnen Sie Katalog → AI Competitor. Das Dashboard bündelt die Statistiken und vier Konfigurationsblöcke.

KI-Anbieter

Der KI-Fallback ist optional, aber dringend empfohlen: Er übernimmt, wenn eine Wettbewerberseite weder strukturierte Daten noch einen nutzbaren Selektor bereitstellt. Drei Anbieter werden unterstützt:

• Mistral AI (Standard) — am günstigsten, empfohlenes Modell: mistral-small-latest
• Anthropic Claude — beste Präzision auf komplexen Seiten, empfohlenes Modell: claude-haiku-4-5-20251001
• OpenAI — solider Mittelweg, empfohlenes Modell: gpt-4o-mini

Tragen Sie den API-Schlüssel des gewählten Anbieters ein. Er wird maskiert angezeigt; lassen Sie das Feld bei späteren Speichervorgängen leer, um den hinterlegten Schlüssel zu behalten. Sie zahlen direkt an den Anbieter, ohne DataFirefly-Aufschlag.

Warnungen

• Benachrichtigungs-E-Mail — Empfänger der Alert-Digests und des Wochenberichts.
• Änderungsschwelle — in Prozent (3 % Standard). Darunter wird keine Warnung erzeugt.
• Wochenbericht-Tag — standardmäßig Montag.

Scraping

• URLs pro Cron-Stapel — Anzahl der pro Lauf verarbeiteten URLs (20 Standard).
• Standardintervall — in Stunden, für neue URLs (24 h Standard).
• HTTP-Timeout und User-Agent — der mitgelieferte User-Agent ist identifizierbar (DataFireflyBot); Sie können ihn anpassen.

Anpassungsstrategie

Drei Strategien bestimmen den vorgeschlagenen Preis, stets ausgehend vom günstigsten Wettbewerber:

• Matchen — gleicher Preis wie der niedrigste Wettbewerber.
• Undercut um X % — X % darunter (Standard: 1 %).
• Premium bei X % — X % darüber, für eine bewusste Premium-Positionierung.

Wettbewerber-URLs hinzufügen

Öffnen Sie Katalog → AI Competitor → Competitor URLs → Hinzufügen. Jede Zeile verknüpft eines Ihrer Produkte mit einer Wettbewerberseite:

• Produkt — aus Ihrem Katalog gewählt.
• Wettbewerbername — freies Label (Amazon, Otto, jede Händlerseite…).
• URL — die vollständige Adresse der Wettbewerber-Produktseite.
• CSS-Selektor (optional) — siehe unten.
• ISO-Währung — standardmäßig EUR.
• KI-Extraktion erzwingen — umgeht die klassischen Methoden für diese URL.
• Intervall — in Stunden, spezifisch für diese URL.

Der Scrape-Button jeder Zeile löst eine sofortige Extraktion aus — praktisch, um eine URL direkt nach dem Anlegen zu validieren.

So funktioniert die Extraktion

Für jede URL probiert das Modul vier Methoden in Kaskade und stoppt bei der ersten erfolgreichen:

1. JSON-LD — Product/Offer strukturierte Daten, auf der großen Mehrheit der E-Commerce-Seiten vorhanden. Preis, Währung und Verfügbarkeit werden direkt gelesen, ohne Konfiguration.
2. OpenGraph — die product price amount Meta-Tags.
3. CSS-Selektor — falls angegeben. Der eingebaute Konverter beherrscht Klassen, IDs, Attributselektoren und Kind-Kombinatoren. Gültige Beispiele: .current-price, .price-box > .amount, span[itemprop=price].
4. KI — ein bereinigter HTML-Ausschnitt wird an Ihren Anbieter gesendet, der Preis, Währung und Bestandsstatus zurückliefert. Internationale Preisformate werden verarbeitet (1 299,90 — 1.234,56 — $49.99).

Cron einrichten

Das periodische Scraping beruht auf einem token-geschützten Endpunkt, der auf dem Dashboard angezeigt wird. Planen Sie den Aufruf alle 30 Minuten:

*/30 * * * * curl -s "https://ihr-shop.de/index.php?fc=module&module=dfaicompetitor&controller=cron&token=IHR_TOKEN" > /dev/null

Bei jedem Lauf: verarbeitet der Cron den Stapel der URLs mit abgelaufenem Intervall, versendet ausstehende Alert-E-Mails, verschickt den Wochenbericht am konfigurierten Tag und bereinigt alte Daten (Snapshots > 180 Tage, Warnungen > 365 Tage). Die Antwort ist eine JSON-Zusammenfassung.

Der Token kann jederzeit vom Dashboard aus neu generiert werden (bestehende Cronjobs müssen dann aktualisiert werden). Ein manueller Auslöser steht über den Button Run cron now zur Verfügung.

Warnungen

Fünf Warnungstypen werden erzeugt, jeder mit einem Schweregrad:

• price_drop / price_rise — Änderung über der Schwelle. Eine Änderung ≥ 10 % wird zu critical hochgestuft.
• undercut — ein Wettbewerber fällt unter Ihren Brutto-Verkaufspreis. Immer critical.
• out_of_stock / back_in_stock — Verfügbarkeitsübergänge, erkannt über strukturierte Daten oder KI.
• scrape_error — erst nach 3 aufeinanderfolgenden Fehlversuchen, um Rauschen durch vorübergehende Ausfälle zu vermeiden.

Warnungen werden zu einer einzigen Digest-E-Mail pro Cron-Lauf gebündelt und sind unter Reports & Alerts mit Bestätigung („Acknowledge all“) einsehbar.

Wochenbericht

Jede Woche, am konfigurierten Tag, fasst eine HTML-E-Mail zusammen: die am stärksten unterbotenen Produkte, die größten Wettbewerbersenkungen und -erhöhungen, den Zustand des Scrapings und eine von der KI verfasste Executive Summary, die die zu ergreifenden Maßnahmen priorisiert. Eine Vorschau des laufenden Berichts ist jederzeit unter Reports & Alerts verfügbar, mit einem Sofortversand-Button.

Preisvorschlag

Wählen Sie unter Reports & Alerts ein überwachtes Produkt: Das Modul zeigt Ihren aktuellen Preis, Min/Durchschnitt/Max der Wettbewerber, die Quellen und den vorgeschlagenen Preis gemäß Ihrer Strategie. Der Button Übernehmen schreibt den Preis ins PrestaShop-Produkt.

Fehlerbehebung

Status „no_price“

Keine der Methoden hat einen Preis gefunden. Prüfen Sie die URL im Browser, fügen Sie einen CSS-Selektor hinzu, der auf das Preiselement zeigt, oder aktivieren Sie „KI-Extraktion erzwingen“ für diese URL.

Status „error“

Die Seite hat nicht geantwortet (HTTP ≥ 400 oder Timeout). Manche Seiten blockieren Robots: Passen Sie den User-Agent in der Konfiguration an, erhöhen Sie den Timeout oder vergrößern Sie das Intervall. Eine Warnung wird erst beim 3. aufeinanderfolgenden Fehlversuch ausgelöst.

Die KI-Extraktion funktioniert nicht

Prüfen Sie, ob der API-Schlüssel gültig ist und das Modell bei Ihrem Anbieter existiert. KI-Aufruffehler werden unter Erweiterte Einstellungen → Logs mit dem Präfix [dfaicompetitor] protokolliert.

E-Mails kommen nicht an

Testen Sie die E-Mail-Konfiguration von PrestaShop (Erweiterte Einstellungen → E-Mail). Das Modul nutzt das native Mailsystem mit eigenen FR/EN-Vorlagen.

Gute Praxis und Compliance

• Halten Sie die Intervalle weit (6 bis 24 h pro URL genügen für Preismonitoring), um Wettbewerberserver nie zu überlasten.
• Behalten Sie einen identifizierbaren User-Agent: Das ist die faire Praxis, die bei Competitive Intelligence erwartet wird.
• Das Auslesen öffentlich angezeigter Preise ist in der EU im Allgemeinen zulässig, aber Sie bleiben für die Nutzung der gesammelten Daten verantwortlich.