wb-mcp-server

Русская версия

MCP server for the Wildberries Seller API. Connect any AI agent (Claude Desktop, OpenClaw, or any MCP client) to your Wildberries store.

Quick Start

1. Install

npm install -g wb-mcp-server

2. Get a WB API token

Create an API token in your WB Seller Dashboard under Settings > API Access.

3. Add to Claude Desktop config

{
  "mcpServers": {
    "wildberries": {
      "command": "wb-mcp-server",
      "env": {
        "WB_API_TOKEN": "your_token_here"
      }
    }
  }
}

Windows: spawn wb-mcp-server ENOENT error

If Claude Desktop can't find the wb-mcp-server command, use npx instead:

{
  "mcpServers": {
    "wildberries": {
      "command": "npx",
      "args": ["-y", "wb-mcp-server"],
      "env": {
        "WB_API_TOKEN": "your_token_here"
      }
    }
  }
}

This commonly happens with the Microsoft Store version of Claude Desktop, which doesn't see the global npm packages path.

Available Tools (18)

Reviews & Questions

Tool	Description	Type
get_feedbacks	Get customer reviews	read
reply_feedback	Reply to a review	write
get_questions	Get customer questions	read
reply_question	Reply to a question	write
get_unanswered_count	Count of unanswered reviews	read

Statistics & Analytics

Tool	Description	Type
get_stocks	Warehouse stock levels	read
get_orders	Recent orders	read
get_sales	Sales data	read
get_financial_report	Detailed report: commissions, logistics, storage, penalties	read
get_nm_report	Per-product report (views, cart, orders, buyouts)	read
get_warehouses_inventory	Real-time warehouse inventory report (async)	read

Advertising

Tool	Description	Type
get_advert_list	Advertising campaigns list	read
get_advert_stats	Campaign statistics	read
get_advert_balance	Advertising account balance	read
update_advert_bid	Update campaign bids	write

Pricing

Tool	Description	Type
get_prices	Product list with prices and discounts	read
update_prices	Update prices and discounts	write

Finance

Tool	Description	Type
get_seller_balance	Current seller account balance	read

Configuration

Variable	Description	Required
WB_API_TOKEN	Wildberries Seller API token	Yes

Or pass via CLI: wb-mcp-server --token=your_token

Development

git clone https://github.com/dmitriykosik74-rgb/wb-mcp-server.git
cd wb-mcp-server
npm install
npm test
npm run build

Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m 'feat: add my feature')
4. Push and create a Pull Request

License

MIT