# Wildberries MCP (RU)

Wildberries MCP (RU) is an MCP server for Claude Code that connects an assistant to Wildberries’ API. Ask it about sales, inventory, product listings, prices, or financial reports.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: ilyautov
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ilyautov/wildberries-mcp-ru
- Updated: 2026-09-14
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/wildberries-mcp-ru

## What it does

The server sends requests to Wildberries’ API and brings back information on sales, stock, product cards, pricing, promotions, reviews, and finance. Its catalog contains 307 methods. Some read data, others write it, and 12 perform irreversible actions.

Running it requires `uvx` and a `WB_API_TOKEN` with access to the requested API categories. The token goes in the `Authorization` header without a `Bearer` prefix. A selected cabinet in `~/.marketplace-mcp/cabinets.json` takes precedence over environment variables. This package connects to Wildberries alone; it does not bundle other marketplaces.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `WB_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add wildberries-mcp-ru -e WB_API_TOKEN=<WB_API_TOKEN> -- uvx wildberries-mcp-ru
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from wildberries-mcp-ru <command>

### Codex

**Platform CLI**
```bash
codex mcp add wildberries-mcp-ru --env WB_API_TOKEN=<WB_API_TOKEN> -- uvx wildberries-mcp-ru
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from wildberries-mcp-ru <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "wildberries-mcp-ru": {
            "command": "uvx",
            "args": [
                "wildberries-mcp-ru"
            ],
            "env": {
                "WB_API_TOKEN": "<WB_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from wildberries-mcp-ru <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "wildberries-mcp-ru": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "wildberries-mcp-ru"
            ],
            "env": {
                "WB_API_TOKEN": "<WB_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from wildberries-mcp-ru <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e WB_API_TOKEN=<WB_API_TOKEN> wildberries-mcp-ru uvx wildberries-mcp-ru
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from wildberries-mcp-ru <command>

## When to use it
- retrieve Wildberries sales and stock figures
- spot products at risk of going out of stock
- prepare a financial sales report
- check product prices and promotion participation
- retrieve buyer reviews and questions

## Example prompts
- Show Wildberries sales and stock for the past week.
- Find products that may soon run out of stock.
- Prepare the financial sales report for last month.

## Similar
- [Marketplaces MCP (RU) — Wildberries, Ozon, Yandex Market, Avito](https://affpapa.org/en/nevibecode/mcp/marketplaces-mcp-ru-wildberries-ozon-yandex-market-avito.md) — MCP server · ★ 63 repo stars
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
