{
  "markdown": "# mcp-server-wildberries\n\n[![Version](https://img.shields.io/badge/version-0.2.1-blue)](https://github.com/dontsovcmc/mcp-server-wildberries)\n\nmcp-name: io.github.dontsovcmc/wildberries\n\nMCP-сервер для **Wildberries Seller API** — товары, заказы, поставки, аналитика, реклама, финансы.\n\n235 действий, покрывающих все разделы [WB API](https://dev.wildberries.ru/).\n\nПостроен по [официальной документации Wildberries API](https://dev.wildberries.ru/swagger/general).\n\n## Архитектура\n\nСервер использует паттерн **search + execute** — вместо 235 отдельных инструментов предоставляет 3:\n\n| Инструмент | Описание |\n|------------|----------|\n| `wb_search` | Поиск действий по описанию на естественном языке |\n| `wb_execute` | Выполнение действия по ID |\n| `wb_execute_file` | Выполнение действия со скачиванием файла |\n\nЭто экономит токены в контексте LLM — схемы 3 инструментов вместо 235.\n\n### Как это работает\n\n```\nLLM: wb_search(\"cancel fbs order\")\n→ [{\"id\": \"fbs-order-cancel\", \"params_schema\": {\"order_id\": \"int\"}, ...}]\n\nLLM: wb_execute(\"fbs-order-cancel\", '{\"order_id\": 12345}')\n→ {\"status\": \"ok\"}\n```\n\n## Настройка\n\n### 1. Получите API-токен Wildberries\n\nОткройте [Личный кабинет продавца WB](https://seller.wildberries.ru/) → Настройки → Доступ к API → Создать токен.\n\n### 2. Установите и подключите\n\n#### macOS / Linux\n\nУстановка:\n```bash\npip install mcp-server-wildberries\n```\n\nПодключение к Claude Code (токен в командной строке):\n```bash\nclaude mcp add wildberries -e WB_TOKEN=ваш-токен -- mcp-server-wildberries\n```\n\nПодключение к Claude Code (токен из .env файла):\n```bash\nsource .env && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries\n```\n\nУдаление MCP-сервера:\n```bash\nclaude mcp remove wildberries\n```\n\nCLI без Claude (токен в командной строке):\n```bash\nWB_TOKEN=ваш-токен mcp-server-wildberries ping\n```\n\nCLI без Claude (токен из .env файла):\n```bash\nsource .env && mcp-server-wildberries ping\n```\n\n#### Windows\n\nУстановка:\n```cmd\npip install mcp-server-wildberries\n```\n\nПодключение к Claude Code (токен в командной строке):\n```cmd\nset WB_TOKEN=ваш-токен && claude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries\n```\n\nПодключение к Claude Code (токен из .env файла):\n```cmd\nfor /f \"tokens=1,2 delims==\" %a in (.env) do set %a=%b\nclaude mcp add wildberries -e WB_TOKEN -- mcp-server-wildberries\n```\n\nУдаление MCP-сервера:\n```cmd\nclaude mcp remove wildberries\n```\n\nCLI без Claude (токен в командной строке):\n```cmd\nset WB_TOKEN=ваш-токен && mcp-server-wildberries ping\n```\n\nCLI без Claude (токен из .env файла):\n```cmd\nfor /f \"tokens=1,2 delims==\" %a in (.env) do set %a=%b\nmcp-server-wildberries ping\n```\n\n#### Запуск через uvx (без установки)\n\nЕсли не хотите устанавливать пакет глобально, используйте `uvx` — он скачает и запустит автоматически:\n\n```bash\n# Подключение к Claude Code\nclaude mcp add wildberries -e WB_TOKEN=ваш-токен -- uvx mcp-server-wildberries\n\n# CLI\nWB_TOKEN=ваш-токен uvx mcp-server-wildberries ping\n```\n\n#### Запуск через --mcp-config (на одну сессию)\n\nПодключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном `.env.mcp` файле, а не в конфиге Claude.\n\nИз JSON-строки:\n```bash\nclaude --mcp-config '{\"wildberries\":{\"command\":\"bash\",\"args\":[\"-c\",\"source ~/.env.mcp && exec uvx mcp-server-wildberries\"]}}'\n```\n\nИз файла:\n```bash\nclaude --mcp-config ~/mcp-servers.json\n```\n\nТолько указанные серверы, без сохранённых:\n```bash\nclaude --strict-mcp-config --mcp-config ~/mcp-servers.json\n```\n\nПример `~/mcp-servers.json`:\n```json\n{\n  \"wildberries\": {\n    \"command\": \"bash\",\n    \"args\": [\"-c\", \"source ~/.env.mcp && exec uvx mcp-server-wildberries\"]\n  }\n}\n```\n\nПример `~/.env.mcp`:\n```\nWB_TOKEN=ваш-токен\n```\n\nПлюсы:\n- Токены в отдельном файле `.env.mcp`, а не в настройках Claude\n- Один файл `mcp-servers.json` на все проекты — легко делиться конфигом в команде\n- `--strict-mcp-config` — запуск с точным набором серверов, без лишних\n- Не засоряет глобальные настройки при экспериментах\n\nМинусы:\n- Сервер не сохраняется между сессиями — нужно указывать флаг при каждом запуске\n- Длинная команда запуска, если без файла\n\nПосле подключения перезапустите Claude Code.\n\n### Переменные окружения\n\n| Переменная | Обязательная | По умолчанию | Описание |\n|------------|--------------|--------------|----------|\n| `WB_TOKEN` | Да | — | API-токен Wildberries (JWT) |\n| `WB_TIMEOUT` | Нет | 30 | Таймаут HTTP-запросов к API (секунды) |\n| `WB_FILE_TIMEOUT` | Нет | 60 | Таймаут скачивания файлов (секунды) |\n\n## Доступные действия (235)\n\nВсе действия доступны через `wb_search` → `wb_execute`. Подробное описание каждого действия — в документации по разделам:\n\n| Домен | Кол-во | Описание |\n|-------|--------|----------|\n| [`general`](docs/general.md) | 9 | Ping, информация о продавце, пользователи |\n| [`content`](docs/content.md) | 18 | Категории, карточки товаров, теги, бренды |\n| [`fbs_orders`](docs/fbs_orders.md) | 31 | FBS-заказы, стикеры, поставки, пропуска, метаданные |\n| [`dbw_orders`](docs/dbw_orders.md) | 16 | DBW-заказы (доставка WB) |\n| [`dbs_orders`](docs/dbs_orders.md) | 20 | DBS-заказы (дропшиппинг) |\n| [`pickup_orders`](docs/pickup_orders.md) | 16 | Самовывоз (click & collect) |\n| [`fbw_supplies`](docs/fbw_supplies.md) | 7 | FBW-поставки на склад WB |\n| [`advertising`](docs/advertising.md) | 26 | Рекламные кампании, ставки, статистика |\n| [`communications`](docs/communications.md) | 22 | Вопросы, отзывы, чаты |\n| [`tariffs`](docs/tariffs.md) | 5 | Комиссии, тарифы на доставку |\n| [`analytics`](docs/analytics.md) | 17 | Воронка продаж, поисковые запросы, остатки |\n| [`reports`](docs/reports.md) | 24 | Заказы, продажи, остатки, маркировка |\n| [`finance`](docs/finance.md) | 12 | Баланс, отчёты, эквайринг, документы |\n| [`wbd`](docs/wbd.md) | 12 | Цифровые товары, ключи активации |\n\n### Примеры поиска\n\n```\nwb_search(\"новые заказы fbs\")\nwb_search(\"баланс\")\nwb_search(\"отзывы\", domain=\"communications\")\nwb_search(\"download report\", domain=\"reports\")\n```\n\n## CLI\n\n```bash\n# MCP-сервер (по умолчанию, без аргументов)\nmcp-server-wildberries\n\n# Все доступные команды\nmcp-server-wildberries --help\n\n# Справка по конкретной команде\nmcp-server-wildberries fbs-orders --help\n\n# Примеры команд\nmcp-server-wildberries ping\nmcp-server-wildberries seller-info\nmcp-server-wildberries fbs-orders-new\nmcp-server-wildberries tariff-commissions\nmcp-server-wildberries fbs-orders --date-from 2025-01-01 --limit 10\nmcp-server-wildberries advert-campaign-rename 12345 \"Новое название\"\nmcp-server-wildberries analytics-csv-download dl_abc report.csv\n\n# Версия\nmcp-server-wildberries --version\n```\n\n### Пример\n\n```bash\n$ WB_TOKEN=ваш-токен mcp-server-wildberries ping\n{\"TS\": \"2026-05-06T18:06:30Z\", \"Status\": \"OK\"}\n\n$ WB_TOKEN=ваш-токен mcp-server-wildberries seller-info\n{\"name\": \"ИП Иванов И.И.\", \"sid\": \"...\", \"tradeMark\": \"MyBrand\"}\n```\n\n## Pydantic-модели\n\nМодели параметров доступны как отдельная библиотека для использования в своих Python-программах:\n\n```bash\npip install mcp-server-wildberries\n```\n\n```python\nfrom mcp_server_wildberries.models import FbsOrdersParams, SubjectsListParams\n\nparams = FbsOrdersParams(date_from=\"2025-01-01\", limit=50)\n# params.model_dump() → {\"date_from\": \"2025-01-01\", \"date_to\": \"\", \"limit\": 50, ...}\n```\n\n62 Pydantic-модели покрывают параметры всех 235 действий. Полный список — в [`src/mcp_server_wildberries/models.py`](src/mcp_server_wildberries/models.py).\n\n## Разработка\n\n```bash\npip install -e \".[test]\"\nruff check src/ tests/\npytest tests/ -v\n```\n\n## Лицензия\n\nMIT\n",
  "bytes": 7514,
  "sha": "34d56ea56cf77a94df3093203b2281fa3bc34091c6b73df02f20a726ffe89dca",
  "repo_slug": "dontsovcmc/mcp-server-wildberries",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dontsovcmc_wildberries_8dfd2bcf/readme"
}