Wildberries Agent Integration

io.github.BearsCLOUD由 GitHub 帳號 BearsCLOUD 發布v0.1.26更新於 Oct 25, 2026

Бесплатная русскоязычная аналитика Wildberries, SEO, калькуляторы и прогноз пополнения через MCP.

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

面向 Wildberries 賣家的俄語分析 MCP 伺服器，讓助理取得銷售、庫存、價格與 SEO 資料，並計算補貨與單位經濟效益。

可以做什麼
連接並檢視 Seller 供應商與連線狀態，包括 Telegram 綁定流程，以及透過固定的唯讀 Seller Gateway 代理排入分析更新，並支援兩步驟成本價回寫。彙總銷售、訂單、財務、價格與庫存，並依商品與倉庫拆分庫存。與明確提供的競爭對手比較、計算價格區間，並依可用的地區欄位或天氣序列檢視銷售。檢查商品卡內容與搜尋關鍵字的 SEO，並草擬卡片結構、設計系統與圖片方案而不發布。計算單位經濟效益、利潤率與損益兩平，並計算或預測補貨數量與方向。
適用情境
適合希望助理把銷售、庫存與定價問題轉化為具體數字與下一步行動的 Wildberries 賣家，尤其是補貨規劃、利潤率與損益兩平核算，以及 SEO 與內容審查。在提供相應資料時，也適合競爭對手與地區銷售分析。
執行需求
遠端 Streamable HTTP 端點 wb.seller.bears.ru，或本機 Python 安裝並連接可用的 Seller Gateway。Seller 授權透過瀏覽器中的 OAuth 2.1/PKCE 完成；Wildberries 權杖只在 Seller 中輸入，不填入聊天或客戶端設定。本機正式使用需要 HTTPS 以及 SELLER_GATEWAY_URL、MCP_PUBLIC_URL 和 MCP_AUTH_ISSUER 變數。外部競爭對手與天氣資料需要相容的 API 與相應授權。
安裝前請注意
成本價工具會改寫 Seller 中指定的成本價，重新整理工具會將分析更新排入佇列，因此會變更已儲存的資料。代理僅限固定的唯讀操作，只傳遞不透明的代理 bearer，絕不傳遞 Seller bearer。分析屬於啟發式：競爭對手涵蓋範圍、價格區間、地區、天氣相關性與 SEO 均不構成保證。不包含自動發布、改價或不可逆操作。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Wildberries Agent Integration，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.BearsCLOUD%2Fwildberries-agent-integration/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "wildberries-agent-integration": {
      "type": "http",
      "url": "https://wb.seller.bears.ru/mcp"
    }
  }
}

README

Wildberries Agent Integration

[Wildberries Agent Integration]

Бесплатная русскоязычная аналитика Wildberries для Codex, Claude и MCP-клиентов

[CI] [Релиз] [Звёзды] [Лицензия MIT]

[Схема аналитики, калькуляторов и пополнения Wildberries через агента]

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

В двух словах

  • 16 русскоязычных навыков и 17 MCP-инструментов.
  • Безопасное подключение поставщика через seller.bears.ru: исходный WB-токен не вводится в чат.
  • Отдельный калькулятор пополнения и прогноз «сколько и куда везти».
  • Конкурентный анализ, ценовой коридор, продажи по доступному региональному полю, погодные гипотезы и SEO-оценка.
  • Подготовка карточки, дизайн-системы и фото товара — без автоматической публикации в Wildberries.
  • MIT, открытый исходный код, бесплатная агентская поверхность.

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

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

  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

bash
git clone https://github.com/BearsCLOUD/wildberries-agent-integration.gitcd wildberries-agent-integrationcodex plugin marketplace add ./.agents/pluginscodex 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:

text
/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-сервера:

bash
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. Для проверки манифеста:

bash
claude plugin validate plugins/wildberries-agent-integration

Локальный MCP

bash
cd plugins/wildberries-agent-integrationpython3 -m venv .venv. .venv/bin/activatepython3 -m pip install -e .export APP_ENV=developmentexport SELLER_GATEWAY_URL=http://127.0.0.1:8000export SELLER_CONNECT_URL=https://seller.bears.ru/authentication/registrationwildberries-agent-mcp

Для Streamable HTTP:

bash
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 либо выполните:

bash
npx alpic deploy \  --root-dir ./plugins/wildberries-agent-integration \  --runtime python3.13

Не публикуйте deployment без production OAuth/Seller variables из deploy/README.md. Один только health endpoint не доказывает работоспособность пользовательской аналитики.

Как устроено подключение

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

Документация

[Deploy on Alpic]

## Лицензия

MIT — LICENSE.

來源：README.md，提交 35e5292

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v0.1.26最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分