# Wildberries MCP

> Подключить Wildberries к ИИ-ассистенту и работать с кабинетом продавца прямо из чата. Ставит MCP-сервер `wildberries-mcp-ru`: 307 методов официального API, каталог ищется обычными словами, у каждого метода класс доступа, запись требует подтверждения. Используй, когда человек хочет автоматизировать работу с кабинетом, собрать аналитику по продажам или разобраться с API. Триггеры: «подключи wildberries», «api wildberries», «вб через api», «выгрузи продажи с вб», «остатки на wildberries», «карточки wb», «wildberries mcp».

- Skill: `ilyautov/wildberries-mcp` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ilyautov/wildberries-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ilyautov/wildberries-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: ilyautov (https://skillmd.com/u/ilyautov)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ilyautov/wildberries-mcp

---


# Wildberries через MCP

Ставит сервер `wildberries-mcp-ru`: 307 методов официального API
(чтение 187, запись 108, необратимое 12). Каталог методов лежит в YAML и
исполняется сервером, поэтому агент получает несколько универсальных
инструментов, а не по отдельной функции на каждый метод.

## Установка

Пакет на PyPI, поэтому строка одна:

```bash
uvx wildberries-mcp-ru
```

Если нужна ветка `main`, а не релиз:

```bash
uvx --from git+https://github.com/ilyautov/wildberries-mcp-ru wildberries-mcp-ru
```

Конфигурация клиента (Claude Desktop, Cursor, Claude Code):

```json
{
  "mcpServers": {
    "wb": {
      "command": "uvx",
      "args": ["wildberries-mcp-ru"],
      "env": {
        "WB_API_TOKEN": "<значение>"
      }
    }
  }
}
```

## Где взять ключи

- `WB_API_TOKEN`: Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.

Второй путь, без переменных окружения: поднять сервер и вызвать
`wb_add_cabinet`. Ключи лягут в `~/.marketplace-mcp/cabinets.json`
с правами 600 и с машины не уходят. Так же подключается второй магазин.

## Что спрашивать у сервера

- `wb_search_methods("остатки по складам")`: поиск метода словами.
- `wb_describe_method(...)`: параметры, пагинация, класс доступа.
- `wb_call_method(...)`: вызов. Чтение идёт сразу, запись просит
  подтверждения, необратимое просит дважды.
- `wb_check_auth`: проверить, что ключи дошли.

## Как себя вести

Сначала ищи метод каталогом, не угадывай имя. Перед записью покажи человеку,
что именно уйдёт в API, и дождись согласия: гейт сработает всё равно, но
человек должен увидеть тело запроса до, а не после.

Числа из ответа не округляй и не пересчитывай в уме. Если метод вернул
пустой список, так и скажи, вместо того чтобы объяснять это за продавца.

## Все четыре маркетплейса разом

Если нужны не только Wildberries, ставится комбайн `marketplaces-mcp-ru`:
Wildberries, Ozon, Яндекс Маркет и Авито в одном сервере.