Wildberries Agent Integration
Бесплатная русскоязычная аналитика Wildberries для Codex, Claude и MCP-клиентов
Плагин соединяет агента с Seller и даёт продавцу понятный путь от вопроса к числу и следующему действию: продажи, остатки, конкуренты, цены, регионы, SEO, контент карточки, юнит-экономика и пополнение. Агентский функционал бесплатен: у проекта нет платы за лицензию, место пользователя или вызов инструмента.
В двух словах
- 16 русскоязычных навыков и 15 MCP-инструментов.
- Безопасное подключение поставщика через
seller.bears.ru: исходный WB-токен не вводится в чат. - Отдельный калькулятор пополнения и прогноз «сколько и куда везти».
- Конкурентный анализ, ценовой коридор, продажи по доступному региональному полю, погодные гипотезы и SEO-оценка.
- Подготовка карточки, дизайн-системы и фото товара — без автоматической публикации в Wildberries.
- MIT, открытый исходный код, бесплатная агентская поверхность.
Калькулятор и пополнение
Это центральный операционный сценарий плагина:
wb_replenishment_mathбыстро считает количество единиц по дневному спросу, остатку, товару в пути и целевому покрытию.wb_inventory_forecastучитывает доступные остатки и спрос, предлагает направления по складам или регионам и показывает допущения.- Если складская география недоступна, результат честно помечается как региональная эвристика — без выдуманного распределения.
Калькуляторы ничего не заказывают и не меняют остатки. Это воспроизводимая рекомендация для планирования.
Возможности
| Группа | Что умеет агент |
|---|---|
| Аналитика | Продажи, заказы, финансы, цены, остатки и сводки за период |
| Решения | Юнит-экономика, маржа, точка безубыточности, цена и пополнение |
| Рынок | Явно переданные наблюдения конкурентов и конкурентный ценовой коридор |
| Репутация | Отзывы, средняя оценка, повторяющиеся жалобы и список без ответа |
| География | Продажи в разрезе товара и доступного региона; локальные дефициты |
| Гипотезы | Сопоставление продаж с погодой без заявления причинности |
| Контент | SEO-проверка, структура карточки, дизайн-система и варианты фото |
| Интеграция | Защищённая регистрация, запись себестоимости и allowlist Seller Gateway |
MCP-инструменты
| Инструмент | Назначение |
|---|---|
wb_connect_supplier | Открыть защищённый сценарий подключения поставщика |
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, открывая
Seller onboarding; вводить 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 и deployment подготовленного OAuth 2.1/PKCE identity bridge:
SELLER_IDENTITY_BRIDGE_URL, MCP_PUBLIC_URL и MCP_AUTH_ISSUER.
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 --> C[Identity bridge]
B --> 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 опубликованы; companion Seller source содержит OAuth 2.1/PKCE и
reviewed WB API contracts. Production endpoint рядом с сервером аналитики и карточка
в публичном каталоге ChatGPT/OpenAI требуют deployment, HTTPS/OAuth-реквизитов и проверки
рецензентом. Пока такой функциональный deployment не подтверждён, проект не заявляет
runtime_accepted и не выдаёт адрес-заглушку за работающий MCP.
Порядок подачи описан в docs/public-listing.md, контракт MCP — в
docs/mcp-contract.md, архитектурные ограничения — в SPEC.md.
Документация
- Ландшафт конкурентов и источники
- Identity bridge
- Доступ и mock-данные для ревьюера
- Подача в каталог OpenAI
- Подача в каталог Claude
- Безопасность
- Приватность
- Условия использования
- Поддержка
- История изменений
- Social preview 1280×640
MIT — LICENSE.