WooCommerce Preisliste exportieren: als CSV per Anfrage an einen KI-Assistenten

Ein Großhandelskunde möchte Ihre aktuellen Preise, das Lager braucht eine Bestandsliste, ein Marktplatz will bis Freitag eine Datei. Jedes Mal müssen Sie eine WooCommerce Preisliste exportieren: einige Produkte, einige Spalten, in einer Reihenfolge, die dem Empfänger etwas sagt. Mit dem MCP-Server von BEAR, der an einen KI-Assistenten wie Claude angeschlossen ist, ist das ein einziger Satz: Sie sagen, welche Produkte und welche Spalten, und wenige Sekunden später haben Sie eine CSV-Datei über einen Download-Link. Dieser Leitfaden behandelt, wie Sie fragen, was in der Datei landet und in welchem Format, wo die Datei liegt und wie lange, und wie Sie sie in einer Tabellenkalkulation oder für einen Import verwenden.

Ein Beispiel: eine WooCommerce Preisliste für einen Großhandelskunden exportieren

Sie tippen:

Die Kategorie Bags als Preisliste exportieren: SKU, Titel, regulärer Preis, Angebotspreis und Lagerbestandsmenge, in dieser Reihenfolge. Semikolons verwenden.

1. Der Assistent findet die Produkte. Er sucht die Kategorie Bags und bittet BEAR, einen Filter darauf auszuführen. BEAR friert die passenden Produkte als Auswahl ein und liefert die genaue Anzahl. Sagen wir 38 Produkte.
2. Er bittet darum, woobe_export_csv zu verwenden, mit dieser Auswahl, Ihren fünf Spalten in Ihrer Reihenfolge und einem Semikolon als Trennzeichen. Variationen sind standardmäßig enthalten: Auf jedes variable Produkt folgt eine Zeile pro Variation, weil dort die Preise und der Lagerbestand eines variablen Produkts liegen.
3. BEAR schreibt die Datei auf Ihren Server, mit demselben Code, den auch der Exportieren (Export)-Tab des Plugins verwendet, sodass jeder Wert genau so formatiert ist wie in einer auf dem Plugin-Bildschirm exportierten Datei.
4. Sie erhalten einen kurzen Bericht und einen Link: wie viele Zeilen (Variationen eingeschlossen), wie viele Produkte ausgewählt waren, wie viele Spalten, die Dateigröße und einen Download-Link, der 15 Minuten lang funktioniert. Der Assistent soll Ihnen den Link unverändert geben und die Datei nicht selbst lesen.
5. Sie öffnen den Link, und der Browser lädt eine Datei herunter, die etwa so heißt: woobe_mcp_export_2026-10-12_09-30-15_aB3dE9.csv.

Die ersten Zeilen einer solchen Datei sehen so aus (Beispielprodukte):

SKU;Title;"Regular price";"Sale price";"Stock quantity"
BAG-100;"Canvas Duffel Bag";0;0;0
BAG-100-BL;"Canvas Duffel Bag - Black, L";134.85;0;24
BAG-100-GL;"Canvas Duffel Bag - Green, L";134.85;114.6;20
TOTE-39;"Summer Tote Bag";109.13;0;56

Die Nullen in diesem Beispiel sind keine Fehler in Ihren Daten. So schreibt BEAR 2.2.4 leere Zahlen, erklärt im Abschnitt zu den Werten weiter unten.

Bevor Sie beginnen

Sie brauchen BEAR mit eingeschaltetem MCP-Server in den Plugin-Einstellungen, einen Shop, der über HTTPS erreichbar ist, und einen KI-Assistenten, der sich mit einem MCP-Server verbinden kann, etwa Claude im Browser, in der Desktop-App oder in Claude Code, oder Cursor. BEAR authentifiziert mit einem Schlüssel in einem Request-Header, ChatGPT funktioniert also nur dort, wo sein Connector das Hinzufügen dieses Headers erlaubt. Die Schritte zur Verbindung stehen in der MCP-Server-Dokumentation.

Welche Produkte in den Export gelangen

Alles, was der Filter von BEAR beschreiben kann: eine Kategorie, ein Tag, eine Marke, ein Attributwert („alles in Rot“), eine Preisspanne, der Lagerstatus, der Produkttyp, ein Datumsbereich, ein Text im Titel oder in der SKU oder Kombinationen davon. Sie können auch Produkte oder SKUs direkt nennen oder den gesamten Katalog verlangen, worauf der Assistent hinweisen soll, bevor er fortfährt.

• Produkte nach Kategorie exportieren, Unterkategorien eingeschlossen. Eine Kategorie im Filter enthält ihre Unterkategorien nicht von selbst. Sagen Sie „Bags und alles darunter“, und der Assistent fügt die untergeordneten Kategorien dem Filter hinzu.
• Variationen. Standardmäßig eingeschaltet. Jedes variable Produkt exportiert zuerst seine eigene Zeile, dann eine Zeile pro Variation. Sagen Sie „ohne Variationen“ für eine Liste nur der Produkte; die Zeile eines variablen Produkts hat dann keinen brauchbaren Preis.
• Reihenfolge. Die Zeilen folgen der Reihenfolge der Auswahl, also nach Produkt-ID, sofern Sie keine Sortierung verlangen, zum Beispiel nach Titel. Variationen stehen immer direkt hinter ihrem übergeordneten Produkt.
• Größe. Ein Export über die Verbindung fasst bis zu 20.000 Zeilen, Variationen mitgezählt. Eine größere Auswahl wird unter Nennung der Zeilenzahl abgelehnt; grenzen Sie sie ein oder nutzen Sie den Exportieren-Tab auf dem Plugin-Bildschirm, der in Stapeln arbeitet und keine solche Obergrenze hat.

Welche Spalten, in welcher Reihenfolge

Nennen Sie die Spalten in Ihren eigenen Worten und in der gewünschten Reihenfolge. Der Assistent übersetzt „Preis“ oder „Lagerbestand“ anhand der Feldliste in die Feldschlüssel von BEAR und übergibt sie in Ihrer Reihenfolge. Eine Preisliste, die mit der SKU beginnt, und eine Bestandsliste, die mit dem Titel beginnt, entstehen aus denselben Produkten.

Die Grenze, die Sie kennen sollten: Ein Export kann nur die Spalten verwenden, die für die Verbindung eingeschaltet sind. Er kann sie eingrenzen und umordnen, aber keine anderen hinzufügen. Welche Spalten das sind, hängt davon ab, wie der Assistent verbunden ist:

• Mit dem shopweiten Schlüssel steht kein WordPress-Benutzer hinter der Verbindung, daher verwendet BEAR seinen Standardspaltensatz: ID, Vorschaubild (Thumbnail), Titel (Title), Beschreibung (Description), Kurzbeschr. (Short Desc.), Typ (Type), Status, Regulärer Preis (Regular price), Angebotspreis (Sale price), SKU, Lagerbestand verwalten (Manage stock), Lagerbestandsmenge (Stock quantity) und Lagerstatus (Stock status). Die Spalten, die Sie für sich selbst im Editor eingeschaltet haben, gelten dafür nicht.
• Mit einem persönlichen Schlüssel läuft die Verbindung als dieser Benutzer und verwendet daher die Spalten, die dieser Benutzer im Einstellungen (Settings)-Tab von BEAR eingeschaltet hat, mit den dort vergebenen Titeln.

Bitten Sie um eine Spalte außerhalb dieses Satzes, zum Beispiel um eine Kategorienspalte mit dem shopweiten Schlüssel, schreibt BEAR nichts, antwortet, dass die Spalte nicht eingeschaltet ist, und listet die verfügbaren Spalten auf. Es gibt drei Wege darum herum: sich mit einem persönlichen Schlüssel verbinden; den Exportieren-Tab auf dem Plugin-Bildschirm verwenden, der Ihre eigenen Spalten exportiert; oder den shopweiten Schlüssel mit diesem Snippet den Spaltensatz eines Administrators verwenden lassen:

// Child theme functions.php or a code snippets plugin.
// BEAR MCP: the shop-wide key has no WordPress user (ID 0).
// Give it the BEAR settings, including the columns, of user 1.
add_filter( 'woobe_settings_key_options', function ( $key ) {
    return 0 === (int) $key ? 1 : $key;
} );

Ersetzen Sie 1 durch die ID des Administrators, dessen Spalten die Exporte verwenden sollen. Auch die anderen BEAR-Einstellungen dieses Benutzers, etwa die Spaltentitel, gelten dann für die Verbindung. Wenn Sie bereits einen Einstellungssatz mit demselben Filter für alle Benutzer teilen, teilt der shopweite Schlüssel ihn ebenfalls.

Nennen Sie die Spalten immer. Ohne Liste nimmt der Export jede verfügbare Spalte, und mit dem shopweiten Schlüssel gehören dazu vollständige Beschreibungen in HTML und Bild-URLs, die eine Preisliste unlesbar machen.

Wie die Werte in der Datei aussehen

Die Datei wird vom Exportcode von BEAR erstellt, der Werte so schreibt, wie der Produktimporter von WooCommerce sie liest, nicht so, wie ein Mensch eine Preisliste formatieren würde. Kennen Sie diese Punkte, bevor Sie die Datei an jemanden schicken:

Zwei Folgerungen für eine Preisliste. Erstens: Unterscheiden Sie Variationen an SKU oder Titel, nicht an Attributspalten. Der Titel einer Variation enthält ihre Attributwerte nur, wenn WooCommerce sie dort eingetragen hat; Variationstitel mit Attributen erklärt, wann das der Fall ist. Zweitens: Ein Angebot, das erst nächste Woche beginnt, zeigt seinen Angebotspreis bereits, weil die Spalte den gespeicherten Angebotspreis enthält. Wenn das eine Rolle spielt, fragen Sie den Assistenten zuerst, bei welchen Produkten der Liste ein Angebot geplant ist.

Preise sind die Zahlen, die WooCommerce speichert, in der Hauptwährung Ihres Shops, mit oder ohne Steuer je nach der WooCommerce-Einstellung Preise mit Steuern eingeben (Prices entered with tax). Es wird nichts umgerechnet. Ein Shop, der feste Preise pro Währung als Produktfelder speichert, kann sie nur exportieren, wenn diese Felder zu den verfügbaren Spalten gehören.

Trennzeichen, Kodierung und Excel

• Trennzeichen. Standardmäßig ein Komma. Verlangen Sie ein Semikolon, wenn Ihre Tabellenkalkulation eines erwartet, was in den meisten Ländern des europäischen Festlands der Fall ist; jedes einzelne Zeichen funktioniert, auch ein Tabulator. Text mit Leerzeichen oder Trennzeichen darin wird in doppelte Anführungszeichen gesetzt.
• Kodierung. UTF-8 mit einer Byte-Order-Mark am Anfang, damit Excel Umlaute, Akzente und andere Schriften beim Doppelklick auf die Datei korrekt anzeigt.
• Dezimalkomma. Der Punkt in Preisen kann eine auf Dezimalkomma eingestellte Tabellenkalkulation irritieren: 134.85 bleibt womöglich Text, und 12.5 kann sogar zu einem Datum werden. Öffnen Sie die Datei über den Import Daten → Aus Text/CSV (Data → From Text/CSV) von Excel und stellen Sie das Gebietsschema der Datei auf eines mit Dezimalpunkt, etwa Englisch (USA); LibreOffice Calc bietet dieselbe Auswahl als Sprache (Language) in seinem Importdialog.
• Formate. Über die Verbindung nur CSV. Der Exportieren-Tab auf dem Plugin-Bildschirm schreibt auch XML.

Wo die Datei liegt und wie lange der Link funktioniert

Die Datei wird in den Export-Ordner von BEAR auf Ihrem eigenen Server geschrieben, einen Ordner im Plugin, den BEAR für den direkten Webzugriff sperrt, und der Dateiname endet mit zufälligen Zeichen, damit er schwer zu erraten ist. Sie laden sie über einen Link zu Ihrem Shop herunter, der einen eigenen zufälligen Token trägt:

• Der Link funktioniert 15 Minuten und braucht keine Anmeldung, er öffnet sich also auf jedem Gerät, auch auf Ihrem Telefon. In diesen 15 Minuten lässt er sich erneut öffnen.
• Danach antwortet er Dieser Download-Link ist abgelaufen. Fordern Sie den Export erneut an. (This download link has expired. Ask for the export again.) Wurde die Datei bereits aufgeräumt, antwortet er Diese Exportdatei befindet sich nicht mehr auf dem Server. (That export file is no longer on the server.) In beiden Fällen fragen Sie erneut; ein neuer Export dauert Sekunden.
• Die Aufräumroutine von BEAR löscht Exportdateien, die älter als acht Stunden sind.
• Jeder, der den Link hat, kann die Datei herunterladen, solange er funktioniert. Posten Sie ihn nicht in einem öffentlichen Kanal. Für einen Kunden laden Sie die Datei herunter und schicken die Datei, nicht den Link.

Der MCP-Schlüssel des Shops erscheint nie im Link. Geht ein Link verloren, ist eine Datei eine Viertelstunde lang offen, nicht der Zugang zu Ihrem Shop.

Ein Export ändert keine Produkte und wird nie auf das Schreibkontingent der kostenlosen Version angerechnet, er funktioniert also in beiden Versionen gleich. Wenn Personen sich mit persönlichen Schlüsseln verbinden, kann ein Administrator den Export für jemanden mit dem Filter woobe_mcp_permissions sperren, indem er den Sektor export auf none setzt.

Die CSV verwenden: Kunden, Lieferanten und Reimport

Für einen Kunden oder Lieferanten bereinigen Sie die Datei in der Tabellenkalkulation: Löschen Sie die Zeilen der variablen Elternprodukte (Typ „variable“, Preis 0), leeren Sie die Nullen in der Spalte Angebotspreis, formatieren Sie die Preise mit zwei Dezimalstellen und ergänzen Sie die Währung in der Kopfzeile. Fünf Minuten Arbeit, und die 0 in der Spalte Angebotspreis liest sich nicht mehr als „gratis“.

Für das Lager verlangen Sie SKU, Titel, Lagerbestandsmenge und Lagerstatus. Bedenken Sie, dass eine 0 in der Lagerbestandsmenge auch bedeuten kann, dass das Produkt keinen Lagerbestand verfolgt; nehmen Sie Lagerbestand verwalten in die Spalten auf, um die beiden Fälle zu unterscheiden.

Für einen Reimport in WooCommerce laden Sie die Datei nicht unverändert. Als 0 exportierte leere Preise würden Produkte für 0 ins Angebot setzen, und eine Lagerbestandsmenge von 0 schaltet die Lagerbestandsverwaltung ein. Bestehende Produkte per CSV-Import aktualisieren listet jede zu prüfende Spalte auf und liefert einen Filter, der leere Zellen statt Nullen schreibt. Dieser Filter ändert den Exportcode selbst und gilt daher auch für Exporte über den Assistenten. Zum Exportieren-Tab und seinen Optionen siehe die Dokumentation zum Produktexport.

Als Sicherung vor einer großen Textarbeit hält ein Export von ID, Titel, Beschreibung und Kurzbeschreibung die aktuellen Texte fest, was nützlich ist, bevor Sie WooCommerce-Produktbeschreibungen mit KI schreiben.

Fertige Prompts

• „Eine Preisliste der Kategorie Bags exportieren: SKU, Titel, regulärer Preis, Angebotspreis.“
• „Dieselbe Liste, Bags und alle Unterkategorien, mit Semikolons.“
• „Alle Produkte exportieren, die auf Lager sind: SKU, Titel, Lagerbestandsmenge, nach Titel sortiert.“
• „Alles exportieren, was gerade im Angebot ist: SKU, Titel, regulärer Preis, Angebotspreis.“
• „Die variablen Produkte in Shirts mit ihren Variationen exportieren: SKU, Titel, Preis, Lagerbestand.“
• „Die Produkte in Shoes ohne Variationen exportieren: ID, Titel, Status.“
• „Produkte mit den SKUs TS-101, TS-102 und TS-205 exportieren: SKU, Titel, regulärer Preis.“
• „Die in diesem Monat erstellten Entwürfe exportieren: ID, Titel, regulärer Preis, Status.“
• „ID, Titel, Beschreibung und Kurzbeschreibung der Kategorie Candles als Sicherung exportieren.“
• „Die nicht vorrätigen Produkte für meinen Lieferanten exportieren: SKU, Titel, Lagerstatus.“

Checkliste

• MCP-Server eingeschaltet und Assistent verbunden (Einrichtung).
• Die Anzahl der Produkte entspricht Ihrer Erwartung; Unterkategorien hinzugefügt, wenn Sie sie möchten.
• Spalten benannt, in Ihrer Reihenfolge; für eine Spalte außerhalb des verfügbaren Satzes einen persönlichen Schlüssel, den Exportieren-Tab oder das Snippet oben verwenden.
• Variationen an für Preise und Lagerbestand, aus für eine Liste von Produktnamen.
• Semikolon, wenn Ihre Tabellenkalkulation eines erwartet; über Daten → Aus Text/CSV importieren, wenn Preise nicht als Zahlen gelesen werden.
• Innerhalb von 15 Minuten herunterladen; die Datei schicken, nicht den Link.
• Vor dem Versand: Elternzeilen mit Preis 0 entfernen und Nullen in der Spalte Angebotspreis leeren.
• Vor einem Reimport: die Anleitung zum CSV-Import lesen; die Nullen nie unverändert importieren.

Fragen

Warum zeigen meine variablen Produkte einen Preis von 0?

Ein variables Produkt hat keinen eigenen Preis; seine Variationen haben einen. BEAR schreibt den leeren Preis des Elternprodukts als 0. Lassen Sie die Variationen eingeschaltet und lesen Sie die Preise aus den Variationszeilen.

Kann der Assistent die Preisliste per E-Mail an meinen Kunden schicken?

Nein. Der Export gibt Ihnen einen Download-Link; die Datei zu versenden, liegt bei Ihnen.

Kann ich eine WooCommerce-Preisliste im Excel-Format exportieren?

Die Verbindung schreibt CSV, das Excel direkt öffnet; die Byte-Order-Mark erhält Umlaute und Akzente. Brauchen Sie .xlsx, speichern Sie die geöffnete Datei in diesem Format.

Gibt es eine Obergrenze für die Zahl der exportierbaren Produkte?

20.000 Zeilen pro Export über die Verbindung, Variationen als Zeilen gezählt. Der Exportieren-Tab auf dem Plugin-Bildschirm hat keine solche Grenze.

Verhält sich etwas in Ihrem Shop anders als hier beschrieben, fragen Sie im BEAR-Support-Forum.