Skip to content
Back to search

CustomWB_MCP

MCP server for Wildberries Statistics API (read-only), .NET

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dilovar--customwb-mcp/badge.svg)](/listings/dilovar--customwb-mcp)

HTML

<a href="/listings/dilovar--customwb-mcp"><img src="/api/listings/dilovar--customwb-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 152 lines
  1. # CustomWB_MCP — аналитический слой данных Wildberries (read-only)
  2. MCP-сервер на C# (ASP.NET Core), который отдаёт Claude данные кабинета WB для антикризисного аудита:
  3. продажи, финансы, остатки, цены, воронка, реклама, отзывы — объединённые по nmID, с паспортом данных.
  4. **Граница ответственности:** сервер только ЧИТАЕТ и агрегирует данные. Все расчёты (юнит-экономика,
  5. ABC, диагностика, рекомендации) и HTML-отчёт делает Claude в диалоге. Записывающих операций нет.
  6. ## Структура
  7. ```
  8. CustomWB_MCP/
  9. ├── CustomWB_MCP.csproj
  10. ├── Program.cs — DI, named HttpClient на каждый WB-домен, токен из user-secrets, /mcp
  11. ├── Wb/
  12. │ ├── WbClients.cs — домены WB по категориям
  13. │ ├── WbHttp.cs — GET/POST с ретраями (429 Retry-After, 5xx backoff)
  14. │ ├── JsonExtensions.cs — защищённый парсинг полей
  15. │ ├── DataPassport.cs — паспорт данных (получено/частично/нет прав/ошибка)
  16. │ ├── Models.cs — компактные DTO
  17. │ └── WbGateway.cs — типизированные read-only методы ко всем источникам
  18. └── Tools/
  19. ├── PingTool.cs — проверка связи
  20. ├── DataTools.cs — по-категорийные инструменты (каталог, продажи, остатки, финансы, цены, воронка, реклама, отзывы)
  21. └── AuditTool.cs — ФЛАГМАН wb_audit_dataset: единая таблица по SKU + паспорт
  22. ```
  23. ## 1. Токен WB
  24. В ЛК продавца создай токен (тип **Базовый**, доступ **Только чтение**) с категориями:
  25. **Контент, Статистика, Аналитика, Продвижение, Цены и скидки, Отзывы и вопросы**.
  26. Токен читается из конфигурации `Wildberries:Token`. Источник — на выбор, код один и тот же:
  27. **Вариант А — переменная окружения (работает и локально, и на сервере):**
  28. ```bash
  29. # Linux/macOS
  30. export Wildberries__Token="<твой токен>"
  31. # Windows PowerShell
  32. $env:Wildberries__Token="<твой токен>"
  33. ```
  34. Обрати внимание: в имени переменной **двойное подчёркивание** `__` вместо двоеточия.
  35. **Вариант Б — user-secrets (только для локальной разработки):**
  36. ```bash
  37. cd CustomWB_MCP
  38. dotnet user-secrets init
  39. dotnet user-secrets set "Wildberries:Token" "<твой токен>"
  40. ```
  41. Папка `user-secrets` **создаётся только после первой команды `set`** — пустой её не существует.
  42. Если не находишь — просто используй Вариант А, он проще и один для всех сред.
  43. ## 2. Запуск
  44. ```bash
  45. dotnet restore
  46. dotnet run
  47. ```
  48. Сервер: `http://localhost:5000`, MCP-эндпоинт: `/mcp`.
  49. ## 3. Локальная проверка (до Claude)
  50. ```bash
  51. npx @modelcontextprotocol/inspector
  52. ```
  53. Транспорт **Streamable HTTP**, адрес `http://localhost:5000/mcp`. Вызови `ping`, затем `wb_get_sales`,
  54. `wb_get_catalog`, и наконец `wb_audit_dataset`.
  55. ## 4. Публичный доступ — два пути
  56. ### Вариант A — Railway (рекомендуется: постоянный HTTPS, без ngrok)
  57. В проекте есть `Dockerfile` — Railway соберёт по нему.
  58. 1. Залей проект в репозиторий GitHub.
  59. 2. В Railway: **New Project → Deploy from GitHub repo** → выбери репозиторий.
  60. 3. Railway сам увидит `Dockerfile` и соберёт. Порт подхватится из `PORT` автоматически.
  61. 4. **Variables** → добавь:
  62. - `Wildberries__Token` = твой токен WB (двойное подчёркивание!)
  63. - `Mcp__Path` = `/mcp-<случайная строка>` — приватный путь (напр. `/mcp-9f3k2a`)
  64. 5. Railway выдаст публичный HTTPS-адрес вида `https://<app>.up.railway.app`.
  65. Твой MCP-эндпоинт = этот адрес + значение `Mcp__Path`, например:
  66. `https://<app>.up.railway.app/mcp-9f3k2a`
  67. Это и есть уход с публичного ngrok: адрес постоянный, токен в переменных окружения Railway,
  68. а неугадываемый путь закрывает эндпоинт от случайных заходов.
  69. ### Вариант Б — ngrok (быстрый тест с локальной машины)
  70. ```bash
  71. ngrok http 5000
  72. ```
  73. Если адрес сменился — удали и заново добавь коннектор в Claude с новым URL + путь.
  74. ---
  75. В обоих случаях: добавь/обнови коннектор в Claude с полным URL (адрес + путь),
  76. переподключи его в диалоге (список инструментов обновляется).
  77. ## 5. Аудит
  78. В диалоге с Claude (коннектор включён) дай аудит-промпт — Claude вызовет `wb_audit_dataset`
  79. и построит разбор по SKU и план.
  80. ## Инструменты
  81. | Инструмент | Что отдаёт |
  82. |---|---|
  83. | `ping` | проверка связи |
  84. | `wb_get_catalog` | полный каталог (включая товары без продаж) |
  85. | `wb_get_sales` | сводка продаж за период |
  86. | `wb_get_stocks` | остатки по складам/SKU |
  87. | `wb_get_finance` | детализация реализации (к перечислению, логистика, хранение, штрафы) |
  88. | `wb_get_prices` | цены и скидки |
  89. | `wb_get_funnel` | воронка показы→корзина→заказы→выкуп |
  90. | `wb_get_ad_stats` | расход рекламы, показы, клики, заказы |
  91. | `wb_get_feedbacks` | рейтинг и число отзывов |
  92. | `wb_get_orders` | заказы за период (спрос, отдельно от выкупа) |
  93. | `wb_get_incomes` | поставки и товар в пути |
  94. | `wb_get_warehouse_remains` | остатки по складам (async-отчёт) — для распределения отгрузок |
  95. | `wb_get_paid_storage` | платное хранение (async-отчёт) — расход |
  96. | `wb_get_weekly_pnl` | **еженедельный P&L по отчётам о реализации (до себестоимости)** |
  97. | `wb_audit_dataset` | **единая таблица по SKU + паспорт данных** |
  98. Категория токена для новых инструментов: заказы/поставки/P&L — **Статистика**; склады/хранение — **Аналитика**.
  99. ## Важное
  100. - **Токен нигде не светится** — только в заголовке запроса из сервера; в ответы, логи и HTML не попадает.
  101. - **Паспорт данных** в каждом ответе: пустой ответ или отказ прав — это НЕ «ноль продаж».
  102. - **Лаги:** воронка −20–30 мин, реклама не за сегодня, финотчёт по неделям.
  103. - **Безопасность:** токен охватывает финансы. На публичном ngrok это критичная экспозиция даже при read-only.
  104. Перед регулярной работой поставь OAuth на коннектор или уведи эндпоинт с публичного ngrok. Первый прогон — короткой сессией.
  105. ## Чего сервер НЕ делает (данные приходят иначе)
  106. - **Себестоимость, упаковка, налоги** — API не отдаёт; подкладывай CSV, join по nmID делает Claude.
  107. - **Джем / сравнение карточек конкурентов** — через обычный токен недоступно; грузи выгрузкой XLSX.
  108. ## Проверить при первом запуске (схемы WB местами расходятся между версиями)
  109. Поля читаются защищённо, но если какой-то источник вернёт пусто при явном наличии данных —
  110. сверь путь/поля со Swagger на https://dev.wildberries.ru/en/openapi/api-information. Кандидаты на сверку:
  111. воронка v3 (имена полей в `statistic.selected`), finance detailed (v5 statistics-api vs finance-api),
  112. цены `/api/v2/list/goods/filter`.
  113. ## Следующие решения (пока НЕ реализованы — требуют твоего выбора)
  114. - **Записывающий слой** (ответы на отзывы, корректировка ставок) — только через подтверждение человеком на каждое действие, с логом. Массовую смену цен, автосоздание поставок и акции в автономию не отдавать.
  115. - **Мульти-кабинет** — переключение токена/кабинета и консолидированная картина по твоим четырём кабинетам. Смена архитектуры (хранение нескольких токенов), поэтому отдельным заходом.
  116. - **Поисковые запросы и география спроса** — менее стабильные эндпоинты аналитики, сверить со Swagger перед реализацией.
  117. - **OAuth на коннекторе / уход с публичного ngrok** — условие перед регулярной работой с реальным токеном.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.