Skip to main content
Glama
BearsCLOUD

Wildberries Agent

by BearsCLOUD

Wildberries Agent Integration

Плагин соединяет агента с Seller и даёт продавцу понятный путь от вопроса к числу и следующему действию: продажи, остатки, конкуренты, цены, регионы, SEO, контент карточки, юнит-экономика и пополнение. Агентский функционал бесплатен: у проекта нет платы за лицензию, место пользователя или вызов инструмента.

В двух словах

  • 16 русскоязычных навыков и 17 MCP-инструментов.

  • Безопасное подключение поставщика через seller.bears.ru: исходный WB-токен не вводится в чат.

  • Отдельный калькулятор пополнения и прогноз «сколько и куда везти».

  • Конкурентный анализ, ценовой коридор, продажи по доступному региональному полю, погодные гипотезы и SEO-оценка.

  • Подготовка карточки, дизайн-системы и фото товара — без автоматической публикации в Wildberries.

  • MIT, открытый исходный код, бесплатная агентская поверхность.

Related MCP server: Acmezone Data MCP

Калькулятор и пополнение

Это центральный операционный сценарий плагина:

  1. wb_replenishment_math быстро считает количество единиц по дневному спросу, остатку, товару в пути и целевому покрытию.

  2. wb_inventory_forecast учитывает доступные остатки и спрос, предлагает направления по складам или регионам и показывает допущения.

  3. Если складская география недоступна, результат честно помечается как региональная эвристика — без выдуманного распределения.

Калькуляторы ничего не заказывают и не меняют остатки. Это воспроизводимая рекомендация для планирования.

Возможности

Группа

Что умеет агент

Аналитика

Продажи, заказы, финансы, цены, остатки и сводки за период

Решения

Юнит-экономика, маржа, точка безубыточности, цена и пополнение

Рынок

Явно переданные наблюдения конкурентов и конкурентный ценовой коридор

Репутация

Отзывы, средняя оценка, повторяющиеся жалобы и список без ответа

География

Продажи в разрезе товара и доступного региона; локальные дефициты

Гипотезы

Сопоставление продаж с погодой без заявления причинности

Контент

SEO-проверка, структура карточки, дизайн-система и варианты фото

Интеграция

Защищённая регистрация, запись себестоимости и allowlist Seller Gateway

MCP-инструменты

Инструмент

Назначение

wb_connect_supplier

Открыть одноразовый защищённый сценарий привязки Seller

wb_connection_status

Проверить привязку Seller и список поставщиков

wb_connect_telegram

Открыть существующий сценарий подключения Telegram

wb_list_suppliers

Показать поставщиков текущего пользователя

wb_analytics_summary

Сводка продаж, заказов, финансов, цен и остатков

wb_warehouse_stock

Остатки по товару и складам

wb_wildberries_proxy

Фиксированные read-only операции Seller Gateway

wb_refresh_analytics

Поставить обновление аналитики в существующую очередь Seller

wb_competitor_analysis

Сравнение с явно переданными конкурентами

wb_competitive_price

Коридор цены и проверяемые сценарии

wb_sales_by_region

Продажи по доступному региональному полю

wb_sales_weather_impact

Корреляция продаж и погодных рядов

wb_seo_analytics

Проверка контента карточки и поисковых ключей

wb_upload_cost_price

Двухшаговая перезапись указанной себестоимости в Seller с токеном, связанным с параметрами

wb_unit_economics

Маржа, безубыточность и сценарии

wb_replenishment_math

Быстрый расчёт количества пополнения

wb_inventory_forecast

Прогноз количества и направлений пополнения

Быстрый старт

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 --> D

wb_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.

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.

  • 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

  • A
    license
    A
    quality
    A
    maintenance
    A 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.
    22
    59 PyPI
    70
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables safe, read-only analysis of an online store's SQLite database, providing schema introspection, restricted SELECT queries, and specialized analytics tools through MCP.
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables 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.
    -