SuperAPI AI Directory
Partner with us中文AI newsFavorites
All toolsOther AI toolsmarketplaces-mcp-ru

marketplaces-mcp-ru

Wildberries and Ozon Seller APIs: sales, stock, prices, finance, reviews and ads, with a read/write/destructive safety gate and multi-store switching.

Open website

About this tool

Purpose

Marketplaces MCP RU is an MCP (Model Context Protocol) server that turns the seller APIs of Wildberries, Ozon, Yandex Market and Avito into tools that AI assistants can call directly. Users ask questions in their own words, and the assistant retrieves sales, order, stock, price, financial and review data directly from these channels' Seller APIs, instead of making up numbers by guessing, and without needing to operate through a browser.

Main capabilities

  • Covers four platforms: Wildberries Seller API, Ozon Seller API, Ozon Performance, Yandex Market Partner API, Avito API.
  • Provides 1022 schema-driven methods (generated from the official OpenAPI specifications), and uses generic meta-tools (prefixes wb_, ozon_, ozon_perf_, ym_, avito_) instead of one tool per endpoint, keeping the interface compact.
  • Provides typed tools for common tasks, such as wb_get_sales, wb_get_stocks, ozon_get_products, ozon_get_prices, ym_get_orders, ym_set_price, avito_get_orders, avito_update_stock, etc.
  • Built-in safety gates: each method is labeled in advance with a risk level—read (executes directly), write (requires confirm_write=true), destructive (requires confirm_write=true and i_understand_this_modifies_data=true). Operations that modify prices, stock, etc. require confirmation.
  • Supports multiple stores: multiple stores can be added and switched between during a conversation via *_add_cabinet / *_use_cabinet.
  • Preset scenarios for each platform: Wildberries has sales pulse, stock health, price audit, replenishment plan, ABC analysis, review summary; Ozon has out-of-stock risk, price analysis, unit economics, catalog sync, content audit, ABC and reviews; Yandex Market has out-of-stock risk, price analysis, review analysis, quality index; Avito has order confirmation, ad health, spend vs. performance, review analysis.

How to use

  • One-click install for Claude Desktop: download the .mcpb file from GitHub Releases and double-click it; Claude Desktop will install it automatically and ask for the key in the settings window.
  • Let AI install it: say "install marketplaces-mcp-ru" to Claude or Cowork.
  • Via the skills directory: npx skills add ilyautov/marketplaces-mcp-ru
  • Download and double-click: get marketplaces-mcp-ru-v<version>.zip from GitHub Releases, unzip it and double-click install.command (macOS) or install.bat (Windows), then enter the key.
  • Terminal install: git clone https://github.com/ilyautov/marketplaces-mcp-ru，然后 python3 install.py --client <client>.
  • Developer approach: npx -y marketplaces-mcp-ru or uvx marketplaces-mcp-ru; the standalone server commands are wb-mcp / ozon-mcp / ozon-perf-mcp / yandex-mcp / avito-mcp.
  • Docker: docker run -i --rm -e WB_API_TOKEN=… -e OZON_CLIENT_ID=… -e OZON_API_KEY=… ghcr.io/ilyautov/marketplaces-mcp-ru; for remote access you can add -e MCP_TRANSPORT=http -e MCP_HTTP_HOST=0.0.0.0 -p 8000:8000, the service is at http://…:8000/mcp。HTTP The mode does not include built-in authentication and must be protected with a proxy or firewall.
  • Key acquisition: For Wildberries, go to seller.wildberries.ru → Настройки → Доступ к API; for Ozon, go to seller.ozon.ru → Настройки → API-ключи; for Yandex Market, go to partner.market.yandex.ru → Настройки → Доступ к API (Api-Key); for Avito, go to avito.ru → Для бизнеса → Интеграции → API (client_id + client_secret). Keys are stored locally in ~/.marketplace-mcp/cabinets.json (chmod 600), and do not enter the repository or the conversation.

Use cases

Suitable for sellers operating on multiple Russian e-commerce platforms who want to use natural language to have an AI assistant query sales, inventory, prices, finance, and reviews, or perform controlled price and inventory modifications.

Limitations

  • Currently in alpha version. Core functions (sales, inventory, prices, finance, reviews) have been verified on real stores; the remaining methods are imported from specifications, the HTTP verbs are not necessarily accurate, and GET may be incorrectly labeled as POST.
  • Yandex Market and Avito were added in version 0.5.0. The catalog comes from the official OpenAPI documentation, but has not yet been actually run and verified on real stores, and field names may be incorrect.
  • Ozon API versions may change (list v3, attributes v4, prices v5); if a 404 is encountered, the version needs to be checked.
  • Ozon Performance is currently a catalog artifact plus an OAuth wrapper; the token endpoint contract has not been verified on a real machine.
  • The server runs locally, keys are stored locally, and any modification operation requires user confirmation. The project is open source under the MIT license.
  • Specific details such as pricing, fees, and supported platforms are subject to the project materials; the materials do not provide more information.

Related tools

Browse category