Vladimir-Human/ru-marketplace-mcp#dsh

Девять российских маркетплейсов и китайский Taobao как MCP-серверы: Wildberries, Ozon, Яндекс Маркет, Детский мир, Авито, Мегамаркет, Lamoda, DNS, Ситилинк. Плюс сравнение цен по всем сразу. Только чтение, ключи не нужны.

Bundle verified MIT Python v1.5.1
Bundle verified

Listed

64

Skill

Bundle verified

Versionv1.5.1
LanguagePython
LicenseMIT
View on GitHub

Preview

What it does

Skills and optional MCP rows for ten Russian marketplaces: price comparison across Wildberries, Detsky Mir and Yandex Market, plus per-source search, product cards and reviews. The 13 skills load on install; both MCP rows stay disabled until RU_MARKETPLACE_MCP_DIR points at a local clone, which needs Python 3.12+ and uv.

Best for

  • Shoppers and researchers comparing prices across Wildberries, Detsky Mir, and Yandex Market.
  • Workflows that need source-specific searches, product details, availability, seller information, or reviews across Russian marketplaces.
  • Users able to supply a local clone and, where necessary, their own logged-in Chrome session for anti-bot-protected sources.

Not ideal for

  • Turnkey use without local setup: the MCP rows are disabled until RU_MARKETPLACE_MCP_DIR points to a clone with Python 3.12+ and uv.
  • Reliable access from datacenter or non-Russian IPs to Avito, or access to Taobao and Megamarket without active marketplace logins.
  • Bulk harvesting or redistribution workflows; the connectors are intended for polite, read-only personal research and may conflict with marketplace terms.

README

ru-marketplace-mcp

CI Python 3.12+ License: MIT MCP

MCP-серверы для российских и китайских маркетплейсов. Цены, наличие, рейтинги, отзывы и реквизиты продавцов с Wildberries, Ozon, Яндекс Маркета, Детского мира, Авито, Taobao, Мегамаркета, Lamoda, DNS и Ситилинка. Плюс сравнение цен по всем источникам одним вызовом.

Только чтение. Ключи API, токены и регистрация не нужны — площадки с жёстким анти-ботом читаются через ваш собственный Chrome. Одно исключение по желанию: опциональный MPStats берёт платный токен (MPSTATS_MP_AUTH) — без него всё остальное работает как прежде.

English version below · Архитектура · Как добавить источник · Про анти-бот


Что внутри

Сервер Инструментов Что нужно, чтобы читалось Что умеет
Wildberries 9 анонимный HTTP Поиск, карточки, отзывы, вопросы о товаре, реквизиты продавца, каталог и товары категории
Яндекс Маркет 3 анонимный HTTP Цены разных продавцов, разбивка оценок по звёздам, отзывы
Детский мир 4 анонимный HTTP Детские товары, наличие в офлайн-магазинах, категории
Ozon 4 ваш Chrome; с домашнего IP часто и без него Поиск, карточки, отзывы
Авито 4 ваш Chrome + российский домашний IP и запросы вразрядку — иначе блок по IP Поиск объявлений, карточки, репутация продавца
Taobao 3 ваш Chrome с активным входом в Taobao Поиск и карточки, цены в юанях
Мегамаркет 3 ваш Chrome с активным входом — анонимной сессии API отдаёт пусто Поиск и карточки через мобильный API
Lamoda 3 карточки анонимно (GraphQL), поиск — ваш Chrome Поиск, карточки с размерами
DNS 3 ваш Chrome (Qrator) Поиск и карточки электроники
Ситилинк 3 ваш Chrome (Qrator) Поиск и карточки электроники
Сравнение 2 опрашивает всё перечисленное «Где дешевле?» одним вызовом
MPStats 3 платный аккаунт MPStats, cookie mp_auth (опционально) Продажи/остатки/графики за 30 дней по SKU Ozon/WB, остатки по складам (FBS/FBO)

Читается анонимно, без браузера: Wildberries, Яндекс Маркет, Детский мир и карточки Lamoda. Остальным нужен ваш залогиненный Chrome (CDP). Taobao и Мегамаркет вдобавок требуют активного входа в саму площадку — без него Taobao упирается в стену логина, а Мегамаркет отдаёт пустой ответ. Авито ещё и блокирует по IP: с датацентрового адреса это глухой отказ, с российского домашнего — работает, если не частить запросами. Запросы к CDP-источникам идут вразрядку: очередь подряд без пауз роняет их (DNS и Taobao в проверке так и деградировали), поэтому коннекторы держат паузу между вызовами сами. Точное состояние из вашей сессии покажет marketplace-mcp doctor.

MPStats стоит особняком: это единственный платный источник. Без MPSTATS_MP_AUTH сервер запускается, но инструменты отвечают auth_missing — поэтому он опционален и подключается по желанию, на остальные двенадцать серверов он не влияет никак.

Всего 33 инструмента в 12 серверах на общем рантайме mcp-core. Плюс объединённый marketplace-mcp, который монтирует всё разом — одна запись в конфиге клиента вместо двенадцати. Он добавляет свой инструмент marketplace_sources (какие коннекторы поднялись, а какие отвалились и почему), так что в нём 34 инструмента: 33 смонтированных плюс этот.

Быстрый старт

Нужны Python 3.12+ и uv.

git clone https://github.com/Vladimir-Human/ru-marketplace-mcp.git
cd ru-marketplace-mcp
uv sync --all-packages
uv run pytest -q -m "not live and not cdp"   # 1182 офлайн-тестов, сеть не нужна

Проверка живого эндпоинта:

uv run python -c "
import asyncio
from wb_connector.server import wb_selfcheck
print(asyncio.run(wb_selfcheck()).status)   # ждём success
"

Подключение к MCP-клиенту

Каждый сервер — консольная команда, поэтому пути в конфиге не зашиваются.

Frequently Asked QuestionsFAQ

Use the verified command dsh plugin --profile default add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.