@theyahia/wildberries-mcp

Wildberries Seller API MCP server. 15 tools. Production-grade rate limiting with 409 penalty protection.

Features

• 15 tools covering products, prices, stocks, orders, sales, warehouses, supplies, statistics, feedbacks, and ABC analysis
• Production-grade rate limiter: token bucket (300 req/min), 200ms minimum interval, automatic 409 penalty handling
• 409 penalty protection: parses X-Ratelimit-Remaining and X-Ratelimit-Retry-After headers, waits the required duration
• Streamable HTTP transport (--http flag) for web deployments
• Bearer JWT auth (180-day validity tokens)

Quick Start

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

Configuration

Claude Desktop

Add to claude_desktop_config.json:

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

Smithery

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

Auth

Authorization: Bearer {WB_API_TOKEN} (JWT, 180-day validity).

Get your token at: https://seller.wildberries.ru/supplier-settings/access-to-api

Tools (15)

Tool	Method	Endpoint
list_products	POST	/content/v2/get/cards/list
get_product	POST	/content/v2/get/cards/detail
update_prices	POST	/api/v2/upload/task
update_stocks	PUT	/api/v3/stocks/{warehouseId}
get_stocks	POST	/api/v3/stocks/{warehouseId}
get_orders	GET	/api/v3/orders
get_new_orders	GET	/api/v3/orders/new
get_sales	GET	/api/v1/supplier/sales
get_warehouses	GET	/api/v3/offices
get_supply	GET	/api/v3/supplies
create_supply	POST	/api/v3/supplies
get_statistics	GET	/api/v1/supplier/reportDetailByPeriod
get_feedbacks	GET	/api/v1/feedbacks
reply_feedback	PATCH	/api/v1/feedbacks
get_abc_analysis	GET	/api/v1/supplier/reportDetailByPeriod (computed)

Rate Limiting

Wildberries enforces strict rate limits with penalties:

• 300 requests per minute (token bucket)
• 200ms minimum interval between requests
• HTTP 409 = PENALTY: 5-10 tokens deducted from your bucket
  • Server reads X-Ratelimit-Retry-After header and waits the specified duration
  • Server reads X-Ratelimit-Remaining to sync token count
  • All throttling activity is logged to stderr

The rate limiter is built into the client -- no configuration needed.

Development

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

License

MIT