Kein neues Feature verpassen
Plugin-News, Updates und Shopware-Tipps aus der Praxis. Einmal im Monat.
Installationsanleitung
Erweiterung über den Erweiterungsbereich installieren.
OpenAI API Schlüssel
- Gehe zu https://platform.openai.com/.
- Melde dich an.
- Erstelle ein neues Projekt.
- Gehe zu deinem Profil und gehe zum “API keys” Bereich https://platform.openai.com/settings/organization/api-keys.
- Erstelle einen neuen API Schlüssel über “Create new secret key”.
- Lade Guthaben auf, damit die OpenAI API funktioniert. https://platform.openai.com/settings/organization/billing/overview
- Optional: Wir empfehlen, dass ein Limit für die Nutzung gesetzt wird, damit bei einem Fehler keine unnötigen Kosten entstehen https://platform.openai.com/settings/organization/limits
Gemini-API-Key (Google AI Studio)
- https://aistudio.google.com/ aufrufen und mit dem Google-Account anmelden
- Links im Menü auf Get API key klicken
- Create API key wählen und ggf. ein neues Google-Cloud-Projekt anlegen lassen
- Den erzeugten Schlüssel kopieren
- Im Shopware-Backend in den App Einstellungen den Schlüssel einfügen und speichern
- Optional: Wir empfehlen, dass eine Ratenbegrenzung für die Nutzung gesetzt wird, damit bei einem Fehler keine unnötigen Kosten entstehen https://aistudio.google.com/rate-limit
Claude-API-Key (Anthropic Console)
- https://console.anthropic.com/ aufrufen und einloggen / registrieren
- Links im Menü auf API Keys klicken
- Create Key wählen, einen Namen vergeben (z.B. “Shopware – <Shopname>”) und bestätigen
- Den angezeigten Schlüssel sofort kopieren (er wird nur einmal angezeigt)
- Im Shopware-Backend in den App Einstellungen den Schlüssel einfügen und speichern
- Optional: Wir empfehlen, dass ein Limit für die Nutzung gesetzt wird, damit bei einem Fehler keine unnötigen Kosten entstehen https://platform.claude.com/settings/limits
Mistral API Schlüssel
Gehe zu https://console.mistral.ai/
Account erstellen oder einloggen
API Key erstellen und in Shopware-Erweiterung eintragen
Guthaben aufladen
Hinweis: Europäischer Anbieter (DSGVO-konform)
Einrichten der Erweiterung in Shopware
API-Berechtigungsnachweise
- Trage den API Schlüssen ein, dieser sollte mit “sk-proj” anfangen.
- Wähle dein gewünschten KI-Modell aus.
Einstellungen “Alle META-Tags Produkt / Kategorie (konfiguriert)”
Einstellungen für die Erstellung der SEO Daten in der Massenbearbeitung. Diese Einstellung sind nur für die Massenbearbeitung oder für den Button “Alle META-Tags (konfiguriert)” im Einzelmodus.
Erzeugen von META-Informationen für Bilder
- Automatische Generierung ausgewählter META-Informationen beim Erstellen oder Aktualisieren von Bildern: diese Einstellung ermöglicht es, dass die META-Informationen für Bilder direkt beim hochladen oder beim aktualisieren eingefügt werden. Dies funktioniert automatisch, bitte prüfe Ihre OpenAI Limits.
- Diese Option funktioniert NICHT mit dem Produktkontext. Damit Meta Daten mit dem Produktkontext generiert werden können, muss der Artikel vorher mit dem gewünschten Bild gespeichert werden. Das ist für die Zuordnung nötig.
- Auswahl der zu generierenden Sprachen (Standardsprache wird immer generiert): eine Liste der Sprachen, in welchen die META- Informationen erstellt werden.
- Checkboxen, welche Information in der Massenbearbeitung und beim automatisierten erstellen bearbeitet werden.
- Wenn du einen Htaccess für deinen Shop aktiv hast, musst du diese Anmeldedaten hier eintragen, damit die Bild META-Informationen erstellt werden können. Dies ist nötig, da die Bilder von OpenAI analysiert werden und ein Zugriff benötigt wird.
Allgemeine Einstellungen
- Schlüsselwörter: Globale Schlüsselwörter, welche von der KI bei der META Generierung berücksichtigt werden sollen.
- Höfliche Form: Welche Form beim erstellen der Texte genutzt wird.
- Die Temperatur gibt an, wie zufällig die Antworten der KI sind. Weitere Informationen hier: https://platform.openai.com/docs/api-reference/assistants/modifyAssistant#assistants-modifyassistant-temperature
- Top P ist ähnlich wie Temperatur eine alternative Sampling Methode. Weitere Informationen hier: https://platform.openai.com/docs/api-reference/assistants/modifyAssistant#assistants-modifyassistant-top_p
KI Verarbeitung Einzelentität
Produkte SEO Daten
- Gehe zu Kataloge -> Produkte und wähle dein gewünschtes Produkt aus.
- im SEO Bereich können Meta-Titel, Meta-Beschreibung und Keywords erstellt werden.
- Nutze Hierfür den entsprechenden Button um deine gewünschten SEO Daten zu erstellen oder alle drei.
Produkte Bilder Meta Daten
- Gehe zu Kataloge->Produkte und wähle dein gewünschtes Produkt aus.
- Gehe zum Bilder Bereich.
- Hier können für bereits gespeicherte Bilder Meta Daten generiert werden.
- Bitte beachte, dass Meta Daten nur generiert werden, wenn der Artikel mit den gewünschten Bildern gespeichert wurde.
Kategorie SEO Daten
- Gehe zu Kataloge -> Kategorien und wähle deine gewünschte Kategorie aus.
- im SEO Bereich können Meta-Titel, Meta-Beschreibung und Keywords erstellt werden.
- Nutze Hierfür den entsprechenden Button um deine gewünschten SEO Daten zu erstellen oder alle drei.
Textbearbeitung Bulk
- Gehe zu Kataloge -> SEO AI – Massenupdate.
- in “Bereich” kann der gewünschte Bereich ausgewählt werden, der bearbeitet werden soll.
- Produkt-META-Informationen
- Bild-Alt und Titel-Text
- Einzelne Einstellungen für die verschiedenen Bereiche sind vorhanden
- Filter gibt an, ob bei der Auswahl der zu bearbeitenden Bereiche was beachtet werden soll, wie nur Entitäten bearbeiten, welche noch nicht von der KI bearbeitet wurden
- Sprachen gibt an, welche Sprache bearbeitet werden soll.
- Kategorien bietet eine Kategorie Auswahl an. Dies dient zur Eingrenzung der zu bearbeitenden Entitäten. Wähle alle Kategorien mit Shift+Klick aus um alle Entitäten zu bearbeiten.
- Weiter folgend die gefundenen Entitäten, welche bearbeitet werden.
- in dem “Aktuell laufende Bulk-Jobs” Bereich, wird angezeigt, ob gerade ein Job am laufen ist
Neu über den Listen für Kategorien und Hersteller: ein Suchfeld, mit dem du den passenden Eintrag schneller findest.
Automatik
Mit der Automatik erzeugt SEO AI Texte für neu angelegte Produkte und Kategorien im Hintergrund und setzt sie direkt ein. So musst du bei jedem neuen Datensatz nicht mehr von Hand nachhelfen. Deinen bestehenden Bestand bearbeitest du weiterhin über die Massenbearbeitung.
Du findest die Automatik als eigenen Eintrag „SEO AI Automatik” im Shopware-Admin. Von der Prompts-Seite und aus der Massenbearbeitung führt jeweils ein Link direkt dorthin.
Die Text-Automatik gehört zu Prompts Plus (In-App-Kauf). Die Bildtexte beim Hochladen (Titel und Alt-Text) erzeugt die Erweiterung dagegen auch ohne Prompts Plus.
Bereiche
Für welche Inhalte die Automatik Texte erzeugt, hängt von der Erweiterung ab. In SEO AI stehen folgende Bereiche zur Verfügung:
- Produkte – Meta-Daten
- Kategorien – Meta-Daten
- Bilder – Texte beim Hochladen
Jeden Bereich aktivierst und konfigurierst du einzeln.
Einstellungen je Bereich
Für jeden Bereich legst du fest, wie die Automatik arbeiten soll:
- Sprachen: Je Sprache richtest du eine eigene Automatik ein. Mehrere Sprachen wählst du gemeinsam aus.
- Prüfen alle: Wie oft die Automatik nach neuen Einträgen sucht (1, 3, 6 oder 24 Stunden, Standard 3 Stunden).
- Wartezeit nach dem Anlegen (in Minuten): Sinnvoll bei Importen, die einen Datensatz zuerst leer anlegen und erst danach befüllen. Die Automatik wartet die eingestellte Zeit ab, bevor sie einen neuen Eintrag bearbeitet.
- Nur leere Felder befüllen: Vorhandene Inhalte bleiben unangetastet, die Automatik ergänzt nur, was noch fehlt.
- Filter nach Kategorien und Herstellern (optional): Grenzt ein, für welche Datensätze die Automatik läuft. Die Filter gelten zum Zeitpunkt der Prüfung nach der Wartezeit, eine später zugeordnete Kategorie wird nicht nachgeholt.
Status und automatisches Pausieren
Für jeden Bereich siehst du auf einen Blick, ob die Automatik aktiv oder inaktiv ist oder gerade ein Lauf läuft. Dazu zeigt die Übersicht den letzten Lauf und die nächste Prüfung an.
Ist dein Shop einmal nicht erreichbar oder lehnt der KI-Anbieter ab (zum Beispiel bei fehlendem Guthaben oder einem ungültigen API-Schlüssel), pausiert die Automatik von selbst. Sobald es wieder passt, nimmt sie den Betrieb automatisch wieder auf.
Bildtexte beim Hochladen (ohne Prompts Plus)
Die Bildtexte beim Hochladen (Titel und Alt-Text) erzeugt SEO AI weiterhin ohne Prompts Plus. Die zugehörigen Einstellungen sind von der App-Konfiguration auf die Automatik-Seite umgezogen. Die alten Felder in der App-Konfiguration haben damit keine Wirkung mehr, maßgeblich sind jetzt die Einstellungen auf der Automatik-Seite.
Hinweis beim Aktivieren
Beim Aktivieren blendet die Erweiterung einen Hinweis ein: Für jeden erzeugten Text fallen Tokens und damit Kosten beim KI-Anbieter an. Die Texte werden ohne inhaltliche Kontrolle eingesetzt, die Nutzung erfolgt auf eigenes Risiko. Prüfe die erzeugten Inhalte deshalb regelmäßig.
Prompting
Überblick
Das Prompting Modul ermöglicht es, die KI-Textgenerierung anzupassen und zu verändern. Es ist möglich die vorgegebenen Prompt zu erweitern oder zu ersetzen. Es ist ein Grundsätzliches Verständnis für Prompting vorausgesetzt, daher ist dieses Modul nur für “Experten” empfohlen.
Zugriff auf das Prompting-Modul
Das Prompting-Modul ist über zwei Wege erreichbar:
- Über die Einstellungen: Navigiere zu Einstellungen → Plugins → SEO AI Prompts.
- Über das Massenupdate: Im Massenupdate-Modul findest du einen Link “Prompts konfigurieren” direkt in der Konfigurationsansicht.
Verfügbare Bereiche
In dieser App stehen Ihnen folgende Bereiche zur Verfügung:
- Produkt Meta-Titel: SEO-optimierte Produkttitel
- Produkt Meta-Beschreibung: SEO-Beschreibungen für Produkte
- Produkt Meta-Keywords: Relevante Keywords für Produkte
- Kategorie Meta-Daten: SEO-Daten für Kategorien
- Medien Meta-Daten: Alt-Texte und Titel für Bilder, Produktkontext kann hier eingestellt werden. Bitte Hinweis Beachten.
Konfigurationsmöglichkeiten pro Bereich
1. Zusätzlicher Prompt (Optional)
- Hier können spezielle Anweisungen ergänzt werden, die zusätzlich zum Standard-System-Prompt an die KI gesendet werden.
2. Verfügbare Variablen
- Für jeden Bereich werden die verfügbaren Variablen angezeigt.
- Variablen können direkt angeklickt werden, um sie in den zusätzlichen Prompt einzufügen.
- Die Variablen werden automatisch an der Cursor-Position im Text eingefügt.
- Verfügbare Variablen je nach Bereich:
##targetLanguage##– Zielsprache##productName##– Produktname##productText##– Produktbeschreibung##productNumber##– Artikelnummer/MPN##productManufacturerName##– Herstellername##productManufacturerDescription##– Herstellerbeschreibung##categoryName##– Kategoriename##categoryText##– Kategoriebeschreibung##productCustomField_<name>##– Wert eines eigenen Produkt-Custom-Fields,<name>durch den technischen Feldnamen ersetzen (Prompts Plus)##lengthFrom##/##lengthTo##– Textlängen-Vorgaben##keywords_amount##– Anzahl der Keywords
3. KI-Modell Auswahl
- Es kann das OpenAI-Modell für die Textgenerierung ausgewählt werden.
- Verschiedene Modelle haben unterschiedliche Stärken und Kosten:
- GPT-5.5: Neuestes Modell, höchste Qualität
- GPT-5 Mini: Schnell und kostengünstig, ideal für große Mengen
- GPT-5: Ausgewogene Leistung und Qualität
- GPT-5 Nano: Kompaktes Modell für einfache Aufgaben
- GPT-4.1 Serie: Ältere Modelle, weiterhin verfügbar
4. System-Prompt Einstellungen
- Der Standard-System-Prompt enthält die grundlegenden Anweisungen für die KI.
- Option “Standard-System-Prompt deaktivieren”: kann verwendet werden, wenn die komplette Kontrolle übernehmen werden soll. Bitte nur aktivieren, wenn du mit Prompting vertraut bist.
- Der aktuelle System-Prompt wird zur Transparenz angezeigt.
Wichtige Hinweise für Prompting
Achtung bei Prompt-Anpassungen:
- Prompts sollten nur angepasst werden, wenn du sich mit Prompting auskennst.
- Alle Anpassungen erfolgen auf eigenes Risiko.
- Teste Änderungen zuerst im Einzelmodus oder bei der Massenbearbeitung mit wenigen Elementen.
- Der tatsächlich abgesendete Prompt kann im Logging-Modul in der Detailansicht kontrolliert werden.
Best Practices für eigene Prompts
- Sei spezifisch: Je genauer Ihre Anweisungen, desto besser das Ergebnis.
- Nutze Variablen: Verwende die verfügbaren Variablen für dynamische Inhalte.
- Teste schrittweise: Beginne mit kleinen Änderungen und teste die Ergebnisse.
- Beispiele sind hilfreich: Gebe der KI Beispiele für den gewünschten Stil.
- Längenangaben beachten: Nutze die Längenvariablen für präzise Textlängen.
Beispiele für zusätzliche Prompts
Für Produktbeschreibungen:
Schreibe in einem enthusiastischen Ton und verwende Aufzählungspunkte für die wichtigsten Features.
Beginne mit einem packenden Einleitungssatz, der das Hauptproblem anspricht, das ##productName## löst.Für Meta-Titel:
Integriere immer den Herstellernamen ##productManufacturerName## am Anfang des Titels.
Verwende action-orientierte Wörter wie "Kaufen", "Bestellen" oder "Entdecken".Für Kategoriebeschreibungen:
Strukturiere die Beschreibung in 3 Absätze:
1. Einleitung zur Kategorie
2. Hauptvorteile der Produkte in dieser Kategorie
3. Call-to-Action zum StöbernLogging und Kontrolle
Nach der Textgenerierung kann im Logging-Modul überprüfen werden:
- Welcher Prompt tatsächlich an die KI gesendet wurde.
- Wie die Variablen ersetzt wurden.
- Welches Ergebnis generiert wurde.
Dies hilft Ihnen, Ihre Prompts kontinuierlich zu optimieren.
Tipps zur Fehlerbehebung
- Zu kurze/lange Texte: Passe die Längenangaben in der Plugin-Konfiguration an.
- Falscher Ton: Ergänze spezifische Ton-Anweisungen im zusätzlichen Prompt.
- Fehlende Informationen: Stelle sicher, dass alle benötigten Produktdaten gepflegt sind.
- Inkonsistente Ergebnisse: Verwende spezifischere Anweisungen oder wechsel das Modell.
SEO AI – Log
Der SEO AI Log notiert jeden Job, der für die entsprechenden Bereiche gelaufen ist. Wenn ein Job nicht durchläuft ist der Log die erste Anlaufstelle.
Gehe zu Kataloge -> SEO AI – Log
Entity Log
Hier werden die einzelnen Entitäten eingetragen, welche von der KI bearbeitet werden und nach Bereichen sortiert.
Bulk Log
Hier werden die Bulk Log – Jobs eingetragen.
Häufige Fehler – Einträge im Log:
- error_no_credits: gibt an, dass kein Guthaben im OpenAI Account hinterlegt ist.
MCP-Server Verwaltung
Was sind MCP-Server?
MCP-Server (Model Context Protocol) sind externe Dienste, die der KI zusätzliche Fähigkeiten verleihen. Während der Textgenerierung kann die KI diese Server kontaktieren, um Echtzeitdaten abzurufen – zum Beispiel aktuelle SEO-Keywords, Suchvolumen oder Wettbewerbsanalysen.
Server hinzufügen
Um einen neuen MCP-Server hinzuzufügen:
- Klicke auf “Server hinzufügen”
- Gib einen Namen für den Server ein (z.B. “SEO Keywords”)
- Wähle den Server-Typ aus der Liste
- Trage die erforderlichen Zugangsdaten ein (API-Key, URL, etc.)
- Speichere die Konfiguration
Server testen
Nach dem Speichern kannst du die Verbindung testen:
- Klicke auf das Test-Symbol neben dem Server
- Der Server wird kontaktiert und die verfügbaren Tools werden abgerufen
- Bei erfolgreicher Verbindung siehst du eine Bestätigung
Server mit Prompts verknüpfen
Damit ein MCP-Server bei der Textgenerierung verwendet wird:
- Gehe zu den Prompt-Einstellungen
- Wähle den gewünschten Prompt-Typ (z.B. “Produkt Beschreibung”)
- Im Abschnitt “MCP-Server” wähle die Server aus, die verwendet werden sollen
- Speichere die Einstellungen
Die KI nutzt dann automatisch die verknüpften Server während der Generierung.
Fehlerbehebung
Server-Verbindung fehlgeschlagen:
- Überprüfe die Zugangsdaten (API-Key, URL)
- Stelle sicher, dass der Server erreichbar ist
- Prüfe, ob dein API-Kontingent noch nicht erschöpft ist
Keine Tools verfügbar:
- Der MCP-Server antwortet möglicherweise nicht korrekt
- Kontaktiere den Anbieter des MCP-Servers
Generierung dauert länger:
- MCP-Server-Anfragen können die Generierungszeit verlängern
- Dies ist normal, da zusätzliche Daten abgerufen werden
In-App Käufe
Was ist Prompts Plus?
Prompts Plus ist ein optionales Upgrade, das erweiterte Funktionen für deine KI-Textgenerierung freischaltet. Das wichtigste Feature ist die MCP-Server-Integration, mit der du externe Datenquellen einbinden kannst.
Enthaltene Funktionen
- MCP-Server-Integration: Verbinde externe Tools und Datenquellen
- Erweiterte Prompt-Optionen: Verknüpfe Server mit spezifischen Prompts
- Echtzeit-Datenabfragen: Die KI greift während der Generierung auf aktuelle Daten zu
Kauf und Aktivierung
- Der Kauf erfolgt direkt über den Shopware Store
- Nach dem Kauf wird das Feature automatisch aktiviert
- Du siehst den Status in der “In-App Käufe” Übersicht im Log-Bereich
Abonnement-Informationen
- Prompts Plus ist ein monatliches Abonnement
- Die verbleibende Laufzeit siehst du in der “In-App Käufe” Übersicht
- Das Abonnement verlängert sich automatisch über den Shopware Store
Systemvoraussetzungen
- Shopware Version 6.6.9.0 oder höher
- Aktive Internetverbindung für MCP-Server-Kommunikation
FAQs
KI Shop-Assistent: Allgemeine Fragen
Open AI: Allgemeine Fragen
Der OpenAI Account kann über diesen Link erreicht werden: https://platform.openai.com/ .
Hier finden sich die Verwaltung der Credit, Limitierung und die API Schlüssel, welche für die Erweiterung nötig sind!
- Zuerst muss ein neues Projekt erstellt werden.
- Hier kann ein neuer API Schlüssel erstellt und einem Projekt zugewiesen werden.
Dieser Schlüssel kann in der Konfiguration der Erweiterung eingetragen werden.
Credits sind erforderlich, damit die OpenAI API richtig funktioniert. Wie bei anderen Diensten ist dies eine “Prepaid”-Methode. Sie laden die Credits auf und diese werden automatisch “ausgegeben”, sobald die Erweiterung genutzt und eine Anfrage gesendet wird.
Um Credits bei OpenAI aufzuladen, muss über das eigene Profil eine Zahlungsmethode eingerichtet werden.
Die Zahlungsmethoden befinden sich unter: Organization -> Billing. Hier kann über “add payment details” eine neue Zahlungsmethode hinzugefügt werden. Wird dies gemacht, werden auch Credits aufgeladen.
Credits werden in Dollar abgerechnet. OpenAI verbraucht “Tokens” ein Token entspricht ca. 4 Zeichen.
Übersichtstabelle von OpenAI https://openai.com/api/pricing/:
Wenn z.B. nur ein bestimmtes Budget an Credits pro Monat zur Verfügung steht oder zum Schutz können Limits gesetzt werden.
Über das Profil: Organisation -> Limits können monatliche Limits eingestellt werden, sowie eine E-Mail-Benachrichtigung, sobald ein bestimmter Betrag erreicht ist.
OpenAI stellt die Nutzung in verschiedenen “Tiers” zur Verfügung. Zu Beginn befindet sich jeder Nutzer im “Free”-Tier, welches die Nutzung der KI-Modelle sehr stark auf wenige Anfragen pro Minute beschränkt. Sobald $5 bezahlt wurden, werden diese Einschränkungen stark reduziert und die Erweiterung kann effizienter genutzt werden.
Weitere Informationen zu den Limitierungen direkt bei OpenAI: https://platform.openai.com/docs/guides/rate-limits/usage-tiers?context=tier-free
Welches Aktuelle “Tier” erreicht ist, ist im Account hier einzusehen: https://platform.openai.com/settings/organization/limits
Wenn Interesse besteht, dass jemand anderes Einstellungen und Limits prüfen kann, können “members” zur Organisation eingeladen werden.
Zu finden ist der Bereich hier: https://platform.openai.com/settings/organization/members
Hier kann über “invite” eine neue Person hinzugefügt werden. Es stehen zwei Rollenoptionen zur Auswahl, hier kann festgelegt werden, ob das neue Mitglied nur bestimmte Daten einsehen oder an der Organisation mitarbeiten kann. Da die erste Option recht eingeschränkt ist und bestimmte Aufgaben nicht abgegeben werden können, empfiehlt es sich, die Option “Owner” zu vergeben.
Wir empfehlen immer das aktuellste Modell zu nutzen.
Aus Kostengründen, kann auch das Vorgängermodell genutzt werden.
Nein, das Plugin funktioniert vollständig ohne Prompts Plus. Die MCP-Server-Integration ist ein optionales Upgrade für erweiterte Anwendungsfälle.
Das Plugin unterstützt alle MCP-Server, die dem Model Context Protocol Standard entsprechen. Gängige Beispiele sind SEO-Tools, Keyword-Recherche-Dienste und Analyse-Plattformen.
Die Generierung kann etwas länger dauern, da zusätzliche Daten von externen Servern abgerufen werden. Die verbesserte Textqualität durch die Echtzeitdaten kompensiert dies in der Regel.
Ja, für die Abfrage werden relevante Informationen (z.B. Produktname, Keywords) an die konfigurierten MCP-Server gesendet. Achte darauf, nur vertrauenswürdige Server zu verwenden.
Hinweis: Biloba IT übernimmt keine Verantwortung für Daten, die an fremde Server übertragen werden.
Ja, du kannst jeden MCP-kompatiblen Server einbinden. Trage einfach die entsprechenden Zugangsdaten in der Server-Verwaltung ein.
Die Textgenerierung funktioniert auch ohne MCP-Server. Wenn ein Server nicht erreichbar ist, wird der Text ohne die zusätzlichen Daten generiert.
Support
Bei Fragen oder Problemen stehen wir zur Verfügung:
- Support-Anfrage: biloba-it.de/shopware-plugin-support
- E-Mail: support@biloba-it.de
- Telefon: +49 (0) 711 – 13633800
German 
English