wb-mcp-armine: MCP-мост Wildberries только для чтения
WB Readonly MCP
Небольшой MCP-сервер на Python отдает агенту семь методов официального API Wildberries и отказывается работать с токеном, у которого есть права записи
- 0 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Токен Wildberries открывает карточки, воронку, заказы и продажи магазина, хотя сервер принимает его только на чтение
- Размещенный на публичном Hugging Face Space сервер зависит от секретов платформы и ее доступности
Установка
- Работает в
- Сервисы
Ручная установка
Выложи `Dockerfile`, `server.py` и `README.md` в новый Docker-Space на Hugging Face, задай секреты `WB_API_TOKEN` и `MCP_ACCESS_TOKEN` и подключи адрес `https://<адрес>.hf.space/mcp` клиенту с заголовком `Authorization: Bearer <MCP_ACCESS_TOKEN>`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен Wildberries открывает карточки, воронку, заказы и продажи магазина, хотя сервер принимает его только на чтение
- Размещенный на публичном Hugging Face Space сервер зависит от секретов платформы и ее доступности
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер без состояния принимает запросы MCP по `/mcp` и ходит в три группы официального API Wildberries: контент, аналитику и статистику. Инструментов семь: три проверки доступности (`wb_content_ping`, `wb_analytics_ping`, `wb_statistics_ping`), список карточек `wb_cards_list`, воронка продаж `wb_sales_funnel`, заказы `wb_orders` и продажи с возвратами `wb_sales_returns`. Для запросов с телом нужен объект `body` по схеме Wildberries, для заказов и продаж параметр `dateFrom`. При старте сервер декодирует токен и принимает его, только если он действующий, с правом чтения и ровно с категориями «Контент», «Аналитика» и «Статистика». Это локальная предварительная проверка, подпись проверяет сам Wildberries. Доступ к `/mcp` закрыт отдельным секретом `MCP_ACCESS_TOKEN`, не короче 32 символов. Перенаправления отключены, а частота вызовов ограничена локально. В репозитории есть инструкция запуска на Hugging Face Spaces через Docker.
Для кого. Продавцам Wildberries, которые хотят подключить к ChatGPT или другому клиенту с Streamable HTTP только чтение карточек, воронки и заказов.
Подходит, если
- Нужен список карточек магазина через официальный API без прав записи
- Воронку продаж по товарам запрашивают телом запроса по схеме Wildberries
- Заказы и продажи с возвратами выгружают начиная с даты `dateFrom`
- Сервер хотят поднять без установки Python на компьютер, на Hugging Face Spaces
Не подходит, если
- Нужны цены, остатки, реклама, отзывы или запись: в маршрутах только семь методов чтения
- Клиент поддерживает только OAuth: сервер требует Bearer-заголовок с `MCP_ACCESS_TOKEN`
- Нужен надежный постоянный хостинг: автор называет Spaces способом первого запуска без гарантий 24/7
Пример запроса к агенту
Покажи заказы Wildberries с 1 ноября и продажи с возвратами за ту же датуMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
WB_API_TOKENобязательная, секрет- Токен Wildberries только на чтение с категориями Контент, Аналитика, Статистика
MCP_ACCESS_TOKENобязательная, секрет- Отдельный секрет доступа к /mcp, не короче 32 символов
PORT- Порт сервера, по умолчанию 7860
Ограничения
В коде всего семь маршрутов, а токен должен быть без прав записи и с тремя точными категориями, иначе сервер не запустится. Нужны два секрета: токен Wildberries и отдельный пароль `MCP_ACCESS_TOKEN`. Публичное пространство на Hugging Face показывает код и страницу состояния, данные магазина защищены вторым секретом. Страница состояния не подтверждает связь с Wildberries. Лицензия в репозитории не указана. Четыре файла, один автор, последний коммит в октябре 2026 года, звезд нет.
Как отключить. Удалите Space на Hugging Face или остановите контейнер, уберите сервер из настроек клиента и отзовите токен Wildberries в разделе «Интеграции API».
Частые вопросы
Какой токен Wildberries подойдет?
Действующий токен только на чтение с категориями «Контент», «Аналитика» и «Статистика» и никакими другими. Иначе сервер не запустится.
Как защищен адрес `/mcp`?
Отдельным секретом `MCP_ACCESS_TOKEN` не короче 32 символов, он передается заголовком `Authorization: Bearer`. Это не токен Wildberries.
Какие инструменты есть?
Семь: три `*_ping`, `wb_cards_list`, `wb_sales_funnel`, `wb_orders` и `wb_sales_returns`. Все помечены как только для чтения.
Что делать, если /mcp в браузере выдает 404 или 501?
Это нормально: адрес рассчитан на POST-запросы клиента MCP, страницы там нет. Живость сервера показывает корневая страница.
Есть ли ограничение частоты вызовов?
Да, сервер ограничивает вызовы локально по маршрутам и при превышении возвращает `local_rate_limit` с числом секунд до повтора.
Обсуждение
Вопросов и отзывов пока нет.
MCP только для чтения кабинета Wildberries
WB Readonly MCP
MCP-сервер Wildberries только на чтение: товары, реклама, заказы, остатки, финансы и отзывы, запись запрещена в коде
rf-marketplaces-mcp: аналитика Wildberries и кабинет продавца
rf-marketplaces-mcp
MCP-сервер дает агенту данные по артикулу Wildberries без токена и, с токеном, продажи, остатки и ответы на отзывы продавца
MCP-сервер Wildberries на OpenAPI
Wildberries MCP Server
Локальный MCP-сервер Wildberries Seller API на 279 методов из OpenAPI-каталога, вызовы по умолчанию в режиме dry-run
Wildberries MCP
wildberries-mcp
MCP-сервер для API продавца Wildberries: товары, цены, остатки, заказы, поставки FBS, аналитика, отзывы и реклама
MCP-сервер Wildberries Seller API
wildberries-mcp-ru
MCP-сервер под все семнадцать хостов Wildberries Seller API: продажи, остатки, карточки, цены, финотчеты и отзывы
MCP-сервер поиска Wildberries
Wildberries MCP Server
Легкий MCP-сервер для поиска товаров Wildberries по публичному JSON API: карточка, цена, отзывы без браузера
Коротко о README
README в формате Hugging Face задает параметры Space и коротко описывает режим только чтения и адрес `/mcp`. Подробности запуска лежат в `START_RU.txt`, а поведение в коде `server.py`.