MCP-сервер Wildberries Seller API
wildberries-mcp-ru
MCP-сервер под все семнадцать хостов Wildberries Seller API: продажи, остатки, карточки, цены, финотчеты и отзывы
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- 108 методов из 307 меняют данные: цены, скидки, поставки, карточки товаров
- Есть отправка сообщений в чат с покупателями от имени продавца
- 12 методов необратимы, начните с токена с правами только на чтение
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/wildberries-mcp-ruОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'WB_API_TOKEN=<ваш WB_API_TOKEN>' wildberries-mcp-ru -- uvx wildberries-mcp-ru==0.6.0Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"wildberries-mcp-ru","type":"stdio","command":"uvx","args":["wildberries-mcp-ru==0.6.0"],"env":{"WB_API_TOKEN":"<ваш WB_API_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"wildberries-mcp-ru": {
"type": "stdio",
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add wildberries-mcp-ru --env 'WB_API_TOKEN=<ваш WB_API_TOKEN>' -- uvx wildberries-mcp-ru==0.6.0Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.wildberries-mcp-ru]
command = "uvx"
args = ["wildberries-mcp-ru==0.6.0"]
env = { WB_API_TOKEN = "<ваш WB_API_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
gemini mcp add -s user -e 'WB_API_TOKEN=<ваш WB_API_TOKEN>' wildberries-mcp-ru uvx wildberries-mcp-ru==0.6.0Или добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"wildberries-mcp-ru": {
"type": "local",
"command": [
"uvx",
"wildberries-mcp-ru==0.6.0"
],
"environment": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"wildberries-mcp-ru": {
"command": "uvx",
"args": [
"wildberries-mcp-ru==0.6.0"
],
"env": {
"WB_API_TOKEN": "<ваш WB_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
WB_API_TOKENсекрет, обязательная- Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer.
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Установи сервер командой uvx wildberries-mcp-ru, добавь его в конфигурацию клиента с переменной WB_API_TOKEN из личного кабинета seller.wildberries.ru, раздел Доступ к API.
Другие способы из описания автора
uvx wildberries-mcp-ruУстановка релиза с PyPI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер устанавливается из PyPI и предоставляет агенту 307 методов Wildberries Seller API, разложенных по семнадцати доменам: сборочные задания и поставки, аналитика продавца, карточки товаров, реклама, цифровые товары, отзывы, цены и скидки, финансы, чат с покупателями, документы, возвраты. Из них 187 методов на чтение, 108 на запись и 12 необратимых. Токен и данные кабинетов сервер хранит локально в файле с правами 600, можно подключить несколько кабинетов и переключаться между ними прямо из чата. Ядро и каталог методов сервер получает зависимостью от пакета marketplaces-mcp-ru того же автора, а этот пакет ставит только Wildberries.
Для кого. Для продавцов и менеджеров, которые ведут магазин на Wildberries и хотят получить полный доступ к API продавца из чата с агентом.
Подходит, если
- Нужен полный охват Wildberries Seller API, а не отдельные функции
- Нужно вести несколько кабинетов продавца и переключаться между ними
- Нужны и чтение аналитики, и операции с ценами, поставками, карточками и отзывами
Не подходит, если
- Нужен доступ сразу к нескольким маркетплейсам: тогда ставится marketplaces-mcp-ru
- Нужен только просмотр без риска изменить цены, поставки или ответить покупателю
Пример запроса к агенту
Покажи продажи на Wildberries за неделю и какие товары рискуют уйти в out-of-stockОграничения
Нужен токен продавца Wildberries с нужными категориями доступа из личного кабинета. У методов Wildberries разные и местами очень жесткие лимиты запросов, некоторые ограничены одним обращением в минуту. Токен передается в заголовке Authorization без префикса Bearer, из-за чего при неверной настройке клиента возможна ложная ошибка 401. 12 методов необратимы.
Как отключить. Удалите сервер wb из конфигурации MCP клиента и файл ~/.marketplace-mcp/cabinets.json, если кабинеты больше не нужны.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| WB_API_TOKEN обязательная, секрет | Токен продавца из seller.wildberries.ru, Настройки, Доступ к API |
Проверка безопасности
- 108 методов из 307 меняют данные: цены, скидки, поставки, карточки товаров
- Есть отправка сообщений в чат с покупателями от имени продавца
- 12 методов необратимы, начните с токена с правами только на чтение
Коротко о README
README дает таблицу хостов Wildberries Seller API с числом методов на каждом, объясняет установку через uvx или npx skills add, формат хранения токенов и частые ошибки авторизации и лимитов. Отдельный раздел сравнивает пакет с marketplaces-mcp-ru и перечисляет соседние проекты автора: business-mcp-ru, moysklad-mcp-ru, humanizer-ru.
Частые вопросы
Чем этот пакет отличается от marketplaces-mcp-ru?
Только составом: этот ставит один Wildberries, marketplaces-mcp-ru сразу четыре маркетплейса на общем ядре.
Почему авторизация падает с верным токеном?
Частая причина: сервер шлет токен без префикса Bearer, либо активный кабинет в cabinets.json перекрывает переменные окружения.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма