🗄 Repository archiviert

Die Entwicklung ist umgezogen nach theYahia/WWmcp — ein Monorepo von MCP-Servern für nicht-westliche APIs: GUS, MENA, Afrika, LATAM, Südostasien. Gemeinsamer Kern @theyahia/mcp-core, einheitliche CI, einheitliche Release-Pipeline.

Die aktuelle Version dessen, was hier lag: servers/wildberries/

Das npm-Paket ist dasselbe — @theyahia/wildberries-mcp, Installation und Funktion wie zuvor. Hier wird nichts mehr aktualisiert. Issues und Pull Requests — in WWmcp.

Archiviert — die Entwicklung ist zu theYahia/WWmcp umgezogen, einem Monorepo von MCP-Servern für nicht-westliche APIs. Die aktuelle Version dieses Pakets befindet sich jetzt unter servers/wildberries/. Das npm-Paket @theyahia/wildberries-mcp ist unverändert. Bitte öffnen Sie Issues und Pull Requests dort.

@theyahia/wildberries-mcp

MCP-Server für die Wildberries-Verkäufer-API — 30 Tools für Produkte, Preise, Bestände, Bestellungen, Verkäufe, FBS-Lieferungen, Analysen, Bewertungen, Fragen, Retouren und Werbung. Host-Routing pro Kategorie mit Ratenbegrenzung und 409-Strafschutz. Stdio- und Streamable-HTTP-Transporte.

Related MCP server: Wildberries MCP Server

Schnellstart

npm install -g @theyahia/wildberries-mcp

# stdio transport (for Claude Desktop, Cursor, etc.)
WB_API_TOKEN=your_token wildberries-mcp

# Streamable HTTP transport
WB_API_TOKEN=your_token wildberries-mcp --http

Claude Desktop

Fügen Sie zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "wildberries": {
      "command": "npx",
      "args": ["-y", "@theyahia/wildberries-mcp"],
      "env": { "WB_API_TOKEN": "your_token_here" }
    }
  }
}

Cursor / Windsurf / VS Code (Copilot) verwenden denselben mcpServers-Block in ihren MCP-Einstellungen.

Smithery

npx @smithery/cli install @theyahia/wildberries-mcp

Authentifizierung & Token-Bereiche

Authorization: Bearer {WB_API_TOKEN} (JWT, 180 Tage gültig). Holen Sie sich Ihr Token im Verkäuferportal unter Einstellungen → Zugriff auf die API.

Ein einzelnes Token kann mehrere Kategorie-Bereiche tragen. Da jedes Tool mit einem anderen API-Host kommuniziert, gibt ein Token ohne den erforderlichen Bereich 401 von diesem Host zurück, während andere Tools weiter funktionieren. Aktivieren Sie die Bereiche, die Sie benötigen:

Wenn ein Aufruf fehlschlägt, nennt die Fehlermeldung den Host und enthält die requestId von WB, sodass ein fehlender Bereich oder ein Problem mit dem falschen Host offensichtlich ist (z. B. WB API GET advert-api.wildberries.ru/adv/v1/balance → 401: ...).

Architektur — Hosts pro Kategorie

Die Wildberries-Verkäufer-API ist kein einzelnes Gateway. seller.wildberries.ru ist das Web- Cabinet; die API ist auf Kategorie-Hosts verteilt. Jede Anfrage wird an den richtigen Host weitergeleitet:

Tools (30)

Produkte & Inhalt

Bestellungen & Verkäufe

Lager & FBS-Lieferungen

Analysen

Preisreferenz

Bewertungen & Fragen

Retouren & Werbung

Ratenbegrenzung

Wildberries misst Anfragen pro API-Kategorie, nicht als einen globalen Pool — und gibt 409 als Strafe für Bursts zurück. Der Client hält einen Token-Bucket-Limiter pro Host sowie feinere Buckets für die strengsten Endpoints:

• Token-Buckets pro Host mit einem Mindestintervall zwischen Anfragen.

• 409-Strafbehandlung: liest X-Ratelimit-Retry-After / X-Ratelimit-Remaining, zieht Straf-Token ab und wartet die angegebene Dauer, bevor erneut versucht wird — Strafen bleiben auf die verursachende Kategorie isoliert.

• Strenge Limits pro Endpoint (paid-storage create/download 1/min, status 1/5s; prices ~10/6s).

Die Standardwerte sind bewusst konservativ und können sicher erhöht werden, sobald Sie die tatsächlichen Limits Ihres Kontos beobachtet haben. Keine Konfiguration erforderlich.

Konfiguration

HTTP-Endpoints (--http): POST /mcp (Anfragen), GET /health ({ status, version, tools }).

Demo-Aufforderungen

„Liste die ersten 50 Produkte in meinem Katalog mit aktuellen Preisen auf." „Führe eine ABC-Analyse für die letzten 30 Tage durch — welche Produkte machen 80 % des Umsatzes aus?" „Erstelle eine FBS-Lieferung ‚Morning 2026-06-23', füge die Bestellungen 1001 und 1002 hinzu, schließe sie dann für die Lieferung ab und hole ihren Barcode." „Zeige unbeantwortete Fragen und entwirf eine Antwort auf die erste." „Wie hoch ist mein Werbeguthaben und welche Kampagnen sind aktiv?"

Entwicklung

git clone https://github.com/theYahia/wildberries-mcp.git
cd wildberries-mcp
npm install
npm run build
npm test

Lizenz

MIT — siehe LICENSE.