Handbuch KI Bild-SEO.

Von der Installation bis zum Zurückspulen: KI-Anbieter einrichten, Stil und Kontext festlegen, Vorschläge freigeben, die ganze Mediathek beschreiben lassen und Dateinamen sauber umbenennen.

Systemvoraussetzungen

Shopware 6.6 oder 6.7 mit Storefront und die PHP-Erweiterung cURL. Für die Bildbeschreibung brauchst du einen API-Schlüssel bei OpenAI, Anthropic, Google Gemini oder Mistral. Es wird kein Theme-Build benötigt, die Installation läuft per Upload im Admin ohne SSH.

Wichtig: Die KI-Kosten rechnet dein Anbieter direkt mit dir ab. Das Tageslimit und die Wiederverwendung bei identischen Bildern halten sie im Rahmen.

Installation

ZIP im Admin unter Erweiterungen, Meine Erweiterungen, Erweiterung hochladen einspielen, danach installieren und aktivieren. Das Plugin erscheint anschließend als eigener Menüpunkt im Administrationsbereich.

Beim ersten Öffnen fragt das Plugin nach dem Lizenz-Token. Ohne gültige Lizenz bleibt die Oberfläche gesperrt.

In drei Schritten einsatzbereit

  1. KI-Anbieter einrichten: Im Reiter Einstellungen Anbieter wählen, API-Schlüssel eintragen und mit Verbindung testen prüfen, ob das Modell Bilder erkennt.
  2. Erst einmal ansehen: Die Freigabe steht auf Vorschläge zur Freigabe. Lass in der Bildliste ein paar Bilder beschreiben und prüfe die Vorschläge, bevor sie geschrieben werden.
  3. Den Rest erledigen lassen: Passen die Texte, beschreibt Fehlende erzeugen alle Bilder eines Bereichs ohne Alt-Text. Für neue Bilder schaltest du die Automatik ein.

KI-Anbieter und Modell

Zur Wahl stehen OpenAI, Anthropic, Google Gemini und Mistral. Jedes Bild kostet einen Aufruf, in dem alle Sprachen auf einmal entstehen. Angeboten werden nur Modelle mit Bildeingabe, das empfohlene ist das günstigste mit guter Qualität. Ohne eigene Auswahl nutzt das Plugin je Anbieter ein Standardmodell.

Der Verbindungstest schickt ein Testbild und meldet, ob die Verbindung steht und ob das Modell das Bild erkannt hat. Die Bildgröße für die KI bestimmt, auf welche Kantenlänge ein Bild vor dem Senden verkleinert wird: größer erkennt mehr Details, kostet aber mehr.

Masterprompt, Tonalität und Längen

Der Masterprompt ist die Grundanweisung für jedes Bild in jeder Sprache und jedem Kanal, etwa zur Ansprache, zu Begriffen oder zu dem, was nie genannt werden soll. Ein Zusatz je Sprache ergänzt ihn nur für eine Sprache, etwa um Schreibweisen oder Fachbegriffe.

Tonalität, Mindest- und Höchstlänge des Alt-Texts und die Höchstlänge des Bildtitels geben den Rahmen vor. Zu lange Alt-Texte werden an einer Wortgrenze gekürzt, empfohlen sind etwa 125 Zeichen. Shop-Begriffe darf die KI nutzen, wenn sie passen. Verbotene Begriffe verwendet sie nie, sie werden zusätzlich aus den Texten entfernt.

Kontext aus dem Shop

Zusätzlich zum Bild bekommt die KI auf Wunsch den Produktnamen in der jeweiligen Sprache, den Hersteller, die tiefste Kategorie, Variantenoptionen und wichtige Eigenschaften sowie einen lesbaren Dateinamen. Kryptische Namen wie IMG_4711 werden ignoriert. Alle Quellen sind voreingestellt eingeschaltet.

Bildliste und Freigabe

Die Bildliste zeigt jedes Bild mit Status: Fehlt, KI-Text, Manuell, Dekorativ, Vorschlag offen, Fehler oder Nicht unterstützt. Gefiltert wird nach Sprache, Bereich und Status, dazu kommt eine Suche nach Dateiname, Alt-Text oder Titel. Je Seite lassen sich 25 bis 200 Bilder anzeigen.

Im Freigabe-Modus landet jeder Vorschlag in der Zeile des Bildes. Übernehmen schreibt ihn in die Mediathek, Anpassen öffnet ihn zum Bearbeiten, Verwerfen löscht ihn. Das geht je Bild, für eine Auswahl oder für den ganzen Filter. Unverändert übernommene Texte gelten als KI-Text, angepasste als eigener Text und bleiben geschützt.

Sammelläufe

Fehlende erzeugen beschreibt alle Bilder eines Bereichs, die noch keinen Alt-Text haben. Für eine Auswahl oder einen Filter lässt sich ausdrücklich auch neu beschreiben. Vorher zeigt das Plugin, wie viele Bilder betroffen sind.

Große Läufe laufen als Hintergrundauftrag mit gesichertem Fortschritt. Du kannst das Fenster schließen, bei aktivem Shopware-Worker auch den Admin. Meldet der Anbieter eine Ratenbegrenzung, wartet der Lauf eine Minute und macht dann weiter. Ist das Tageslimit erreicht, geht es am nächsten Tag weiter.

Automatik für neue Bilder

Ist Neue Bilder automatisch beschreiben eingeschaltet, werden neu hochgeladene Bilder vorgemerkt und nach der Wartezeit im Hintergrund beschrieben, auch nach Importen. Liegt ein Bild im Produktordner, hängt aber noch an keinem Produkt, wartet das Plugin auf die Zuordnung, damit der Produktkontext stimmt. Bei vorübergehenden Fehlern versucht es das bis zu dreimal erneut.

Die Automatik läuft über die geplanten Aufgaben von Shopware. Die Übersicht zeigt ihren Zustand und warnt, wenn die geplanten Aufgaben seit mehr als 15 Minuten nicht gelaufen sind. Mit Warteschlange jetzt abarbeiten startest du die fälligen Bilder sofort.

Dateinamen, Muster und Suchen und Ersetzen

Dateien umbenennen ist voreingestellt aus. Eingeschaltet schlägt die KI zu jedem Bild einen Dateinamen vor, klein, mit Bindestrichen und ohne Umlaute. Die alte Bild-URL und die alten Vorschaubilder werden per 301 auf die neuen weitergeleitet. Liegen die Medien extern, etwa auf S3 oder einem CDN, erreichen alte URLs Shopware nicht, die Weiterleitung greift dann nicht.

Nach Muster umbenennen vergibt Namen aus Platzhaltern in eckigen Klammern, ohne KI und ohne Kosten: Produkt, Hersteller, Variante, Artikelnummer, Kategorie, Alt-Text, bisheriger Name und eine fortlaufende Nummer. Suchen und Ersetzen ändert einen Begriff in Alt-Texten, Titeln, offenen Vorschlägen, Kanaltexten und auf Wunsch in Dateinamen, mit Vorschau.

Eigene Texte je Verkaufskanal

Für die unter Kanäle mit eigenen Texten gewählten Verkaufskanäle erzeugt die KI zusätzlich eigene Alt-Texte und Titel in deren Sprachen, mit einer eigenen Anweisung je Kanal, etwa für Ansprache, Zielgruppe oder Markenname. Im Shop des Kanals ersetzen sie den normalen Text. Hat ein Kanal für ein Bild keinen eigenen Text, gilt der normale Text der Sprache.

Dekorative Bilder und Ausgabe im Shop

Reine Schmuckbilder ohne Inhalt markierst du als dekorativ. Sie werden nicht beschrieben, bekommen im Shop ein leeres alt und werden von Screenreadern übersprungen.

Fehlt einem Bild trotzdem ein Alt-Text, setzt das Plugin im Shop einen Ersatz, damit nie ein leeres alt ausgeliefert wird. Woraus er entsteht, legst du fest: aus Produktname mit Variante, sonst Dateiname, oder nur aus einem lesbaren Dateinamen. Die Storefront-Einstellungen lassen sich je Verkaufskanal anpassen.

Verlauf und Zurückspulen

Jede Änderung an Alt-Texten, Bildtiteln, Dateinamen und der Dekorativ-Markierung wird im Verlauf gespeichert, gebündelt je Lauf. Zurückspulen lässt sich ein ganzer Lauf, eine einzelne Änderung oder alles ab einem Zeitpunkt, Dateinamen eingeschlossen. Werte, die nach dem Lauf noch einmal geändert wurden, bleiben standardmäßig stehen, damit keine spätere Arbeit verloren geht. Wie lange der Verlauf aufbewahrt wird, stellst du ein, 180 Tage sind voreingestellt.

Lizenz

Der Lizenz-Token wird beim ersten Öffnen des Plugins eingegeben. Gebunden ist die Lizenz an die Domain des Shops. Ohne gültige Lizenz sind die Funktionen des Plugins gesperrt, die bereits geschriebenen Texte in der Mediathek bleiben erhalten.

Problemlösung

  • Verbindung steht, Bild wird nicht erkannt: Das gewählte Modell versteht keine Bilder. Ein Modell mit Bildeingabe wählen.
  • Nicht unterstützt: Das Format kann die KI nicht lesen. SVG wird nur umgewandelt, wenn der Server Imagick mit SVG-Unterstützung hat. Sonst den Alt-Text von Hand eintragen.
  • Neue Bilder werden nicht beschrieben: Die geplanten Aufgaben von Shopware laufen nicht. Die Übersicht warnt dann, der Scheduled-Task-Runner muss eingerichtet sein.
  • Tageslimit erreicht: Es geht am nächsten Tag weiter, oder du erhöhst das Limit.
  • Texte werden übersprungen: Vorhandene manuelle Texte bleiben geschützt. Neu beschreiben musst du ausdrücklich wählen.
  • Umbenennung schlägt fehl: Dateien umbenennen ist ausgeschaltet oder der Name ist bereits belegt.

Support

Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler, nicht aus einer Warteschleife. Über die Plugin Suite im Admin lässt sich zusätzlich ein Feature anfragen.

Alle Einstellungen

Jede Einstellung des Plugins mit Standardwert und Erklärung, in derselben Reihenfolge wie im Administrationsbereich. Die Texte stammen direkt aus dem Plugin (Version 1.6.4).

Erzeugung

Ob Texte zuerst als Vorschlag zur Freigabe kommen oder direkt geschrieben werden, welche Felder und Sprachen die KI füllt und welche Bereiche der Mediathek dazugehören.

FreigabeStandard: Vorschläge zur Freigabe

Mit Freigabe erscheint jeder Vorschlag in der Bildliste und wird erst mit Übernehmen geschrieben. Direkt schreibt die KI sofort in die Mediathek.

FelderStandard: Alt-Text und Bildtitel

Welche Texte die KI erzeugt.

SprachenStandard: Alle Sprachen der Verkaufskanäle

Leer lassen für alle Sprachen, die einem Verkaufskanal zugeordnet sind. Alle Sprachen entstehen mit einem einzigen KI-Aufruf je Bild.

BereicheStandard: Alle Bereiche

Welche Bereiche der Mediathek bei Sammelläufen und in der Übersicht eine Rolle spielen.

KI-Anbieter

Anbieter, Zugangsschlüssel und Modell mit Verbindungstest. Der Test prüft auch, ob das Modell Bilder versteht. Dazu Zeitlimit und die Bildgröße, die an die KI geht.

AnbieterStandard: OpenAI

Ein Aufruf je Bild für alle Sprachen. Die günstigen schnellen Modelle beschreiben Produktbilder sehr gut.

API-SchlüsselStandard: leer

Wird nur für die Bildbeschreibung verwendet und nicht im Storefront ausgegeben.

ModellStandard: je nach Anbieter, bei OpenAI gpt-6-luna

Es stehen nur Modelle mit Bildeingabe zur Wahl. Das empfohlene Modell ist das günstigste mit guter Qualität. Eine eigene Modell-ID lässt sich zusätzlich eintragen.

Workspace-IDStandard: leer

Optional, nur für Anthropic-Workspaces.

Zeitlimit (Sekunden)Standard: 45

So lange wartet das Plugin höchstens auf die Antwort zu einem Bild. Möglich sind 10 bis 120.

Bildgröße für die KIStandard: 768 px (empfohlen)

Das Bild wird vor dem Senden auf diese Kantenlänge verkleinert. Größer erkennt mehr Details, macht den Aufruf aber teurer.

Texte und Stil

Tonalität, Länge von Alt-Text und Titel, Marke voranstellen, gewünschte und verbotene Begriffe sowie eigene Anweisungen an die KI.

MasterpromptStandard: leer

Grundanweisung an die KI für jedes Bild, in jeder Sprache und jedem Kanal: Ansprache, Begriffe, was immer genannt oder nie erwähnt werden soll.

Zusatz je SpracheStandard: leer

Ergänzt den Masterprompt nur für eine Sprache, etwa Schreibweisen oder Fachbegriffe. Leer lassen, wenn nichts Besonderes gilt.

TonalitätStandard: Neutral

Grundton der Texte.

Alt-Text mindestens (Zeichen)Standard: 40

Untergrenze als Richtwert für die KI. Möglich sind 10 bis 200.

Alt-Text höchstens (Zeichen)Standard: 125

Längere Texte werden an einer Wortgrenze gekürzt. Empfohlen sind etwa 125 Zeichen. Möglich sind 40 bis 300.

Bildtitel höchstens (Zeichen)Standard: 70

Der Titel erscheint im Browser als Tooltip. Möglich sind 20 bis 200.

Marke voranstellenStandard: aus

Ist eine Marke bekannt, steht sie am Anfang des Textes.

Shop-BegriffeStandard: leer

Begriffe, die die KI verwenden darf, wenn sie zum Bild passen. Kein Keyword-Stuffing, nur wo es natürlich klingt.

Verbotene BegriffeStandard: leer

Diese Wörter verwendet die KI nicht und sie werden zusätzlich aus den Texten entfernt. Durch Komma oder Zeilen trennen.

Texte je Verkaufskanal

Eigene Alt-Texte und Titel für einzelne Verkaufskanäle, etwa für eine zweite Marke. Sie ersetzen im Shop dieses Kanals die normalen Texte.

Kanäle mit eigenen TextenStandard: keine

Für diese Kanäle erzeugt die KI zusätzlich eigene Texte in deren Sprachen, mit einem weiteren KI-Aufruf je Bild.

Anweisung für den KanalStandard: leer

Ergänzt den Masterprompt für diesen Kanal, etwa Ansprache, Zielgruppe oder Markenname.

Kontext für die KI

Welche Shop-Daten die KI zusätzlich zum Bild bekommt, damit Produkt, Marke und Variante richtig benannt werden.

ProduktnameStandard: an

Name des Produkts, an dem das Bild hängt, in der jeweiligen Sprache.

HerstellerStandard: an

Herstellername, damit die Marke richtig geschrieben wird.

KategorieStandard: an

Die tiefste Kategorie des Produkts als zusätzlicher Hinweis.

Variante und EigenschaftenStandard: an

Variantenoptionen wie Farbe oder Größe und die wichtigsten Eigenschaften.

DateinameStandard: an

Ein lesbarer Dateiname hilft bei Bildern ohne Produktbezug. Kryptische Namen wie IMG_4711 werden ignoriert.

Automatik

Neu hochgeladene Bilder automatisch beschreiben und umbenennen: Ergebnis, Wartezeit nach dem Upload, Warten auf die Produktzuordnung und Bilder je Durchlauf.

Neue Bilder automatisch beschreibenStandard: aus

Neu hochgeladene Bilder werden vorgemerkt und im Hintergrund beschrieben, auch nach Importen. Läuft über die geplanten Aufgaben von Shopware alle 5 Minuten. Vorhandene Texte bleiben unangetastet, bei vorübergehenden Fehlern folgen bis zu drei weitere Versuche.

Ergebnis der AutomatikStandard: Direkt schreiben

Unabhängig von der Freigabe für Sammelläufe. Direkt schreibt Alt-Text, Titel und Dateinamen sofort, als Vorschlag kommt alles erst in die Bildliste.

Wartezeit nach dem Upload (Minuten)Standard: 10

Neue Bilder werden frühestens nach dieser Zeit beschrieben, damit sie schon einem Produkt zugeordnet sind und die KI den Produktkontext kennt. Möglich sind 0 bis 1440.

Auf die Produktzuordnung wartenStandard: an

Liegt ein neues Bild im Produktordner, hängt aber noch an keinem Produkt, wartet die Automatik bis zu einer Stunde darauf.

Bilder je DurchlaufStandard: 20

So viele vorgemerkte Bilder verarbeitet ein Durchlauf höchstens. Möglich sind 1 bis 200.

Dateinamen

Ob die KI auch sprechende Dateinamen vergibt, etwa sofa-lima-anthrazit.jpg statt IMG_4711.jpg. Alte Bild-URLs leitet das Plugin per 301 auf die neuen weiter.

Dateien umbenennenStandard: Aus

Aus: Dateinamen bleiben unverändert. Neue Uploads automatisch: neue Bilder bekommen beim automatischen Beschreiben einen sprechenden Namen, bestehende Bilder nur auf Wunsch, im Sammellauf über Umfang, am einzelnen Bild oder nach Muster. Neue Uploads und Sammelläufe: wie zuvor, im Sammellauf sind Dateinamen zusätzlich schon vorausgewählt.

Sprache der DateinamenStandard: Hauptsprache des Shops

Eine Bilddatei hat genau einen Namen. Standard ist die Hauptsprache des Shops, für internationale Shops kann eine feste Sprache wie Englisch sinnvoll sein.

Kosten und Schutz

Tageslimit für analysierte Bilder, Wiederverwendung von Texten bei identischen Bildern, Verlauf und Bildindex.

Tageslimit (Bilder)Standard: 500

Höchstzahl der Bilder, die pro Tag an die KI gehen. 0 bedeutet ohne Grenze. Möglich sind 0 bis 1000000.

Gleiche Bilder nur einmal analysierenStandard: an

Ist dasselbe Bild schon beschrieben, werden die Texte übernommen, ohne die KI erneut zu fragen.

Verlauf aufbewahren (Tage)Standard: 180

So lange bleiben Änderungen im Verlauf und lassen sich zurückspulen. 0 bedeutet unbegrenzt. Möglich sind 0 bis 3650.

Storefront

Ausgabe im Shop je Verkaufskanal: dekorative Bilder mit leerem alt und ein sinnvoller Ersatz, wenn ein Alt-Text fehlt.

Im Storefront aktivStandard: an

Schaltet die Ausgabe im Shop für diesen Verkaufskanal ein oder aus. Die Texte in der Mediathek bleiben davon unberührt.

Fehlende Alt-Texte ergänzenStandard: an

Fehlt ein Alt-Text, setzt das Plugin im Shop einen sinnvollen Ersatz, damit nie ein leeres alt ausgeliefert wird.

Ersatz ausStandard: Produktname mit Variante, sonst Dateiname

Woraus der Ersatztext entsteht.

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich19,90 €
Bester PreisJährlich199,99 €16 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.