# KI-Übersetzung & SEO — Vollständige Anleitung

> Dieses Modul übersetzt und verbessert den Inhalt und die SEO-Daten Ihrer Produkte, Kategorien, CMS-Seiten und Marken mit der KI Ihrer Wahl — ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google) oder Mistral…

- Seite: <https://www.datafirefly.com/de/documentation/ai-translation-seo-prestashop/>
- Sprache: de
- Aktualisiert am: 2026-06-17
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/ai-translation-seo-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/ai-translation-seo-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/ai-translation-seo-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/ai-translation-seo-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/ai-translation-seo-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/ai-translation-seo-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/ai-translation-seo-prestashop/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

Dieses Modul übersetzt und verbessert den Inhalt und die SEO-Daten Ihrer **Produkte, Kategorien, CMS-Seiten und Marken** mit der KI Ihrer Wahl — ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google) oder Mistral — in allen in Ihrem PrestaShop-8- oder -9-Shop installierten Sprachen. Konzipiert für den Shop-Betreiber: anhaken, Sprachen wählen, starten.

**Kurz gesagt:** API-Schlüssel hinterlegen, Datenblätter auswählen, Quell- und Zielsprachen wählen, auf _Starten_ klicken. Ein Fortschrittsbalken verarbeitet jedes Datenblatt × Sprache ohne Server-Timeout. Vorher/Nachher-Vorschau, SEO-Score und 1-Klick-Rollback inklusive.

## Installation

1. Gehen Sie im Back Office zu **Module > Modul-Manager**, klicken Sie auf **Modul hochladen** und senden Sie die Datei `dfaicontent-1.1.0.zip`.
2. Nach der Installation erscheint ein Tab **KI-Inhalte & SEO** unter **Katalog**.
3. Öffnen Sie den Tab **Einstellungen**, um vor der ersten Nutzung mindestens einen KI-Anbieter zu konfigurieren.

## Einen KI-Anbieter konfigurieren

Das Modul unterstützt vier Anbieter. Sie verwenden **Ihren eigenen API-Schlüssel** und zahlen die KI nach Verbrauch direkt beim Anbieter — das Modul berechnet kein zusätzliches Abo.

- **Aktiver Anbieter**: der für die Generierungen verwendete Anbieter.
- **API-Schlüssel** und **Modell** pro Anbieter: z. B. `gpt-4o-mini` (OpenAI), `claude-sonnet-4` (Anthropic), `gemini-2.0-flash` (Google), `mistral-small-latest` (Mistral).
- Klicken Sie auf **Test** neben jedem Anbieter, um die Verbindung zu prüfen.

Um das Budget unter Kontrolle zu halten, beginnen Sie mit einem günstigen Modell (Mistral Small, GPT-4o mini). Die vollständige Übersetzung eines Produktdatenblatts kostet typischerweise einen Bruchteil eines Cents.

## Eine Übersetzung starten (3 Schritte)

1. **Haken Sie** die Produkte oder Kategorien in der Liste an (die Suche nach Name oder ID hilft beim Filtern).
2. Stellen Sie in der Aktionsleiste die **Quellsprache**, die **Zielsprachen**, die zu verarbeitenden **Felder**, den **Modus** und die **Geschwindigkeit** (1 bis 3 parallele Anfragen) ein.
3. Klicken Sie auf **Starten**. Eine Token- und Kostenschätzung wird zur Bestätigung angezeigt, dann läuft die Warteschlange mit Fortschrittsbalken und Protokoll.

### Die drei Modi

- **Übersetzen**: getreue Übersetzung von der Quellsprache in jede Zielsprache.
- **Übersetzen + verbessern** (Standard): Übersetzung und anschließend Copywriting- und SEO-Neufassung.
- **Verbessern (gleiche Sprache)**: schreibt jede Zielsprache an Ort und Stelle neu; die Quellsprache wird ignoriert.

### Verwaltete Felder

- **Produkte**: Name, Kurzbeschreibung, Beschreibung, Meta-Titel, Meta-Beschreibung, sprechende URL, Tags (Schlüsselwörter) und Alt-Texte der Bilder.
- **Kategorien**: Name, Beschreibung, zusätzliche Beschreibung, Metas, sprechende URL.
- **CMS-Seiten**: Inhalt, Meta-Titel, Meta-Beschreibung, sprechende URL.
- **Marken**: Kurz- und Langbeschreibung, Meta-Titel, Meta-Beschreibung.

PrestaShop 8 hat das Feld _Meta-Keywords_ entfernt: Das Modul erzeugt stattdessen **Produkt-Tags**. In einem migrierten Shop, in dem die Spalte noch existiert, wird sie automatisch erkannt und angeboten.

## Vorher / Nachher-Vorschau

Der **Vorschau**-Button in einer Zeile generiert den Inhalt **ohne etwas zu speichern** und zeigt einen Vorher/Nachher-Vergleich. Gefällt das Ergebnis, speichert _Diesen Inhalt übernehmen_ genau das Vorschau-Ergebnis — ohne zweiten KI-Aufruf, also ohne Zusatzkosten. Testen Sie immer ein Datenblatt in der Vorschau vor einem großen Lauf.

## SEO-Score

Der **SEO**-Button in jeder Zeile berechnet einen Score von 0 bis 100 pro Sprache, mit detaillierter Checkliste: Längen von Meta-Titel und Meta-Beschreibung, Keyword am Titelanfang, Inhaltstiefe, Zwischenüberschriften, Slug-Gültigkeit, Anzahl der Tags und Abdeckung der Alt-Texte.

## Creative-Elements-Kompatibilität

Mit Creative Elements (oder Elementor) erstellte Beschreibungen werden durch zwei Mechanismen geschützt:

- **Tokenisierung**: Skripte, Styles, iframes, SVGs, Shortcodes `[...]` und Platzhalter `{...}` werden vor dem Senden an die KI durch Tokens ersetzt und danach identisch wieder eingefügt.
- **Strikte Systemanweisung**: Die KI übersetzt nur den sichtbaren Text und erhält alle Tags, Klassen, IDs, Inline-Styles und `data-*`-Attribute.

Wenn Sie ein Creative-Elements-Widget verwenden, das ein nicht abgedecktes Muster erzeugt, fügen Sie ein Muster in der Methode `protect()` der Klasse `DfAiContentProcessor` hinzu.

## Verlauf & Rollback

Jeder Lauf wird mit den vorherigen Werten aller Felder protokolliert. Der Tab **Verlauf** stellt einen kompletten Vorgang mit einem Klick wieder her — Tags und Alt-Texte inklusive. Der Verlaufseintrag wird dann entfernt.

## Kostenschätzung

Vor jedem Start misst das Modul das reale Volumen der ausgewählten Inhalte in der Datenbank und zeigt die Anzahl der Aufrufe, die geschätzten Eingabe- und Ausgabe-Tokens sowie die entsprechenden Kosten gemäß den in den Einstellungen konfigurierten Preisen pro Million Tokens an.

## Auto-Übersetzungs-Cron

Das Modul kann neue Inhalte automatisch übersetzen:

1. Aktivieren Sie unter **Einstellungen > Cron** den Cron und stellen Sie Quellsprache, Zielsprachen, Felder, Typen und das Limit pro Lauf ein.
2. Kopieren Sie die **token-gesicherte URL** und rufen Sie sie alle 5 bis 15 Minuten über den Planer Ihres Hostings auf.

Bei jedem Lauf erkennt das Modul Datenblätter, deren Quelle Inhalt hat, deren Ziele aber weder Meta-Titel noch Beschreibung haben, und übersetzt einen kleinen Stapel. Eine Skip-Liste verhindert endlose Wiederholungen bei einem fehlerhaften Datenblatt; das Protokoll des letzten Laufs wird in den Einstellungen angezeigt.

Wenn Sie den Token neu generieren, funktioniert die alte Cron-URL sofort nicht mehr: Denken Sie daran, Ihren Planer zu aktualisieren.

## Redaktionelle Einstellungen

- **Geschützte Begriffe**: Marken- und Produktnamen, die nie übersetzt werden (einer pro Zeile).
- **Glossar**: erzwungene Übersetzungen, eine Regel pro Zeile als `Quellbegriff => Übersetzung`.
- **Schreibstil**, **maximale SEO-Längen** und **eigene Anweisungen** speziell für Ihren Shop.

## Fehlerbehebung

- **„Source content is empty"**: Das Datenblatt hat keinen Inhalt in der gewählten Quellsprache — wählen Sie eine andere Quellsprache.
- **API-Schlüssel-Fehler**: Prüfen Sie Schlüssel und Modell in den Einstellungen, dann nutzen Sie den Test-Button.
- **Eine mit der Quelle identische Zielsprache** wird im Modus Übersetzen automatisch übersprungen.

## Technische Hinweise

- Kompatibel mit PrestaShop 8.0 bis 9.x, ohne Core-Override (Admin-Controller + native Mechanismen).
- Wirkt im Multistore auf den Shop des aktuellen Kontexts.
- Keine Composer-Abhängigkeit; Inhalte werden nur über Ihren Schlüssel an die API des gewählten Anbieters gesendet.
