Zusammenfassung
Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-API von Grupo Éxito betreiben: Liste deine Produkte und ihren Freigabestatus auf, erstelle Produkte mit Bildern, Beschreibungen und Attributen, lege Preise und Bestand fest und lies Bestellungen und Auszahlungsabrechnungen aus.
Geführte Einrichtung
Grupo Éxito Marketplace in 2 Minuten mit Gemini verbinden
Starte die kostenlose Testphase in der AnythingMCP Cloud, verbinde Grupo Éxito Marketplace in der geführten Einrichtung und trag deine MCP-URL in Gemini ein. Ohne Code, ohne eigenen Server.
Keine Kreditkarte · 7 Tage Test · Self-Hosting-Alternative verfügbar
Frag einfach
Beispiel-Prompts für Grupo Éxito Marketplace
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze direkt cloud.anythingmcp.com. Melde dich an, klicke auf Connectors → Grupo Éxito Marketplace, füge deine Zugangsdaten ein, erstelle einen MCP-API-Schlüssel und fertig. Kein Docker, kein
git clone, kein lokaler Server.
Grupo Éxito Marketplace + Gemini
Lass deine KI deinen exito.com-Marketplace-Shop in Kolumbien über die Verkäufer-API von Grupo Éxito betreiben: Liste deine Produkte und ihren Freigabestatus auf, erstelle Produkte mit Bildern, Beschreibungen und Attributen, lege Preise und Bestand fest und lies Bestellungen und Auszahlungsabrechnungen aus.
Voraussetzungen
Die vollständige Einrichtungsanleitung ist im Connector enthalten (sichtbar im In-App-Store, wenn du den Connector auswählst). Die erforderlichen Umgebungsvariablen für diesen Connector sind:
EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Schritt 1 — Zugangsdaten besorgen
Die Einrichtung dauert etwa 10 Minuten, sobald Éxito dir API-Zugang gewährt hat. Mit diesem Zugang schickt dir Éxito Anweisungen zur Authentifizierung: einen Benutzernamen, ein Passwort, einen API-Schlüssel und die Adresse, die das Token ausstellt. Außerdem brauchst du deine numerische Seller-ID.
Es gibt keine Sandbox: Éxito dokumentiert keine, daher wirkt jeder Aufruf, auch Schreibzugriffe, auf deinen Live-Shop.
- Füge den API-Benutzer (eine E-Mail-Adresse) in
EXITO_USERNAMEund das API-Passwort inEXITO_PASSWORDein, beides aus den Anweisungen von Éxito. - Füge den
x-api-keyaus denselben Anweisungen inEXITO_API_KEYein. - Füge die vollständige
https://-Adresse der Token-Anfrage inEXITO_LOGIN_URLein. Sie ist auf developers.exito.com nicht veröffentlicht, also kopiere sie aus dem Dokument, das Éxito dir geschickt hat. - Trage deine numerische Seller-ID (idSeller, z. B.
11795) inEXITO_SELLER_IDein.exito_marketplace_get_bulk_upload_statuszeigt sie ebenfalls alsdata.idSelleran. - Installiere den Connector. Führe
exito_marketplace_list_categoriesaus, um die Verbindung zu prüfen.
So funktioniert die Anmeldung: Der Connector fordert bei der Token-Adresse mit deinem Benutzernamen, deinem Passwort und deinem API-Schlüssel ein Token an und sendet es bei jedem Aufruf zusammen mit dem API-Schlüssel mit. Tokens werden automatisch erneuert, spätestens jede Stunde. Das Passwort und der Schlüssel werden verschlüsselt gespeichert und der KI nie angezeigt.
Cloud und self-hosted funktionieren gleich: Die Zugangsdaten sind dieselben, und es muss keine Redirect-URL festgelegt werden.
Der Verkauf bei Éxito läuft asynchron ab:
- Wähle mit
exito_marketplace_list_categoriesdie spezifischste Kategorie aus und lies mitexito_marketplace_get_category_featuresihre Spezifikationen aus. Erforderliche Spezifikationen müssen gesendet werden; eine Spezifikation mit einer Werteliste akzeptiert nur diese Werte. - Erstelle Produkte mit
exito_marketplace_create_products, bis zu 400 EANs pro Aufruf. Bilder sind öffentliche URLs mit 1000x1000 px (733x1000 px bei Bekleidung). Die Marke muss bei Éxito bereits existieren; fehlt sie, legt dein Éxito-Account-Manager sie an. - Verfolge den Batch mit
exito_marketplace_get_bulk_upload_status. Solange ein Batch startet oder verarbeitet wird, wird kein neuer akzeptiert. - Das Content-Team von Éxito prüft jedes Produkt.
exito_marketplace_get_products_waitinglistet die Produkte in Prüfung auf,exito_marketplace_get_products_rejecteddie abgelehnten samt Begründung undexito_marketplace_get_products_pending_seller_approvaldiejenigen, die sich vom gleichen, bereits im Marketplace vorhandenen Produkt unterscheiden. Nach der Freigabe dauert es bis zu eine Stunde, bis ein Produkt ein Angebot erhalten kann. - Gib freigegebenen Produkten mit
exito_marketplace_upsert_offersoder, für eine einzelne EAN, mitexito_marketplace_update_offer_price_stockeinen Preis und einen Bestand.exito_marketplace_load_products_and_offerssendet Produkte und Angebote in einer Anfrage. Angebote erscheinen innerhalb von etwa 4 Stunden auf den Seiten.
Preise und Bestand: Preise sind ganze kolumbianische Pesos über 8000, ohne Trennzeichen (45000). Ein Aktionspreis muss niedriger als der Preis sein. Um nur den Preis zu ändern, sende den aktuellen Bestand mit IsUpdatedStock 0. Eine Preisänderung von mehr als 30 % kommt mit dem Code PEX zurück und muss mit Preisfreigabe erneut gesendet werden: Die KI fragt dich, bevor sie das tut. Um den Verkauf eines Produkts zu beenden, setze seinen Bestand auf 0: Die API hat kein Löschen.
Bestellungen und Auszahlungen: exito_marketplace_get_orders listet Bestellungen von exito.com, carulla.com und den weiteren Seiten von Éxito mit Status, Summen, Provision und Lieferart auf. exito_marketplace_get_bills listet Auszahlungsabrechnungen auf. Listen werden mit paginationToken seitenweise abgerufen.
Bei der Installation deaktiviert: exito_marketplace_set_order_tracking (Produkte einer Bestellung als versendet markieren, mit Versanddienstleister und Sendungsnummer) und exito_marketplace_upload_order_invoice (die Rechnung an eine Bestellung anhängen). Aktiviere sie auf der Connector-Seite, wenn die KI Bestellungen bearbeiten soll; die KI bittet dich, jeden Aufruf zu bestätigen. Das Erstellen von Produkten sowie das Festlegen von Preisen und Bestand ist aktiviert (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Lies jede Antwort: Batch-Schreibvorgänge antworten mit HTTP 200 und einer Meldung pro abgelehnter EAN, ein 200 bedeutet also nicht, dass jedes Produkt oder Angebot akzeptiert wurde. Anfragen und Antworten sind auf Spanisch.
Nicht abgedeckt: Versandetiketten, die Moderations- und Angebotsbenachrichtigungen von Éxito sowie alles, was die Seller-Center-Webanwendung kann, die API aber nicht anbietet.
Häufige Fehler: Wird kein Token ausgestellt, prüfe Benutzernamen, Passwort und API-Schlüssel anhand der Anweisungen von Éxito und ob EXITO_LOGIN_URL die Token-Adresse aus diesem Dokument ist. 401 bedeutet, dass das Token abgelehnt wurde. 403 bedeutet meist, dass der API-Schlüssel fehlt oder falsch ist oder die API für deinen Benutzer nicht aktiviert ist: Frage Éxito, welche APIs dein Zugang abdeckt.
Schritt 2 — Den Adapter installieren
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Schritt 3 — Den Connector in Gemini hinzufügen
Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (
https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese AnleitungYOUR_SERVER_IDzeigt.
Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von
YOUR_MCP_API_KEYein. - Speichere die Datei und starte
geminineu. - Führe in der Gemini CLI
/mcpaus (odergemini mcp listim Terminal) —anythingmcpsollte als verbunden erscheinen. - Leg los: Gemini CLI kann jetzt die
Grupo Éxito Marketplace-Tools aufrufen.
Verfügbare Tools
| Tool | Was es tut |
|---|---|
exito_marketplace_get_products | Listet die Produkte des Verkäufers im Éxito-Marketplace mit Name, EAN, VTEX PLU, Bild, Erstellungs- und Aktualisierungsdatum, Preis, Aktionspreis, Bestand… auf |
exito_marketplace_get_products_waiting | Produkte, die auf die Freigabe durch das Content-Team von Éxito warten (Moderation), mit EAN, Name, Bild, Verarbeitungsdatum und Parent-Referenz |
exito_marketplace_get_products_rejected | Produkte, die das Content-Team von Éxito abgelehnt hat und die korrigiert werden müssen, mit EAN, Name, Bild sowie Reason und Comment der Ablehnung |
exito_marketplace_get_products_pending_seller_approval | Produkte, die deine Entscheidung brauchen, weil sie sich vom gleichen, bereits im Marketplace vorhandenen Produkt unterscheiden: Jede Zeile enthält oldProduct und… |
exito_marketplace_get_bulk_upload_status | Status deines letzten Batches zur Produkterstellung (exito_marketplace_create_products). data.status: 4 startet, 1 wird verarbeitet, 2 abgeschlossen… |
exito_marketplace_list_categories | Alle Kategorien des Éxito-Marketplace mit Id, IdParent, Name und ProductType (Technology oder Clothing) |
exito_marketplace_get_category | Eine Kategorie nach ID: Id, IdParent, Name und ProductType |
exito_marketplace_get_category_features | Spezifikationsgruppen einer Kategorie: für jede Spezifikation ihr specName, Label, ob sie erforderlich ist, und ihre erlaubten Werte (values[].label; ein… |
exito_marketplace_get_orders | Über die Seiten von Éxito (exito.com, carulla.com und weitere) eingegangene Bestellungen mit Bestellnummer, Kanal, Datum, Status, Summen, Provision… |
exito_marketplace_get_bills | Auszahlungsabrechnungen (Billing) des Verkäufers: Abrechnungsnummer, Bestellnummer, Zahlungsauftrag, Konzept, Zahlungsdatum, Provision, Summe, IVA und… |
exito_marketplace_create_products | Erstellt Produkte (oder ändert bestehende: sende dieselbe EAN erneut; ModifyImage "1" ersetzt die Bilder) mit Titel, HTML-Beschreibung… |
exito_marketplace_load_products_and_offers | Sendet Produkte zusammen mit ihren Angeboten in einer Anfrage: Jedes Element hat ein Product (die Felder von exito_marketplace_create_products) und ein… |
exito_marketplace_upsert_offers | Erstellt oder aktualisiert Angebote (Preis, Aktionspreis, Bestand, Versand und Lieferversprechen) für EANs, die Éxito bereits freigegeben hat, auf allen Éxito-Seiten… |
exito_marketplace_update_offer_price_stock | Ändert Preis und/oder Bestand eines bestehenden Angebots (eine EAN). Éxito braucht bei jeder Aktualisierung EAN, Stock und Price: Um nur den Preis zu ändern… |
exito_marketplace_set_order_tracking | Markiert Produkte einer Bestellung als versendet, mit Versanddienstleister und Sendungsnummer (Bestellungen mit Standardlieferung) |
exito_marketplace_upload_order_invoice | Hängt die Rechnung einer Bestellung als Base64-PDF oder ZIP an |
Beispiel-Prompts
- „Welche meiner Produkte hat Éxito abgelehnt, und warum?"
- „Zeig mir die mir diese Woche zugewiesenen Bestellungen, die noch versendet werden müssen."
- „Wie hoch sind Preis und Bestand der EAN 7701234567890 auf exito.com?"
- „Setze den Bestand der EAN 7701234567890 auf 25 Einheiten und behalte den Preis bei."
- „Summiere die Provision in meinen Auszahlungsabrechnungen für Oktober."
FAQ
Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.
Nächste Schritte
War dieser Guide hilfreich?