SHEIN Seller MCP-Server für Bestellungen und Lager

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Melde dich an, klicke auf Connectors → SHEIN Seller, füge die App-ID und das App-Secret ein, klicke auf Authorize with Provider und genehmige mit dem Hauptkonto des Shops auf SHEIN, erstelle einen MCP API-Schlüssel und du bist fertig. Kein Docker, kein git clone, kein lokaler Server.

SHEIN Seller

Lass deine KI mit deinem SHEIN Verkäufer-Shop arbeiten: Bestellungen, Käuferadresse und Tracking-Upload, Paketverfolgung, Produkte mit Preisen und Lagerbestand, Lager- und Preisaktualisierungen, Kategorien und Attribute, After-Sales-Fälle und Rücksendungen.

Einrichtung

Was du benötigst: ein SHEIN Open Platform Entwicklerkonto vom Typ Seller Self-Developed (verifiziert mit den Händlerinformationen des Shops), eine genehmigte App des Kooperationsmodus des Shops und das Hauptkonto des Shops zur Genehmigung. Etwa 20 Minuten Arbeit, plus die Überprüfungen von SHEIN für das Konto und die App.

1. Registriere dich unter https://open.sheincorp.com, wähle den Entwicklertyp Seller Self-Developed und reiche die angeforderten Händlerinformationen ein (alle sind im Verkäufer-Backend zu finden). Der Typ kann nach der Genehmigung nicht mehr geändert werden.
2. Öffne in der Konsole Anwendungsmanagement und erstelle eine Anwendung. Wähle den Anwendungstyp des Kooperationsmodus des Shops: Self-Operated oder Semi-Managed für einen Marketplace-Shop (ein Shop in mehreren Modi benötigt eine App pro Modus). Name, Icon und Beschreibung werden den Verkäufern angezeigt und können nach der Einreichung nicht mehr bearbeitet werden. SHEIN überprüft die App; bis sie genehmigt ist, gibt es keine gültige App-ID oder App-Secret.
3. Überprüfe auf der Detailseite der App das API-Berechtigungspaket: die Bestell-, Produkt-, Lager-, After-Sales- und Rücksendungs-APIs müssen abonniert sein (in der Regel mit der Genehmigung gewährt; andernfalls klicke auf Berechtigungsantrag stellen). Füge die ausgehende IP-Adresse dieses Servers zur IP-Whitelist der App hinzu: SHEIN lehnt Produktionsaufrufe von jeder anderen Adresse ab (openapi00002). Auf AnythingMCP Cloud zeigt die Einrichtungsseite die Adresse an.
4. Kopiere die App-ID in SHEIN_APP_ID und das App-Secret in SHEIN_APP_SECRET, und wähle die API-Adresse für SHEIN_API_HOST: https://openapi.sheincorp.com für selbstbetriebene und semi-verwalte Apps, https://openapi.sheincorp.cn für vollständig verwaltete, SHEIN-betriebene und andere Apps.
5. Installiere den Connector und klicke auf Authorize with Provider (der letzte Schritt des Einrichtungsleitfadens erledigt das). Die Seite von SHEIN öffnet sich: melde dich mit dem Hauptkonto des Shops im Verkäufer-Backend an und klicke auf die Genehmigungsschaltfläche. SHEIN sendet den Browser zurück zu <SERVER_URL>/api/shein-auth/callback (auf AnythingMCP Cloud: https://cloud.anythingmcp.com/api/shein-auth/callback) und der Connector holt den Schlüssel des Shops innerhalb der 10 Minuten, die SHEIN erlaubt.

Der Shop-Schlüssel: SHEIN übergibt die openKeyId und secretKey des Shops (der secretKey ist mit dem App Secret verschlüsselt, das AnythingMCP einmal entschlüsselt); beide werden verschlüsselt im Connector gespeichert. SHEIN dokumentiert keine Lebensdauer und keine Erneuerung dafür. Eine Autorisierung endet, wenn der Verkäufer die App entbindet oder den Schlüssel zurücksetzt, der Shop geschlossen wird, SHEIN ihn zurücksetzt oder entbindet, oder er abläuft: Aufrufe schlagen dann mit openapi00004 fehl ("Der Benutzer ist abgelaufen"), der Connector zeigt an, dass er eine neue Autorisierung benötigt, und jemand klickt erneut auf Authorize with Provider.

Wie es signiert: jeder Aufruf trägt x-lt-openKeyId, x-lt-timestamp (Unix-Millisekunden) und x-lt-signature: fünf zufällige Zeichen gefolgt von der Base64 des kleingeschriebenen hex HMAC-SHA256 von openKeyId&timestamp&path, verschlüsselt mit dem secretKey plus diesen fünf Zeichen. Die Abfrage ist nicht signiert. Ein Zeitstempel ist 5 Minuten gültig, daher muss die Serveruhr richtig sein.

Wo du anfangen kannst: shein_get_store_info überprüft die Autorisierung und benennt den Shop; shein_list_sites gibt die Standortcodes und Währungen an.

• Bestellungen: shein_list_orders (ein Zeitfenster von maximal 48 Stunden ist obligatorisch), dann shein_get_orders für bis zu 30 auf einmal. Nur Bestellungen mit stockMode 3 werden vom Verkäufer versendet; printOrderStatus 1 bedeutet, dass die Bestellung jetzt bearbeitet werden kann.
• Selbstversand: shein_get_order_address (handle_type 2 verschiebt auch die Bestellung zum Versand), shein_list_warehouse_addresses, shein_list_shipping_channels, dann shein_upload_tracking_numbers pro Stück (goodsId). shein_get_logistics_track verfolgt das Paket. SHEIN markiert die Bestellung als versendet, wenn der Carrier sie scannt. shein_confirm_out_of_stock ist bei der Installation deaktiviert.
• Produkte: shein_search_products (Codes, Regalstatus, Preise, Lagerbestand und Kampagnen-Sperren), shein_list_products (alle Codes), shein_get_product (ein SPU vollständig). Für neue Angebote: shein_get_category_tree, shein_get_attribute_templates, shein_list_brands. shein_set_skc_shelf_status ist bei der Installation deaktiviert.
• Lager und Preise: shein_list_warehouses, shein_get_stock, shein_update_stock (mit einem Idempotenzschlüssel pro Zeile), shein_update_prices (Preiserhöhungen können auf die Preisüberprüfung von SHEIN warten). shein_get_sku_sales gibt verkaufte Einheiten für verwaltete Shops an.
• After Sales: shein_list_after_sales_orders und shein_get_after_sales_orders, shein_list_return_orders und shein_get_return_orders nur lesen; shein_sign_return_order ist bei der Installation deaktiviert.

Codes, Zeiten und Beträge: SPU-, SKC- und SKU-Codes (spuName, skcName, skuCode) sind von SHEIN; supplierCode und supplierSku sind die eigenen des Verkäufers. Ein SKU, der mehrere Male verkauft wird, hat eine goodsId pro Stück, und Tracking-Nummern, Stornierungen und Rücksendebelege funktionieren pro goodsId. goodsId-Werte sind 64-Bit-Zahlen: der Connector liest jede ID, die zu lang für eine JavaScript-Zahl ist, als Text mit ihren genauen Ziffern, und die Tools nehmen IDs als Text und senden sie als Zahlen an SHEIN, also kopiere sie genau so, wie sie eine Bestellung oder Rücksendung zeigt. Bestell-, After-Sales- und Rücksendefenster sind Pekinger Zeit (UTC+8) als yyyy-MM-dd HH:mm:ss; Bestelldetails antworten mit yyyy-MM-dd'T'HH:mm:ss.SSSZ, Tracking-Ereignisse mit Unix-Millisekunden. Beträge sind Dezimalzahlen in der Währung, die neben ihnen genannt wird (orderCurrency, currency, currencyCode).

Limits: jede API hat ihr eigenes Limit für Aufrufe pro Sekunde pro App (20 für Produktsuche, 30 bis 300 für die anderen), beantwortet mit openapi00006 oder 832213, wenn überschritten. Bestell- und Rücksendelisten paginieren nach 30, Produktsuchen nach 10; ein Bestellfenster gibt maximal 10.000 Bestellungen zurück, die Produktliste maximal 50.000 Codes. Der gleiche SKC und Standort können den Regalstatus einmal alle 20 Minuten ändern.

Antworten und Fehler: SHEIN antwortet mit code "0" und dem Ergebnis in info; jeder andere code ist ein Fehler mit msg und einer traceId, die innerhalb von drei Tagen an den SHEIN-Support zitiert werden muss. Der Connector fordert englische Nachrichten an (language: en). openapi00001: die Signatur wurde abgelehnt; bei einer korrekten Serveruhr bedeutet dies, dass sich der Shop-Schlüssel geändert hat (erneut autorisiert oder woanders zurückgesetzt), also autorisiere erneut. openapi00002: die IP-Adresse dieses Servers ist nicht auf der Whitelist der App. openapi00003: die App hat keine Berechtigung für diese API, die API ist nicht für den Modus des Shops oder das Entwicklerkonto ist deaktiviert. openapi00004: die Autorisierung ist abgelaufen; autorisiere erneut. Schreibaufrufe, die eine Liste benötigen, antworten mit code 0 und benennen die abgelehnten Zeilen (failedList, failure_results oder info).

Voraussetzungen: SHEIN_API_HOST, SHEIN_APP_ID, SHEIN_APP_SECRET

Installiere den Connector lokal

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

Öffne http://localhost:3000/connectors/store, wähle SHEIN Seller und füge die unter Voraussetzungen aufgeführten Umgebungsvariablen ein.

Verfügbare Tools

Beispielaufforderungen

• "Welche SHEIN-Bestellungen aus den letzten 24 Stunden kann ich jetzt bearbeiten?"
• "Lade die UPS-Tracking-Nummer 1Z999AA10123456784 für beide Stücke der Bestellung GSH12345678901 hoch."
• "Welche meiner SKUs haben weniger als 10 Einheiten auf Lager?"
• "Setze den Lagerbestand des SKU-Codes I8xk2m4p0q in meinem Hauptlager auf 60."
• "Welche Rücksendebestellungen und After-Sales-Fälle sind diese Woche eingegangen, und was sagen die Käufer?"

Nächste Schritte

• Verbinde dich mit Claude
• Verbinde dich mit ChatGPT