dfaimetagen — KI-Massengenerator für Meta-Titles, Descriptions & ALT

Überblick

dfaimetagen generiert Ihre Meta-Titles, Meta-Descriptions und Bild-ALT-Tags massenhaft mit KI (Anthropic Claude, OpenAI GPT oder Mistral) in PrestaShop 8 und 9. Das Modul deckt 6 Entitätstypen ab (Produkte, Kategorien, CMS-Seiten, Hersteller, Lieferanten, Produktbilder), wendet bewährte CTR-Muster an, erzeugt A/B-Varianten, erzwingt SERP-Längengrenzen und weist Duplikate über Jaccard-Ähnlichkeit ab.

Voraussetzungen

• PrestaShop 8.0 bis 9.x
• PHP 8.1, 8.2, 8.3 oder 8.4
• PHP-Extensions: curl, json, iconv
• MySQL 5.7+ oder MariaDB 10.3+
• Ein API-Key bei mindestens einem Anbieter: Anthropic, OpenAI oder Mistral

Installation

1. Laden Sie dfaimetagen.zip aus Ihrem Kundenkonto herunter.
2. Gehen Sie im PrestaShop-Back-Office zu Module > Modul-Manager > Modul hochladen.
3. Laden Sie das ZIP hoch und klicken Sie auf Installieren.
4. Das Modul legt 6 Datenbanktabellen an (Präfix df_aimeta_), installiert 11 Standard-CTR-Muster und generiert einen zufälligen CRON-Token.
5. Ein neuer Tab AI Meta Generator erscheint unter dem Menü Katalog.

KI-Anbieter konfigurieren

1. Gehen Sie zu Katalog > AI Meta Generator > Einstellungen.
2. Wählen Sie Ihren aktiven Anbieter: Anthropic, OpenAI oder Mistral.
3. Fügen Sie Ihren API-Key in das entsprechende Feld ein.
4. Klicken Sie auf die Schaltfläche Test neben dem Feld, um die Konnektivität zu prüfen — Sie sollten die Antwort „OK“ erhalten.
5. Die Standardmodelle sind claude-sonnet-4-5, gpt-4o-mini und mistral-large-latest. Sie können sie ändern, wenn Sie ein anderes Modell desselben Anbieters bevorzugen.

Generierungseinstellungen

Ebenfalls unter Einstellungen können Sie anpassen:

• Längengrenzen — standardmäßig an den Google-SERP-Empfehlungen ausgerichtet: Meta-Title 35–60 Zeichen, Meta-Description 120–158, ALT 25–125. Überschreitet die KI diese, wird der Text sauber an einer Wortgrenze gekürzt.
• A/B-Varianten pro Element — 1 bis 5 Alternativen pro Entität und Sprache.
• Anti-Duplizierungs-Schwellenwert — Jaccard-Ähnlichkeit in Prozent, ab der eine Variante abgelehnt wird (85 % standardmäßig). Der Vergleich ist akzentunempfindlich.
• Stapelgröße — Anzahl der pro AJAX- oder CRON-Tick verarbeiteten Elemente (10 standardmäßig, bis 100).
• HTTP-Timeout — maximale Wartezeit auf eine Anbieter-Antwort (60 s standardmäßig).
• Überschreiben / Nicht-leere überspringen — Standardverhalten bei bereits gefüllten Meta-Tags.

Massengenerierung starten

1. Gehen Sie zu Katalog > AI Meta Generator > Bulk Generation.
2. Entität: Produkte, Kategorien, CMS-Seiten, Hersteller, Lieferanten oder Produktbilder.
3. Feld: Meta-Title, Meta-Description oder Bild-ALT (ALT gilt für Produktbilder).
4. CTR-Muster: Wählen Sie ein bestimmtes Muster oder lassen Sie Auto, um das Standardmuster des Feldes zu verwenden.
5. Sprachen: Mehrfachauswahl — die Generierung multipliziert sich (Elemente × Sprachen).
6. Bereich: alle Entitäten, nach ID-Liste oder nach Kategorie- / Hersteller-Filter.
7. Limit: 10 oder 20 für einen Test, 0 für alles.
8. Klicken Sie auf Job erstellen.

Jobs überwachen und ausführen

Die Seite Jobs listet alle Jobs mit Fortschritt, Statistiken (erfolgreich / fehlgeschlagen / übersprungen) und Status. Drei Ausführungsmodi:

• Bis zum Abschluss ausführen (Job-Detailseite) — verarbeitet Stapel in Schleife via AJAX mit Live-Fortschrittsbalken. Tab geöffnet lassen.
• Einen Stapel ausführen — verarbeitet einen einzelnen Stapel und lädt die Seite neu.
• CRON — Hintergrundverarbeitung, empfohlen für große Kataloge (siehe unten).

Ein Job kann während der Ausführung abgebrochen, von vorn neu gestartet oder gelöscht werden. Das vollständige Protokoll jeder Generierung (Status, Eingabe-/Ausgabe-Tokens, Fehlermeldung) wird im Verlaufs-Tab der Job-Detailseite aufbewahrt.

CRON einrichten

1. Kopieren Sie unter Einstellungen, Abschnitt CRON, die angezeigte URL. Sie hat die Form:
   https://ihr-shop.de/modules/dfaimetagen/cron.php?token=IHR_TOKEN
2. Fügen Sie sie Ihrer Server-Crontab hinzu, zum Beispiel alle 5 Minuten:
   */5 * * * * curl -s "https://ihr-shop.de/modules/dfaimetagen/cron.php?token=IHR_TOKEN" >/dev/null
3. Jeder Durchlauf verarbeitet bis zu 5 Stapel des ältesten anstehenden Jobs. Optionale Parameter: &batch=20 (Stapelgröße) und &loops=10 (Stapel pro Durchlauf).

A/B-Varianten und Aktivierung

Jede Generierung erzeugt die konfigurierte Anzahl Varianten (1 bis 5). Die erste gültige Variante wird auf die Entität geschrieben und als Aktiv markiert. Die anderen bleiben auf der Job-Detailseite in Reserve:

• Klicken Sie auf Aktivieren neben einer Variante, um sie sofort auf die Entität zu schreiben.
• Andere Varianten desselben Tripels (Entität, Feld, Sprache) werden automatisch deaktiviert.
• Der Zeichenzähler jeder Variante ermöglicht die SERP-Konformitätsprüfung auf einen Blick.

CTR-Muster

Die 11 vorinstallierten Muster decken drei Familien ab:

• Meta-Titles: Nutzen + Jahr, nummerierte Liste, USP in Klammern, Hook-Frage, Power-Words.
• Meta-Descriptions: Nutzen-Stapel, Social Proof, Problem-Lösung, direkter CTA.
• Bild-ALT: beschreibend, kontextuell.

Um eigene Muster zu erstellen, gehen Sie zu Katalog > AI Meta Generator > Patterns. Die Vorlage akzeptiert dynamische Tokens:

• {NAME}, {BRAND}, {CATEGORY}, {PRICE}, {YEAR}, {NUMBER}, {LANG_NAME} — automatisch vom Modul gefüllt;
• {BENEFIT}, {USP}, {CONTEXT} — zur Generierungszeit von der KI gefüllt.

Als „System“ markierte Muster werden mit dem Modul geliefert und bleiben bei Updates erhalten.

Erweiterte Prompt-Vorlagen

Für volle Kontrolle über das KI-Verhalten erstellen Sie Vorlagen unter Katalog > AI Meta Generator > Prompt Templates. Jede Vorlage zielt auf ein Tripel (Entität, Feld, Sprache — oder alle Sprachen) und definiert:

• den System-Prompt — Rolle, Ton, globale Einschränkungen;
• den User-Prompt — mit den Tokens {NAME}, {BRAND}, {CATEGORY}, {DESCRIPTION}, {PRICE}, {PATTERN}, {LANG_NAME}, {MIN_LENGTH}, {MAX_LENGTH}, {AB_VARIANTS}, {EXISTING}.

Markieren Sie eine Vorlage als „Standard“, damit sie automatisch auf ihr Tripel angewendet wird.

Anti-Duplizierung

Bevor eine Variante gespeichert wird, vergleicht das Modul sie mit bereits gespeicherten Varianten:

1. Exakter Hash (sha1 der normalisierten Version) — sofortige Ablehnung bei perfektem Duplikat.
2. Jaccard-Ähnlichkeit auf normalisierten Wortmengen (Kleinbuchstaben, ohne Akzente) — Ablehnung, wenn die Ähnlichkeit den konfigurierten Schwellenwert übersteigt.

Eine abgelehnte Variante wird von der KI automatisch neu generiert (innerhalb des Wiederholungslimits des Stapels).

Dashboard

Die Seite Dashboard aggregiert: Job-Zahlen (gesamt, anstehend, abgeschlossen), generierte und aktive Varianten, erfolgreiche / fehlgeschlagene Generierungen, verbrauchte Tokens (Eingabe + Ausgabe), letzte Jobs und letzte Generierungen. Nutzen Sie es, um Ihr KI-Budget zu überwachen und Anbieter-Fehler zu erkennen.

Multi-Shop

Das Modul liest und schreibt Werte Shop-bewusst, wenn die betreffende *_lang-Tabelle eine id_shop-Spalte besitzt. Wählen Sie den Ziel-Shop im Massengenerierungs-Formular, wenn Ihre Installation Multi-Shop ist.

Fehlerbehebung

• „FAIL“ beim Konnektivitätstest — prüfen Sie den API-Key, das Guthaben beim Anbieter und ob Ihr Server ausgehende HTTPS-Verbindungen (cURL) zu api.anthropic.com, api.openai.com oder api.mistral.ai erlaubt.
• Job hängt in „running“ — führen Sie manuell einen Stapel von der Detailseite aus, oder warten Sie auf den nächsten CRON-Durchlauf. Ein Job kann immer abgebrochen und neu gestartet werden.
• Leere oder abgeschnittene Varianten — erhöhen Sie das HTTP-Timeout in den Einstellungen oder wählen Sie ein schnelleres Modell.
• 403 auf der CRON-URL — der Token der URL stimmt nicht mehr (er wurde eventuell regeneriert). Kopieren Sie die URL erneut aus den Einstellungen.
• Für manche Entitäten wird nichts generiert — wenn „Nicht-leere überspringen“ aktiv ist, werden Entitäten mit vorhandenem Wert absichtlich übersprungen. Aktivieren Sie „Überschreiben“, um dies zu erzwingen.

Deinstallation

Die Deinstallation entfernt die 6 Tabellen des Moduls und seine Konfigurationsschlüssel. Bereits generierte und auf Ihre Produkte, Kategorien und Bilder geschriebene Meta-Tags bleiben erhalten: Sie sind Teil Ihres Katalogs.