OpenJack › Connecteurs › Marketplaces Mirakl

E-commerce · Mirakl

Marketplaces Mirakl

Interrogez Claude sur vos commandes, votre stock, vos versements et les messages clients sur Worten, Carrefour, Leroy Merlin, Decathlon et toute autre marketplace Mirakl.

Connecte Claude à votre compte vendeur sur n'importe quelle marketplace propulsée par Mirakl (Worten, Carrefour, Leroy Merlin, Decathlon, Conforama, Maisons du Monde et bien d'autres) en lecture seule. Listez et filtrez les commandes et ouvrez-en une avec ses lignes, commissions et remboursements ; parcourez vos offres, repérez les stocks faibles et comparez votre prix à celui des autres vendeurs par SKU ou EAN ; suivez les retours ; consultez les factures, lignes de transaction et versements de la marketplace ; lisez les messages des clients et de l'opérateur ; et obtenez une synthèse des ventes sur n'importe quelle période avec chiffre d'affaires, commission, remboursements, net et meilleurs SKU. Les noms, e-mails, téléphones et adresses des clients sont masqués (seuls la ville et le pays sont affichés). Rien n'est jamais accepté, expédié, remboursé, modifié en prix ni répondu.

Ce que vous pouvez demander

Quelles commandes attendent que je les accepte ou les expédie sur Worten en ce moment ?Synthèse des ventes d'octobre : chiffre d'affaires, commission de la marketplace, remboursements et mes 10 meilleurs SKULesquelles de mes offres ont 5 unités ou moins en stock ?Suis-je le vendeur le moins cher pour l'EAN 9312432012041 ?Quels messages clients attendent encore ma réponse ?Combien la marketplace m'a-t-elle versé lors des derniers cycles de facturation, et combien a-t-elle gardé en commissions ?

Outils et tarifs

13 outils

OutilFonctionPar appel
mirakl_shop_infoProfil de la boutique : statut, note, taux d'acceptation, nombre d'offres et de commandes, KYC et soldes de paiement0,01 €
mirakl_list_ordersCommandes filtrées par statut, date de création ou de mise à jour, canal ou incident (100 par page)0,01 €
mirakl_get_orderUne commande avec toutes ses lignes : SKU, quantité, prix, livraison, commission, remboursements, suivi0,01 €
mirakl_list_offersVos offres avec SKU, EAN, prix, remise, stock et statut actif (100 par page)0,01 €
mirakl_low_stock_offersToutes les offres dont le stock est inférieur ou égal à un seuil, du plus bas au plus haut0,025 €
mirakl_lookup_productUn produit par SKU boutique, SKU produit ou EAN : votre offre et le prix de tous les vendeurs0,01 €
mirakl_list_returnsDemandes de retour avec statut, RMA, motif, quantités et suivi0,01 €
mirakl_list_invoicesDocuments comptables émis par la marketplace avec totaux, commissions et statut de paiement0,01 €
mirakl_list_transactionsLignes de transaction (montants de commandes, commissions, remboursements, frais, paiements) avec totaux par type0,01 €
mirakl_list_billing_cyclesCycles de facturation et versements : montant transféré, statut du versement et principaux totaux0,01 €
mirakl_list_threadsFils de discussion avec les clients et l'opérateur, y compris ceux qui attendent votre réponse0,01 €
mirakl_get_threadUn fil de discussion avec tous ses messages (coordonnées du client masquées)0,01 €
mirakl_sales_summaryCommandes, unités, chiffre d'affaires, commission, remboursements et net d'une période, par statut, mois et SKU principal0,05 €

Facturé uniquement si l'appel aboutit. La liste des outils est gratuite.

Comment se connecter

Ajoutez-le à Claude

Créez un compte OpenJack et copiez votre clé de connexion depuis votre compte.
Dans Claude, ouvrez « Settings → Connectors → Add custom connector » et collez https://mirakl.openjack.dev/mcp.
Cliquez sur « Connect ». Sur la page de connexion, saisissez votre clé de connexion et vos identifiants Mirakl. Ils sont vérifiés en direct et stockés chiffrés.

Prérequis

FAQ

Quelles marketplaces sont compatibles ?

Toute marketplace qui fonctionne avec Mirakl et fournit une clé d'API aux vendeurs, comme Worten, Carrefour, Leroy Merlin (ADEO), Decathlon, Conforama, Maisons du Monde et bien d'autres. Chaque marketplace a sa propre adresse Mirakl : utilisez celle que vous voyez dans le navigateur en vous connectant au back-office vendeur. Connectez chaque marketplace séparément.

Où trouver la clé d'API ?

Dans le back-office vendeur, cliquez sur votre nom d'utilisateur (en haut à droite) → My user settings → API Key, puis générez ou copiez la clé. Générer une nouvelle clé invalide la précédente : les autres outils qui l'utilisent auront besoin de la nouvelle. Traitez-la comme un mot de passe.

Claude peut-il accepter des commandes, changer des prix ou répondre aux clients ?

Non. Tous les outils sont en lecture seule. Le connecteur n'accepte ni ne refuse jamais de commandes, n'expédie pas, ne rembourse pas, ne modifie ni offres, ni prix, ni stock et n'envoie aucun message.

Que deviennent les données personnelles de mes clients ?

Les noms, e-mails, numéros de téléphone et adresses des clients sont supprimés avant d'atteindre Claude ; seuls la ville et le pays de livraison sont conservés. Les e-mails et numéros de téléphone écrits dans les messages sont également masqués. Rien n'est stocké ni journalisé.

Comment le chiffre d'affaires est-il calculé dans la synthèse des ventes ?

Seules les commandes acceptées par la boutique (de WAITING_DEBIT à CLOSED) comptent comme ventes ; les commandes refusées, annulées ou en attente d'acceptation apparaissent par statut mais pas dans le chiffre d'affaires. Les remboursements et la commission restituée sont déduits pour obtenir le net. Les montants sont TTC ou HT selon le réglage de la marketplace, ou selon votre demande.

Y a-t-il des limites ?

Mirakl renvoie au maximum 100 éléments par page et chaque marketplace fixe des limites horaires par API (l'API des lignes de transaction autorise au plus 60 appels par heure ; la consultation des prix concurrents environ 5 par minute). La synthèse des ventes lit jusqu'à 3 000 commandes et l'analyse des stocks faibles jusqu'à 2 000 offres par appel, et elles indiquent quand le résultat est tronqué.

Également sur OpenJack