{
  "markdown": "# Wildberries Agent Integration\n\n<p align=\"center\">\n  <img src=\"assets/logo.svg\" width=\"88\" height=\"88\" alt=\"Wildberries Agent Integration\">\n</p>\n\n\n\n<p align=\"center\"><strong>Бесплатная русскоязычная аналитика Wildberries для Codex, Claude и MCP-клиентов</strong></p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/BearsCLOUD/wildberries-agent-integration/actions/workflows/ci.yml\"><img src=\"https://github.com/BearsCLOUD/wildberries-agent-integration/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"></a>\n  <a href=\"https://github.com/BearsCLOUD/wildberries-agent-integration/releases\"><img src=\"https://img.shields.io/github/v/release/BearsCLOUD/wildberries-agent-integration\" alt=\"Релиз\"></a>\n  <a href=\"https://github.com/BearsCLOUD/wildberries-agent-integration\"><img src=\"https://img.shields.io/github/stars/BearsCLOUD/wildberries-agent-integration\" alt=\"Звёзды\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-7C3AED.svg\" alt=\"Лицензия MIT\"></a>\n</p>\n\n<p align=\"center\">\n  <img src=\"assets/hero.svg\" alt=\"Схема аналитики, калькуляторов и пополнения Wildberries через агента\" width=\"100%\">\n</p>\n\nПлагин соединяет агента с Seller и даёт продавцу понятный путь от вопроса к числу и следующему действию:\nпродажи, остатки, конкуренты, цены, регионы, SEO, контент карточки, юнит-экономика и пополнение.\nАгентский функционал бесплатен: у проекта нет платы за лицензию, место пользователя или вызов инструмента.\n\n## В двух словах\n\n- 16 русскоязычных навыков и 17 MCP-инструментов.\n- Безопасное подключение поставщика через `seller.bears.ru`: исходный WB-токен не вводится в чат.\n- Отдельный калькулятор пополнения и прогноз «сколько и куда везти».\n- Конкурентный анализ, ценовой коридор, продажи по доступному региональному полю, погодные гипотезы и SEO-оценка.\n- Подготовка карточки, дизайн-системы и фото товара — без автоматической публикации в Wildberries.\n- MIT, открытый исходный код, бесплатная агентская поверхность.\n\n## Калькулятор и пополнение\n\nЭто центральный операционный сценарий плагина:\n\n1. `wb_replenishment_math` быстро считает количество единиц по дневному спросу, остатку, товару в пути и целевому покрытию.\n2. `wb_inventory_forecast` учитывает доступные остатки и спрос, предлагает направления по складам или регионам и показывает допущения.\n3. Если складская география недоступна, результат честно помечается как региональная эвристика — без выдуманного распределения.\n\nКалькуляторы ничего не заказывают и не меняют остатки. Это воспроизводимая рекомендация для планирования.\n\n## Возможности\n\n| Группа | Что умеет агент |\n| --- | --- |\n| Аналитика | Продажи, заказы, финансы, цены, остатки и сводки за период |\n| Решения | Юнит-экономика, маржа, точка безубыточности, цена и пополнение |\n| Рынок | Явно переданные наблюдения конкурентов и конкурентный ценовой коридор |\n| Репутация | Отзывы, средняя оценка, повторяющиеся жалобы и список без ответа |\n| География | Продажи в разрезе товара и доступного региона; локальные дефициты |\n| Гипотезы | Сопоставление продаж с погодой без заявления причинности |\n| Контент | SEO-проверка, структура карточки, дизайн-система и варианты фото |\n| Интеграция | Защищённая регистрация, запись себестоимости и allowlist Seller Gateway |\n\n### MCP-инструменты\n\n| Инструмент | Назначение |\n| --- | --- |\n| `wb_connect_supplier` | Открыть одноразовый защищённый сценарий привязки Seller |\n| `wb_connection_status` | Проверить привязку Seller и список поставщиков |\n| `wb_connect_telegram` | Открыть существующий сценарий подключения Telegram |\n| `wb_list_suppliers` | Показать поставщиков текущего пользователя |\n| `wb_analytics_summary` | Сводка продаж, заказов, финансов, цен и остатков |\n| `wb_warehouse_stock` | Остатки по товару и складам |\n| `wb_wildberries_proxy` | Фиксированные read-only операции Seller Gateway |\n| `wb_refresh_analytics` | Поставить обновление аналитики в существующую очередь Seller |\n| `wb_competitor_analysis` | Сравнение с явно переданными конкурентами |\n| `wb_competitive_price` | Коридор цены и проверяемые сценарии |\n| `wb_sales_by_region` | Продажи по доступному региональному полю |\n| `wb_sales_weather_impact` | Корреляция продаж и погодных рядов |\n| `wb_seo_analytics` | Проверка контента карточки и поисковых ключей |\n| `wb_upload_cost_price` | Подтверждаемая перезапись указанной себестоимости в Seller |\n| `wb_unit_economics` | Маржа, безубыточность и сценарии |\n| `wb_replenishment_math` | Быстрый расчёт количества пополнения |\n| `wb_inventory_forecast` | Прогноз количества и направлений пополнения |\n\n## Быстрый старт\n\n### Codex\n\n```bash\ngit clone https://github.com/BearsCLOUD/wildberries-agent-integration.git\ncd wildberries-agent-integration\ncodex plugin marketplace add ./.agents/plugins\ncodex plugin add wildberries-agent-integration@wildberries-agent\n```\n\nКаталог плагина описан в `.agents/plugins/marketplace.json`, манифест — в\n`plugins/wildberries-agent-integration/.codex-plugin/plugin.json`. Плагин сам объявляет\npublic MCP и динамически регистрирует OAuth client. OAuth создаёт анонимную агентскую\nсессию; Seller подключается затем по одноразовой ссылке. Вводить WB-токен в терминал или чат не нужно.\n\n### Claude\n\nУстановите плагин с шестнадцатью навыками и публичным MCP в Claude Code:\n\n```text\n/plugin marketplace add BearsCLOUD/wildberries-agent-integration\n/plugin install wildberries-agent-integration@wildberries-agent\n```\n\nЭто каталог BearsCLOUD, а не официальный каталог Anthropic.\n\nДля hosted Claude Connector укажите `https://wb.seller.bears.ru/mcp`; Seller OAuth\nрегистрирует public client через DCR и PKCE S256.\n\nДля Claude Code подключите публичный MCP без локального Python-сервера:\n\n```bash\nclaude mcp add --transport http wildberries-agent https://wb.seller.bears.ru/mcp\n```\n\nОткройте `/mcp` в Claude Code и пройдите авторизацию Seller в браузере.\nТокен Wildberries вводится только в Seller, не в конфигурацию Claude.\n\nМанифест Claude находится в `plugins/wildberries-agent-integration/.claude-plugin/plugin.json`,\nа готовая конфигурация — в `plugins/wildberries-agent-integration/claude/mcp.json`.\nДля проверки манифеста:\n\n```bash\nclaude plugin validate plugins/wildberries-agent-integration\n```\n\n### Локальный MCP\n\n```bash\ncd plugins/wildberries-agent-integration\npython3 -m venv .venv\n. .venv/bin/activate\npython3 -m pip install -e .\nexport APP_ENV=development\nexport SELLER_GATEWAY_URL=http://127.0.0.1:8000\nexport SELLER_CONNECT_URL=https://seller.bears.ru/authentication/registration\nwildberries-agent-mcp\n```\n\nДля Streamable HTTP:\n\n```bash\nwildberries-agent-mcp --transport streamable-http --host 127.0.0.1 --port 8080\n```\n\nЛокальный сервер требует доступный Seller Gateway для авторизованных аналитических вызовов.\nВ production дополнительно нужны HTTPS, `SELLER_GATEWAY_URL`, `MCP_PUBLIC_URL` и `MCP_AUTH_ISSUER`. MCP передаёт Gateway только непрозрачный агентский bearer и никогда не получает Seller bearer.\n\n### Alpic\n\nВ репозитории есть явный `alpic.json`. Для импорта укажите root directory\n`plugins/wildberries-agent-integration` либо выполните:\n\n```bash\nnpx alpic deploy \\\n  --root-dir ./plugins/wildberries-agent-integration \\\n  --runtime python3.13\n```\n\nНе публикуйте deployment без production OAuth/Seller variables из\n[`deploy/README.md`](deploy/README.md). Один только health endpoint не доказывает работоспособность\nпользовательской аналитики.\n\n## Как устроено подключение\n\n```mermaid\nflowchart LR\n    A[Codex / Claude] --> B[Публичный MCP]\n    B -->|opaque OAuth bearer| D[Seller Gateway]\n    D --> E[Seller analytics]\n    D --> F[Хранимая WB credential]\n    U[Продавец] -->|токен только в браузере| S[seller.bears.ru]\n    S --> D\n```\n\n`wb_wildberries_proxy` — не произвольный HTTP-прокси. Агент передаёт только `supplier_id_wb`,\nимя разрешённой операции и ограниченный payload. Он не видит токен, URL, HTTP-метод,\nпуть или заголовки. Seller Gateway проверяет владельца и область поставщика, а затем сам выбирает\nхранимую credential. Единственные записи в текущем наборе — явно указанная себестоимость товара\nи постановка существующего обновления аналитики Seller в очередь; данные Wildberries не изменяются.\n\n## 16 навыков\n\nВсе навыки русскоязычные и лежат в [`plugins/wildberries-agent-integration/skills`](plugins/wildberries-agent-integration/skills/):\n\n`analytics-summary` · `connect-supplier` · `cost-price-upload` · `unit-economics` ·\n`replenishment-calculator` · `inventory-forecast` · `competitor-analysis` ·\n`competitive-pricing` · `regional-sales` · `weather-impact` · `seo-analytics` ·\n`product-card` · `design-system` · `product-photo-generation` · `review-analysis` ·\n`wildberries-api`.\n\nНавыки готовят черновики и рекомендации. Публикация карточки, изменение цен и любые необратимые\nоперации остаются за пределами текущей бесплатной поверхности.\n\n## Ограничения и честный статус\n\n- Конкуренты анализируются только по переданному или разрешённому источнику; полнота рынка не обещается.\n- Ценовой коридор описывает выборку, но не доказывает спрос или прибыльность.\n- Регион — только фактическое географическое поле источника, а не автоматически выведенный регион покупателя.\n- Погода показывает корреляцию совпавших рядов, а не причинное влияние и не прогноз продаж.\n- SEO — прозрачная эвристика контента, а не гарантия позиции, CTR или конверсии.\n- Внешние данные (конкуренты, погода) требуют совместимого API и соответствующей лицензии.\n\nПубличный MCP `https://wb.seller.bears.ru/mcp`, Seller OAuth 2.1/PKCE, reviewer sandbox и\nreviewed WB API contracts развёрнуты и функционально проверены. Публикация в каталоге\nChatGPT/OpenAI остаётся отдельным этапом: для неё нужны проверка домена, заполненный черновик\nкарточки и отправка на ревью оператором.\n\nПорядок подачи описан в [`docs/public-listing.md`](docs/public-listing.md), контракт MCP — в\n[`docs/mcp-contract.md`](docs/mcp-contract.md), архитектурные ограничения — в [`SPEC.md`](SPEC.md).\n\n## Документация\n\n- [Ландшафт конкурентов и источники](docs/competitive-landscape.md)\n- [Граница агентской идентификации](docs/identity-bridge.md)\n- [Доступ и mock-данные для ревьюера](docs/reviewer-access.md)\n- [Подача в каталог OpenAI](docs/openai-submission.md)\n- [Рекламный Playwright-сценарий](examples/marketing-video-playwright.json)\n- [Подача в каталог Claude](docs/anthropic-submission.md)\n- [Безопасность](SECURITY.md)\n- [Приватность](plugins/wildberries-agent-integration/PRIVACY.md)\n- [Условия использования](plugins/wildberries-agent-integration/TERMS.md)\n- [Поддержка](SUPPORT.md)\n- [История изменений](plugins/wildberries-agent-integration/CHANGELOG.md)\n- [Social preview 1280×640](assets/social-preview.png)\n\n\n<p align=\"center\">\n  <a href=\"https://app.alpic.ai/new/clone?repositoryUrl=https://github.com/BearsCLOUD/wildberries-agent-integration\">\n    <img src=\"https://assets.alpic.ai/button.svg\" alt=\"Deploy on Alpic\">\n  </a>\n</p>\n## Лицензия\n\nMIT — [LICENSE](LICENSE).\n",
  "bytes": 10819,
  "sha": "cdc7e8f08f18a887d9990b274dd4b98179563d58c7547318488bc6911c051c54",
  "repo_slug": "bearscloud/wildberries-agent-integration",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_bearscloud_wildberries_agent_i_d1b3bde6/readme"
}