{
  "markdown": "# wildberries-mcp-ru\n\n<!-- mcp-name: io.github.ilyautov/wildberries-mcp-ru -->\n\nAPI Wildberries для ИИ-ассистентов: продажи и остатки, карточки и характеристики, цены и акции, финансовые отчёты, отзывы. Семнадцать хостов WB разложены по каталогу.\n\n[![PyPI](https://img.shields.io/pypi/v/wildberries-mcp-ru?label=pypi&color=B5491F)](https://pypi.org/project/wildberries-mcp-ru/)\n[![CI](https://github.com/ilyautov/wildberries-mcp-ru/actions/workflows/ci.yml/badge.svg)](https://github.com/ilyautov/wildberries-mcp-ru/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Методов](https://img.shields.io/badge/методов-307-2D7D4F)](#карта-методов)\n[![Сайт](https://img.shields.io/badge/%D1%81%D0%B0%D0%B9%D1%82-marketplaces--mcp--ru-9A3E1A)](https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html)\n[![Звёзды](https://img.shields.io/github/stars/ilyautov/wildberries-mcp-ru?style=flat&label=%D0%B7%D0%B2%D1%91%D0%B7%D0%B4%D1%8B&color=B5491F&logo=github&logoColor=white)](https://github.com/ilyautov/wildberries-mcp-ru/stargazers)\n\n<p align=\"center\">\n  <a href=\"https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html\">\n    <img src=\"assets/social-preview.png\" alt=\"wildberries-mcp-ru: API Wildberries в ИИ-ассистенте. 307 методов\" width=\"760\">\n  </a>\n</p>\n\nПакет поднимает один сервер, Wildberries, и ничего больше. Сервер, каталог и\nядро приходят зависимостью из [`marketplaces-mcp-ru`](https://github.com/ilyautov/marketplaces-mcp-ru):\nздесь имя, точка входа и документация под один маркетплейс.\n\n## Установка\n\nПакет на PyPI, поэтому строка одна:\n\n```bash\nuvx wildberries-mcp-ru\n```\n\nЕсли нужна ветка `main`, а не релиз:\n\n```bash\nuvx --from git+https://github.com/ilyautov/wildberries-mcp-ru wildberries-mcp-ru\n```\n\nClaude Desktop, `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"wb\": {\n      \"command\": \"uvx\",\n      \"args\": [\"wildberries-mcp-ru\"],\n      \"env\": { \"WB_API_TOKEN\": \"...\" }\n    }\n  }\n}\n```\n\nТретий путь, если агент умеет скиллы: он поставит сервер и настроит клиент сам.\n\n```bash\nnpx skills add ilyautov/wildberries-mcp-ru\n```\n\n## Ключи\n\n**Где взять токен.** Кабинет `seller.wildberries.ru`, раздел **Настройки**, пункт **Доступ к API**. Токен один на все хосты, но при создании выбираются категории доступа: выданный только под контент токен не пустят в статистику.\n\n**Как он уходит в запрос.** В заголовок `Authorization`, и это важный нюанс: сервер шлёт raw-токен **без префикса** `Bearer`. Подтверждено на практике. Если авторизация падает при верном токене, проверьте это первым.\n\n**Где он лежит.** В `~/.marketplace-mcp/cabinets.json` с правами `chmod 600`, локально. В репозиторий и в чат токен не попадает.\n\n| переменная | секрет | что это |\n|---|---|---|\n| `WB_API_TOKEN` | да | Токен из кабинета seller.wildberries.ru, Настройки → Доступ к API. Уходит в Authorization без Bearer. |\n\nКлючи можно не держать в окружении: сервер умеет кабинеты и кладёт их в\n`~/.marketplace-mcp/cabinets.json` с правами 600, вне репозитория. Магазинов\nподключается сколько нужно, переключение прямо из чата.\n\n## Карта методов\n\nКаталог лежит в зависимости как `wb_mcp/endpoints.yaml`:\n**307 методов**, из них 187 на чтение, 108 на запись и 12 необратимых.\nСервер исполняет ровно этот файл, поэтому таблица не может разойтись с кодом.\n\n| хост | методов | что там |\n|---|---:|---|\n| `marketplace-api.wildberries.ru` | 100 | Сборочные задания и поставки FBS, DBS, DBW, самовывоз |\n| `seller-analytics-api.wildberries.ru` | 40 | Аналитика продавца: поисковые запросы, остатки, удержания, платное хранение |\n| `content-api.wildberries.ru` | 31 | Карточки товаров, характеристики, категории, медиа, ярлыки |\n| `advert-api.wildberries.ru` | 30 | Рекламные кампании, ставки, поисковые кластеры |\n| `devapi-digital.wildberries.ru` | 22 | Цифровые товары: контент, предложения, ключи активации |\n| `feedbacks-api.wildberries.ru` | 20 | Отзывы, вопросы, закреплённые отзывы |\n| `discounts-prices-api.wildberries.ru` | 13 | Цены, скидки, календарь акций |\n| `common-api.wildberries.ru` | 10 | Информация о продавце, тарифы, комиссии, новости |\n| `supplies-api.wildberries.ru` | 7 | Поставки на склад WB и данные для их формирования |\n| `finance-api.wildberries.ru` | 7 | Финансовые отчёты и баланс |\n| `statistics-api.wildberries.ru` | 5 | Статистика: продажи, заказы, остатки, отчёт о реализации |\n| `user-management-api.wildberries.ru` | 4 | Пользователи продавца и их права |\n| `advert-media-api.wildberries.ru` | 4 | Медиа в рекламе и статистика по ним |\n| `dp-calendar-api.wildberries.ru` | 4 | Календарь акций и участие в них |\n| `buyer-chat-api.wildberries.ru` | 4 | Чат с покупателями |\n| `documents-api.wildberries.ru` | 4 | Документы продавца |\n| `returns-api.wildberries.ru` | 2 | Возвраты покупателями |\n\nПодробный разбор с параметрами и лимитами: [https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html](https://marketplaces-mcp-ru.aifrontier.tech/wildberries-api.html)\n\n## Что спросить в чате\n\n- покажи продажи на WB за неделю\n- вытащи финотчёт реализации за прошлый месяц\n- что пора дозаказать, посчитай дни покрытия\n- какие товары рискуют уйти в out-of-stock\n\n## Частые ошибки\n\n**401 при верном токене.** Две причины по частоте. Первая: WB ждёт raw-токен в `Authorization` без `Bearer`. Вторая: активный кабинет в `~/.marketplace-mcp/cabinets.json` имеет приоритет над переменными окружения и затеняет то, что вы экспортировали.\n\n**404 или пустой ответ на рабочем методе.** Проверьте хост. У WB семнадцать доменов по назначению, и статистика на домене контента не отвечает. Таблица хостов выше.\n\n**429, превышен лимит запросов.** Лимиты у WB заданы поштучно и местами очень жёсткие: у части методов это один запрос в минуту, у отчётов бывает и реже. Лимит привязан к методу, а не к аккаунту целиком, поэтому упереться можно на одном отчёте, пока остальное работает.\n\n## Чем это отличается от marketplaces-mcp-ru\n\nНичем, кроме состава. `marketplaces-mcp-ru` ставит четыре маркетплейса сразу и держит их\nпод одним сервером, `wildberries-mcp-ru` ставит один. Код общий: правка в ядре доезжает\nсюда обновлением зависимости, а не копированием.\n\n| нужно | пакет |\n|---|---|\n| только Wildberries | `wildberries-mcp-ru` |\n| все четыре маркетплейса | `marketplaces-mcp-ru` |\n\n## Кто это сделал\n\n[Илья Утов](https://github.com/ilyautov), лаборатория\n[AI Frontier](https://aifrontier.tech). Как эти инструменты устроены внутри,\nпишу в [Telegram](https://t.me/gorilla_under_hood) и\n[LinkedIn](https://www.linkedin.com/in/ilyautov).\n\nРядом стоят [**business-mcp-ru**](https://github.com/ilyautov/business-mcp-ru)\n(hh.ru, VK, Диадок, СБИС, Честный знак),\n[**moysklad-mcp-ru**](https://github.com/ilyautov/moysklad-mcp-ru) и\n[**humanizer-ru**](https://github.com/ilyautov/humanizer-ru).\n\nВсе проекты одним списком, разобранные по назначению:\n[ilyautov.github.io](https://ilyautov.github.io/).\n\n## Лицензия\n\nMIT, см. [LICENSE](LICENSE).\n",
  "bytes": 6924,
  "sha": "13b2bc7dff1990a0ad0a0c63b820767b127764386b2436e297cbd26cbf87ccb9",
  "repo_slug": "ilyautov/wildberries-mcp-ru",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ilyautov_wildberries_mcp_ru_dd5f60cb/readme"
}