Wildberries Agent
Provides a tool to open an existing Telegram connection scenario, enabling linking a Telegram account.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Wildberries Agentпосчитай пополнение: спрос 20 в день, остаток 100, в пути 50"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Wildberries Agent Integration
Плагин соединяет агента с Seller и даёт продавцу понятный путь от вопроса к числу и следующему действию: продажи, остатки, конкуренты, цены, регионы, SEO, контент карточки, юнит-экономика и пополнение. Агентский функционал бесплатен: у проекта нет платы за лицензию, место пользователя или вызов инструмента.
В двух словах
16 русскоязычных навыков и 17 MCP-инструментов.
Безопасное подключение поставщика через
seller.bears.ru: исходный WB-токен не вводится в чат.Отдельный калькулятор пополнения и прогноз «сколько и куда везти».
Конкурентный анализ, ценовой коридор, продажи по доступному региональному полю, погодные гипотезы и SEO-оценка.
Подготовка карточки, дизайн-системы и фото товара — без автоматической публикации в Wildberries.
MIT, открытый исходный код, бесплатная агентская поверхность.
Related MCP server: Acmezone Data MCP
Калькулятор и пополнение
Это центральный операционный сценарий плагина:
wb_replenishment_mathбыстро считает количество единиц по дневному спросу, остатку, товару в пути и целевому покрытию.wb_inventory_forecastучитывает доступные остатки и спрос, предлагает направления по складам или регионам и показывает допущения.Если складская география недоступна, результат честно помечается как региональная эвристика — без выдуманного распределения.
Калькуляторы ничего не заказывают и не меняют остатки. Это воспроизводимая рекомендация для планирования.
Возможности
Группа | Что умеет агент |
Аналитика | Продажи, заказы, финансы, цены, остатки и сводки за период |
Решения | Юнит-экономика, маржа, точка безубыточности, цена и пополнение |
Рынок | Явно переданные наблюдения конкурентов и конкурентный ценовой коридор |
Репутация | Отзывы, средняя оценка, повторяющиеся жалобы и список без ответа |
География | Продажи в разрезе товара и доступного региона; локальные дефициты |
Гипотезы | Сопоставление продаж с погодой без заявления причинности |
Контент | SEO-проверка, структура карточки, дизайн-система и варианты фото |
Интеграция | Защищённая регистрация, запись себестоимости и allowlist Seller Gateway |
MCP-инструменты
Инструмент | Назначение |
| Открыть одноразовый защищённый сценарий привязки Seller |
| Проверить привязку Seller и список поставщиков |
| Открыть существующий сценарий подключения Telegram |
| Показать поставщиков текущего пользователя |
| Сводка продаж, заказов, финансов, цен и остатков |
| Остатки по товару и складам |
| Фиксированные read-only операции Seller Gateway |
| Поставить обновление аналитики в существующую очередь Seller |
| Сравнение с явно переданными конкурентами |
| Коридор цены и проверяемые сценарии |
| Продажи по доступному региональному полю |
| Корреляция продаж и погодных рядов |
| Проверка контента карточки и поисковых ключей |
| Двухшаговая перезапись указанной себестоимости в Seller с токеном, связанным с параметрами |
| Маржа, безубыточность и сценарии |
| Быстрый расчёт количества пополнения |
| Прогноз количества и направлений пополнения |
Быстрый старт
Codex
git clone https://github.com/BearsCLOUD/wildberries-agent-integration.git
cd wildberries-agent-integration
codex plugin marketplace add ./.agents/plugins
codex plugin add wildberries-agent-integration@wildberries-agentКаталог плагина описан в .agents/plugins/marketplace.json, манифест — в
plugins/wildberries-agent-integration/.codex-plugin/plugin.json. Плагин сам объявляет
public MCP и динамически регистрирует OAuth client. OAuth создаёт анонимную агентскую
сессию; Seller подключается затем по одноразовой ссылке. Вводить WB-токен в терминал или чат не нужно.
Claude
Установите плагин с шестнадцатью навыками и публичным MCP в Claude Code:
/plugin marketplace add BearsCLOUD/wildberries-agent-integration
/plugin install wildberries-agent-integration@wildberries-agentЭто каталог BearsCLOUD, а не официальный каталог Anthropic.
Для hosted Claude Connector укажите https://wb.seller.bears.ru/mcp; Seller OAuth
регистрирует public client через DCR и PKCE S256.
Для Claude Code подключите публичный MCP без локального Python-сервера:
claude mcp add --transport http wildberries-agent https://wb.seller.bears.ru/mcpОткройте /mcp в Claude Code и пройдите авторизацию Seller в браузере.
Токен Wildberries вводится только в Seller, не в конфигурацию Claude.
Манифест Claude находится в plugins/wildberries-agent-integration/.claude-plugin/plugin.json,
а готовая конфигурация — в plugins/wildberries-agent-integration/claude/mcp.json.
Для проверки манифеста:
claude plugin validate plugins/wildberries-agent-integrationЛокальный MCP
cd plugins/wildberries-agent-integration
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e .
export APP_ENV=development
export SELLER_GATEWAY_URL=http://127.0.0.1:8000
export SELLER_CONNECT_URL=https://seller.bears.ru/authentication/registration
wildberries-agent-mcpДля Streamable HTTP:
wildberries-agent-mcp --transport streamable-http --host 127.0.0.1 --port 8080Локальный сервер требует доступный Seller Gateway для авторизованных аналитических вызовов.
В production дополнительно нужны HTTPS, SELLER_GATEWAY_URL, MCP_PUBLIC_URL и MCP_AUTH_ISSUER. MCP передаёт Gateway только непрозрачный агентский bearer и никогда не получает Seller bearer.
Alpic
В репозитории есть явный alpic.json. Для импорта укажите root directory
plugins/wildberries-agent-integration либо выполните:
npx alpic deploy \
--root-dir ./plugins/wildberries-agent-integration \
--runtime python3.13Не публикуйте deployment без production OAuth/Seller variables из
deploy/README.md. Один только health endpoint не доказывает работоспособность
пользовательской аналитики.
Как устроено подключение
flowchart LR
A[Codex / Claude] --> B[Публичный MCP]
B -->|opaque OAuth bearer| D[Seller Gateway]
D --> E[Seller analytics]
D --> F[Хранимая WB credential]
U[Продавец] -->|токен только в браузере| S[seller.bears.ru]
S --> Dwb_wildberries_proxy — не произвольный HTTP-прокси. Агент передаёт только supplier_id_wb,
имя разрешённой операции и ограниченный payload. Он не видит токен, URL, HTTP-метод,
путь или заголовки. Seller Gateway проверяет владельца и область поставщика, а затем сам выбирает
хранимую credential. Единственные записи в текущем наборе — явно указанная себестоимость товара
и постановка существующего обновления аналитики Seller в очередь; данные Wildberries не изменяются.
16 навыков
Все навыки русскоязычные и лежат в plugins/wildberries-agent-integration/skills:
analytics-summary · connect-supplier · cost-price-upload · unit-economics ·
replenishment-calculator · inventory-forecast · competitor-analysis ·
competitive-pricing · regional-sales · weather-impact · seo-analytics ·
product-card · design-system · product-photo-generation · review-analysis ·
wildberries-api.
Навыки готовят черновики и рекомендации. Публикация карточки, изменение цен и любые необратимые операции остаются за пределами текущей бесплатной поверхности.
Ограничения и честный статус
Конкуренты анализируются только по переданному или разрешённому источнику; полнота рынка не обещается.
Ценовой коридор описывает выборку, но не доказывает спрос или прибыльность.
Регион — только фактическое географическое поле источника, а не автоматически выведенный регион покупателя.
Погода показывает корреляцию совпавших рядов, а не причинное влияние и не прогноз продаж.
SEO — прозрачная эвристика контента, а не гарантия позиции, CTR или конверсии.
Внешние данные (конкуренты, погода) требуют совместимого API и соответствующей лицензии.
Публичный MCP https://wb.seller.bears.ru/mcp, Seller OAuth 2.1/PKCE, reviewer sandbox и
reviewed WB API contracts развёрнуты и функционально проверены. Публикация в каталоге
ChatGPT/OpenAI остаётся отдельным этапом: для неё нужны проверка домена, заполненный черновик
карточки и отправка на ревью оператором.
Порядок подачи описан в docs/public-listing.md, контракт MCP — в
docs/mcp-contract.md, архитектурные ограничения — в SPEC.md.
Документация
MIT — LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Connects Amazon Seller Central and Amazon Advertising to any MCP client. Settlement-accurate P&L - every fee, refund and reimbursement as Amazon posted it - plus contribution margin and breakeven per product, per marketplace, per day. Full Sponsored Products, Brands and Display management: search terms, placements, keyword and competitor research, dayparting, automation rules. 110 tools: 78 read-only (P&L, PPC at every grain, SQP/Brand Analytics, inventory, forecasting), 28 staged writes (every change is a proposal you review and confirm before it reaches Amazon - there is no autonomous-write mode), and 4 confirmation & support tools. 4 additional AI Workforce tools appear once a client is connected.
- LimoneneOAuthapp.limonene
Read-only Amazon seller analytics: sales, Buy Box, FBA inventory, alerts, revenue and fees.
MCP server for querying and analyzing data from ad platforms, analytics tools, and spreadsheets
Connect your ads, shop, analytics, social, CRM and finance platforms once, then let Claude, ChatGPT, Cursor or any MCP client read, join and explain your numbers. Public statistics from the World Bank, IMF, Eurostat, OECD, WHO and SEC filings come as context, searchable and chartable from the same tools. Read-only by design, every number carries its source.
Related MCP Servers
- AlicenseAqualityAmaintenanceA suite of MCP servers that give AI agents read-only access to Chinese e-commerce platform business data, including advertising, orders, products, and more from platforms like Douyin, JD.com, Taobao, etc.2259 PyPI70MIT
- FlicenseNot gradedqualityCmaintenanceRead-only MCP server for internal Amazon business data, exposing 19 tools to query sales, inventory, and financial metrics.-
- FlicenseNot gradedqualityCmaintenanceEnables safe, read-only analysis of an online store's SQLite database, providing schema introspection, restricted SELECT queries, and specialized analytics tools through MCP.-
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to query live MoySklad data — inventory, sales, cash flow, documents, and analytics — through read-only MCP tools that match the dashboard's metrics.-