Skip to main content
Glama
wildberries-finances-mcp-server

wildberries-finances-mcp-server

by rcd27

WB Finances MCP Server

MCP сервер для работы с API Wildberries Finances.

  • Описаны все ручки из OpenAPI спецификации, выставлены как Tool (src/tools/api)

  • Добавлены некоторые "кастомные" Toolы (src/tools/custom)

Установка

npm install

Related MCP server: Wildberries API MCP Server

Настройка

  1. Создайте файл .env в корневой директории проекта(по примеру .env.example)

  2. Добавьте следующие переменные окружения:

    WB_FINANCES_OAUTH_TOKEN=your_oauth_token_here

Запуск

Разработка

npm run dev

Продакшн

npm run build
npm start

Дебаг

npx @modelcontextprotocol/inspector node ./build/index.js

Использование

Сервер предоставляет следующие инструменты:

  • getReportDetailByPeriod - Получение детализации по еженедельным отчётам реализации

  • getTotalCommissionByPeriod - Подсчёт отчислений в пользу WB + НДС за период

  • getDocumentCategories - Получение категорий документов

  • getDocumentList - Получение списка документов

  • downloadDocument - Загрузка одного документа

  • downloadDocumentsAll - Загрузка нескольких документов

  • generateWeeklyReport - Генерация еженедельного отчёта

Конфиг для Goose

Добавьте в конфиг Гуся(~/.config/goose/config.yaml):

  wildberries-finances-mcp:
    args:
    - /path/to/wildberries-finances-mcp-server/build/index.js
    bundled: null
    cmd: node
    description: null
    enabled: true
    env_keys: []
    envs: {}
    name: wildberries-finances-mcp
    timeout: 300
    type: stdio

Конфиг для Cline:

    "wildberries-finances-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 300,
      "command": "node",
      "args": [
        "/path/to/wildberries-finances-mcp-server/build/index.js"
      ],
      "type": "stdio"
    }

Безопасность

  • API ключ должен храниться в переменных окружения

  • Не включайте файл .env в систему контроля версий

  • Используйте разные API ключи для разработки и продакшена

Available Tools

8 tools
calculateReportMetricsC

Вычисляет основные метрики по отчёту

Inputs: dateTo (required), dateFrom (required), limit, rrdid.

downloadDocumentB

Метод загружает один документ из списка документов продавца

Inputs: extension (required), serviceName (required).

downloadDocumentsAllB

Метод загружает несколько документов из списка документов продавца

Inputs: params (required).

generateWeeklyReportC

Еженедельный отчёт по продажам и комиссиям

Inputs: dateTo (required), dateFrom (required), limit, rrdid.

getDocumentCategoriesC

Метод предоставляет категории документов для получения списка документов продавца

Inputs: locale.

getDocumentListC

Метод предоставляет список документов продавца

Inputs: endTime (required), beginTime (required), sort, order, +3 more.

getReportDetailByPeriodB

Метод предоставляет детализации к еженедельным отчётам реализации.

Данные доступны с 29 января 2024 года.

Важно!
Вы можете выгрузить данные в Google Таблицы

Ограничение:
Максимум 1 запрос в минуту на один аккаунт продавца

Inputs: dateTo (required), dateFrom (required), limit, rrdid.

getTotalCommissionByPeriodC

Подсчёт отчислений в пользу WB + НДС за период

Inputs: dateTo (required), dateFrom (required), limit, rrdid.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools are clearly distinct, especially document tools (getDocumentCategories, getDocumentList, downloadDocument, downloadDocumentsAll). However, report-related tools (getReportDetailByPeriod, getTotalCommissionByPeriod, generateWeeklyReport, calculateReportMetrics) have overlapping purposes that could cause misselection, though descriptions help differentiate them.

    Naming Consistency3/5

    All names are camelCase but use inconsistent verb prefixes (get, download, generate, calculate) and vary in structure (e.g., downloadDocumentsAll vs downloadDocument). This mixed convention reduces predictability, though the naming is still readable.

    Tool Count5/5

    Eight tools is an appropriate size for the Wildberries finances domain. The tool count is well-scoped, covering both report analysis and document management without unnecessary duplication or overwhelming the user.

    Completeness4/5

    The tool set covers essential operations: retrieving report details, calculating commissions, generating weekly reports, computing metrics, and managing documents. However, there is no explicit tool for listing available report periods or fetching raw sales data, which creates a minor gap in the workflow.

    Maintenance

    ActivityInactive
    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
      Not graded
      quality
      B
      maintenance
      MCP server that simplifies interaction with Wildberries API, providing unified access to analytics, promotion statistics, sales funnel data, search queries, stock reports, and EVIRMA PRO report imports.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables access to Wildberries marketplace feedback and questions, allowing listing accounts, filtering feedbacks, viewing statistics and ratings, and posting answers, with secure token management and throttling.
      -
    • 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