Skip to main content
Glama
WB MCP Server
by u1ch1

WB MCP Server

MCP-сервер (Model Context Protocol) для доступа к данным продавца Wildberries: список карточек товаров и отзывы покупателей. Написан на TypeScript, работает через stdio-транспорт и использует официальные Wildberries API.

Что такое MCP

MCP — это открытый протокол для подключения AI-ассистентов к внешним источникам данных и инструментам. Проще говоря, MCP позволяет таким приложениям, как Claude Desktop, вызывать ваши локальные программы и через них получать актуальную информацию — например, список товаров или отзывы из Wildberries.

Этот сервер реализует два MCP-инструмента:

  • get_products(limit, offset) — возвращает список карточек товаров продавца через Wildberries Content API.

  • get_product_reviews(nmId) — возвращает отзывы покупателей на товар по его nmId через Wildberries Feedbacks API.

Related MCP server: marketplace-mcp

Установка

npm install
cp .env.example .env   # вписать свой WB_API_KEY
npm run build

Подключение к Claude Desktop

Добавьте сервер в конфигурацию claude_desktop_config.json:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wb-mcp-server": {
      "command": "node",
      "args": ["/полный/путь/к/wb-mcp-server/dist/index.js"],
      "env": {
        "WB_API_KEY": "ваш_токен_продавца_Wildberries"
      }
    }
  }
}

Демо-режим и ограничения

Без WB_API_KEY сервер запускается и отвечает на initialize/tools/list, но вызовы get_products/get_product_reviews возвращают ошибку с понятным сообщением вместо падения. Это демонстрационный проект: код реализует правильную структуру запросов к официальному Wildberries API (Bearer-токен, эндпоинты Content/Feedbacks API), но не проверялся на реальном аккаунте продавца — для этого нужен собственный API-ключ.

Как это проверено

Сервер запущен как дочерний процесс, и через stdio отправлены реальные JSON-RPC запросы: initialize (успешный handshake), tools/list (обе схемы инструментов возвращаются корректно), tools/call для get_products без ключа (корректно возвращает isError: true с понятным сообщением, а не падает).

Available Tools

2 tools
get_product_reviewsA

Возвращает отзывы покупателей на товар по его nmId из Wildberries Feedbacks API.

Inputs: nmId (required).

get_productsA

Возвращает список карточек товаров продавца из Wildberries Content API. Параметры limit и offset работают как в классической пагинации.

Inputs: limit (required), offset.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools are clearly distinct: one retrieves product cards, the other retrieves customer reviews for a specific product. There is no overlap in purpose or target resource.

    Naming Consistency5/5

    Both tools follow a consistent 'get_<plural_noun>' pattern, making the naming predictable and uniform.

    Tool Count3/5

    With only two tools, the set feels minimal but not unreasonable for a narrow product-and-reviews scope. However, given the generic 'WB MCP Server' name implying broader Wildberries coverage, two tools is on the thin side.

    Completeness2/5

    The server exposes only read operations for products and reviews, with no coverage of other common Wildberries seller resources (orders, stocks, prices, etc.) and no lifecycle operations. Significant gaps exist for any seller-facing workflow beyond basic listing and review retrieval.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to Wildberries and Ozon seller accounts for real-time access to sales, stocks, prices, finances, and reviews through official APIs.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to read and work with Wildberries, Ozon, and Yandex Market seller accounts through typed tools, multi-account support, unified data schemas, rate limiting, audit, and encrypted credential storage.
      17
      51 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables read-only analytics and product search for a Wildberries seller account, covering items, advertising, sales, stock, reviews, finances, and tariffs through MCP clients like ChatGPT or Cursor.
      12
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Lets AI agents read and query Wildberries, Ozon, and Yandex Market seller accounts through unified typed tools, with multi-account support, rate limiting, and encrypted credentials.
      MIT