OpenJack › Konnektoren › Mirakl-Marktplätze

E-Commerce · Mirakl

Mirakl-Marktplätze

Fragen Sie Claude nach Bestellungen, Bestand, Auszahlungen und Kundennachrichten auf Worten, Carrefour, Leroy Merlin, Decathlon und jedem anderen Mirakl-Marktplatz.

Verbindet Claude im Nur-Lese-Modus mit Ihrem Verkäuferkonto auf jedem Marktplatz, der auf Mirakl läuft (Worten, Carrefour, Leroy Merlin, Decathlon, Conforama, Maisons du Monde und viele mehr). Listen und filtern Sie Bestellungen und öffnen Sie eine mit Positionen, Provisionen und Erstattungen; durchsuchen Sie Ihre Angebote, finden Sie niedrige Bestände und vergleichen Sie Ihren Preis per SKU oder EAN mit anderen Verkäufern; verfolgen Sie Retouren; lesen Sie Rechnungen, Transaktionszeilen und Auszahlungen des Marktplatzes; lesen Sie Nachrichten von Kunden und Betreiber; und erhalten Sie eine Umsatzübersicht für beliebige Zeiträume mit Umsatz, Provision, Erstattungen, Netto und Top-SKUs. Namen, E-Mails, Telefonnummern und Adressen der Kunden werden ausgeblendet (nur Stadt und Land werden angezeigt). Es wird nie etwas angenommen, versendet, erstattet, im Preis geändert oder beantwortet.

Was Sie fragen können

Welche Bestellungen warten auf Worten gerade darauf, dass ich sie annehme oder versende?Umsatzübersicht für Oktober: Umsatz, Marktplatzprovision, Erstattungen und meine Top-10-SKUsWelche meiner Angebote haben 5 Stück oder weniger auf Lager?Bin ich der günstigste Verkäufer für EAN 9312432012041?Welche Kundennachrichten warten noch auf meine Antwort?Wie viel hat mir der Marktplatz in den letzten Abrechnungszyklen ausgezahlt und wie viel als Provision einbehalten?

Werkzeuge und Preise

13 Werkzeuge

WerkzeugFunktionPro Aufruf
mirakl_shop_infoShop-Profil: Status, Bewertung, Annahmequote, Anzahl Angebote und Bestellungen, KYC und Auszahlungssalden0,01 €
mirakl_list_ordersBestellungen nach Status, Erstellungs- oder Änderungsdatum, Kanal oder Vorfall gefiltert (100 pro Seite)0,01 €
mirakl_get_orderEine Bestellung mit allen Positionen: SKU, Menge, Preise, Versand, Provision, Erstattungen, Sendungsverfolgung0,01 €
mirakl_list_offersIhre Angebote mit SKU, EAN, Preis, Rabatt, Bestand und Aktiv-Status (100 pro Seite)0,01 €
mirakl_low_stock_offersAlle Angebote mit Bestand auf oder unter einem Schwellenwert, niedrigster zuerst0,025 €
mirakl_lookup_productEin Produkt per Shop-SKU, Produkt-SKU oder EAN: Ihr Angebot und die Preise aller Verkäufer0,01 €
mirakl_list_returnsRetourenanfragen mit Status, RMA, Grund, Mengen und Sendungsverfolgung0,01 €
mirakl_list_invoicesVom Marktplatz ausgestellte Buchhaltungsbelege mit Summen, Provisionen und Zahlungsstatus0,01 €
mirakl_list_transactionsTransaktionszeilen (Bestellbeträge, Provisionen, Erstattungen, Gebühren, Zahlungen) mit Summen pro Typ0,01 €
mirakl_list_billing_cyclesAbrechnungszyklen und Auszahlungen: überwiesener Betrag, Auszahlungsstatus und Hauptsummen0,01 €
mirakl_list_threadsNachrichten-Threads mit Kunden und Betreiber, inklusive offener Antworten0,01 €
mirakl_get_threadEin Nachrichten-Thread mit allen Nachrichten (Kontaktdaten der Kunden ausgeblendet)0,01 €
mirakl_sales_summaryBestellungen, Einheiten, Umsatz, Provision, Erstattungen und Netto für einen Zeitraum, nach Status, Monat und Top-SKU0,05 €

Berechnet wird nur, wenn der Aufruf erfolgreich ist. Das Auflisten der Werkzeuge ist kostenlos.

So verbinden Sie

Zu Claude hinzufügen

Erstellen Sie ein OpenJack-Konto und kopieren Sie Ihren Verbindungsschlüssel aus Ihrem Konto.
Öffnen Sie in Claude „Settings → Connectors → Add custom connector“ und fügen Sie https://mirakl.openjack.dev/mcp ein.
Klicken Sie auf „Connect“. Geben Sie auf der Verbindungsseite Ihren Verbindungsschlüssel und Ihre Zugangsdaten für Mirakl ein. Sie werden live geprüft und verschlüsselt gespeichert.

Voraussetzungen

FAQ

Welche Marktplätze funktionieren?

Jeder Marktplatz, der auf Mirakl läuft und Verkäufern einen API-Schlüssel gibt, etwa Worten, Carrefour, Leroy Merlin (ADEO), Decathlon, Conforama, Maisons du Monde und viele mehr. Jeder Marktplatz hat seine eigene Mirakl-Adresse: Verwenden Sie die, die Sie beim Anmelden im Verkäufer-Backoffice im Browser sehen. Verbinden Sie jeden Marktplatz separat.

Wo finde ich den API-Schlüssel?

Klicken Sie im Verkäufer-Backoffice auf Ihren Benutzernamen (oben rechts) → My user settings → API Key und erzeugen oder kopieren Sie den Schlüssel. Ein neuer Schlüssel macht den alten ungültig, andere Tools brauchen dann den neuen. Behandeln Sie ihn wie ein Passwort.

Kann Claude Bestellungen annehmen, Preise ändern oder Kunden antworten?

Nein. Alle Tools haben nur Lesezugriff. Der Connector nimmt nie Bestellungen an oder lehnt sie ab, versendet nicht, erstattet nicht, ändert keine Angebote, Preise oder Bestände und sendet keine Nachrichten.

Was passiert mit den personenbezogenen Daten meiner Kunden?

Namen, E-Mails, Telefonnummern und Straßenadressen der Kunden werden entfernt, bevor etwas Claude erreicht; nur Lieferstadt und -land bleiben erhalten. In Nachrichten geschriebene E-Mail-Adressen und Telefonnummern werden ebenfalls ausgeblendet. Nichts wird gespeichert oder protokolliert.

Wie wird der Umsatz in der Umsatzübersicht gezählt?

Nur vom Shop angenommene Bestellungen (von WAITING_DEBIT bis CLOSED) zählen als Verkäufe; abgelehnte, stornierte und noch nicht angenommene Bestellungen erscheinen pro Status, aber nicht im Umsatz. Erstattungen und die darauf zurückerstattete Provision werden für das Netto abgezogen. Beträge sind je nach Marktplatzeinstellung oder Ihrer Vorgabe brutto oder netto.

Gibt es Limits?

Mirakl liefert höchstens 100 Einträge pro Seite, und jeder Marktplatz legt stündliche Limits pro API fest (die Transaktionszeilen-API erlaubt höchstens 60 Aufrufe pro Stunde, die Wettbewerbspreisabfrage etwa 5 pro Minute). Die Umsatzübersicht liest bis zu 3 000 Bestellungen und die Niedrigbestandsprüfung bis zu 2 000 Angebote pro Aufruf; beide melden, wenn ein Ergebnis gekürzt wurde.

Ebenfalls bei OpenJack