{"id":49877947,"url":"https://github.com/dontsovcmc/mcp-server-wildberries","last_synced_at":"2026-05-15T13:08:50.827Z","repository":{"id":354151392,"uuid":"1221932333","full_name":"dontsovcmc/mcp-server-wildberries","owner":"dontsovcmc","description":"MCP сервер маркетплейса Вайлдберриз","archived":false,"fork":false,"pushed_at":"2026-05-06T20:03:11.000Z","size":108,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-06T20:28:03.275Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dontsovcmc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T21:31:12.000Z","updated_at":"2026-04-27T10:25:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dontsovcmc/mcp-server-wildberries","commit_stats":null,"previous_names":["dontsovcmc/mcp-server-wildberries"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dontsovcmc/mcp-server-wildberries","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-wildberries","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-wildberries/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-wildberries/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-wildberries/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dontsovcmc","download_url":"https://codeload.github.com/dontsovcmc/mcp-server-wildberries/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dontsovcmc%2Fmcp-server-wildberries/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33067567,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-15T13:08:45.634Z","updated_at":"2026-05-15T13:08:50.817Z","avatar_url":"https://github.com/dontsovcmc.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 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 \u0026\u0026 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 \u0026\u0026 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=ваш-токен \u0026\u0026 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=ваш-токен \u0026\u0026 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 \u0026\u0026 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 \u0026\u0026 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 \u0026 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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdontsovcmc%2Fmcp-server-wildberries","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdontsovcmc%2Fmcp-server-wildberries","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdontsovcmc%2Fmcp-server-wildberries/lists"}