Skip to main content

ru-marketplace-mcp/dsh

66Stars10Forks5Issues2Watchers

DSH plugin package injects 14 skills and 2 on-demand MCP client lines into the host for querying prices, inventory, reviews, and cross-platform price comparison on Russian and Chinese e-commerce platforms.

Evidence4/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki
Language
Python
License
MIT
Branch
main
aliexpressavitocitilinkclaudedetsky-mirdnsdsh-pluginlamoda

Install

cmdweb profile
$ dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:dsh

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin Vladimir-Human/ru-marketplace-mcp/dsh for me: review the repository at https://github.com/Vladimir-Human/ru-marketplace-mcp first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Description

This is the ru-marketplace-mcp repository plugin package for DeepSeek Harness. It injects 14 AI skills and 2 MCP client rows into DSH, enabling AI assistants to query prices, inventory, reviews, and seller credentials across 12 Russian/Chinese e-commerce platforms including Wildberries, Ozon, Yandex Market, Detsky Mir, Avito, Taobao, Megamarket, Lamoda, DNS, Citilink, AliExpress, and MPStats, with support for one-click cross-platform price comparison.

Core Capabilities

  • Injects 14 skills (split by platform + cross-platform comparison + unified service), each skill is a human-written "instruction manual" that allows AI to automatically determine which tool to call
  • Default "lightweight comparison" mode (2 tools, approximately 0.9k token per request), can be used by asking "where to buy cheaper" in one sentence
  • Optional switch to "complete unified service" mode (36 tools, approximately 13.6k token per request), covering queries, details, reviews, seller credentials, sales analysis
  • Provides cross-platform price comparison tools: simultaneously query 10 searchable platforms including Wildberries, Ozon, Yandex Market, sort by price and show price differences
  • Allows AI to query Wildberries, Yandex Market, Detsky Mir and Lamoda product cards without login (anonymous HTTP channel)
  • Reads anti-scraping protected platforms including Ozon, Avito, Taobao, Megamarket, Lamoda Search, DNS, Citilink, AliExpress via local Chrome (CDP protocol)
  • Provides MPStats paid plugin interface (optional), fetching Ozon/WB product sales curves for the last 30 days, inventory breakdown and seller identity

Technical Implementation

  • Language: Python 3.12+ (server runtime), started via uv
  • Key Dependencies: fastmcp (MCP protocol), pydantic (data models), uv package manager (dependency resolution and process startup), Playwright (CDP fallback channel)
  • Architecture Pattern: DSH plugin injects 3 lines via dsh/cordis.patch.yml — 1 @deepseek-ai/dsh-skill-filesystem (mounts 14 skill directories) + 2 @deepseek-ai/dsh-mcp-client (mutually exclusive compare and full client rows), MCP service starts Python process via uv run --frozen --directory <path>
  • Entry Files: dsh/package.json declares bundle patch, dsh/cordis.patch.yml contains full injection logic, 14 SKILL.md files under dsh/skills/ provide skill descriptions

Use Cases

Ordinary users in DSH need to query prices, inventory, reviews of Russian or Chinese e-commerce platforms, or compare which platform is cheaper, or check if a seller is legitimate — all without manually opening websites. DSH's AI assistant can automatically determine which platform's tools to call based on user's natural language queries. For example, when doing proxy purchasing, cross-border shopping or price monitoring, you can use the comparison tool to get quotes from 10 platforms at once; when doing e-commerce analysis, you can enable full mode to get reviews, seller credentials and sales data.

Prerequisites and Compatibility

DependencyMinimum VersionDescription
DSHNot declareddsh/package.json does not declare engines field
Python3.12+Parent repository pyproject.toml:6 declares requires-python
uvLatestUsed to start MCP service via uv run --frozen --directory <clone path>
PlatformCross-platformmacOS / Windows / Linux can all start Python processes
Native ModulesNonePure Python package, dependencies resolved via uv; Playwright/curl_cffi are Python dependencies, not Node.js native modules

Installation

dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp/dsh

After installation, you also need to:

  1. Clone the repository locally: git clone https://github.com/Vladimir-Human/ru-marketplace-mcp.git && cd ru-marketplace-mcp && uv sync --frozen
  2. Set environment variable RU_MARKETPLACE_MCP_DIR pointing to the cloned directory
  3. Restart DSH profile

To enable the full 36-tool service (instead of default 2 comparison tools), also set RU_MARKETPLACE_MCP_FULL=1.

Configuration Options

ConfigTypeDescriptionDefault
RU_MARKETPLACE_MCP_DIRPath env varPoints to locally cloned ru-marketplace-mcp directory, also acts as switch to enable MCP serviceNot set
RU_MARKETPLACE_MCP_FULLToggle env varSet to 1 to switch to full 36-tool mode; unset for lightweight comparison mode (2 tools)Not set
MPSTATS_MP_AUTHJWT stringMPStats paid account's mp_auth cookie value (raw JWT, without mp_auth= prefix); when not set, MPStats tools return auth_missing, other platforms unaffectedNot set
CHROME_CDP_HOSTHost addressCDP client Chrome remote debugging listening address, used for platforms requiring CDP like Ozon/Avito127.0.0.1
CHROME_CDP_PORTPort numberChrome remote debugging port number9222
CHROME_STEALTH0 or 1Whether to enable Chrome anti-detection mode (on Windows, hides window off-screen)1
CHROME_HEADLESS0 or 1Whether to start Chrome in headless mode (anti-scraping systems can detect headless mode, use with caution)0
CHROME_BINARYPathChrome/Chromium executable pathAuto-detect per platform
CHROME_SCRAPING_PROFILEPathDedicated Chrome profile directory (to avoid polluting daily profile)Platform default
COMPARE_SOURCE_TIMEOUTSecondsMaximum wait time for single platform during cross-platform comparison45

FAQ

Q: After installation I only see 14 skills, but don't see the comparison tool. What should I do?

A: This is normal. The 2 MCP client rows are disabled by default, only one is enabled after setting RU_MARKETPLACE_MCP_DIR. After setting, restart DSH profile, and the skill list will show either compare_prices (lightweight mode) or 36 tools like wb_*/ozon_* (full mode).

Q: Can compare mode and full mode be enabled simultaneously?

A: No. The two client rows are mutually exclusive — one has disabled condition !process.env.RU_MARKETPLACE_MCP_FULL, the other has !!process.env.RU_MARKETPLACE_MCP_FULL, so only one activates at a time. To switch, change the environment variable and restart profile.

Q: Getting "uv: command not found" error. What should I do?

A: uv package manager is not installed on the system. Install the latest version following https://docs.astral.sh/uv/.

Q: Do I have to clone the repository? Can I use pip install?

A: DSH's patch starts the service via uv run --frozen --directory <path>, so a local clone path is required. The repository also publishes a GHCR image (ghcr.io/vladimir-human/ru-marketplace-mcp), you can modify the patch command to use the Docker image instead.

Q: Comparison results show price_rub: null. Is this a bug?

A: No. Null means "that platform has no price data for this product" — it may be out of stock, inventory empty, or seller didn't set a price. It won't be 0. To know which platform is "missing", you can call the marketplace_sources tool, which lists which platforms loaded successfully and which were skipped due to missing dependencies.

Q: Some platforms return blocked. What should I do?

A: Platforms like Avito, Ozon, Megamarket block data center IPs by region. You need to access from Russian residential IPs and slow down request rate (Avito will ban you directly if queried multiple times in a short time). The marketplace-mcp doctor self-check script will tell you which platforms are blocking your current environment.

Q: How to uninstall?

A: Run dsh plugin --profile web remove ru-marketplace-mcp-dsh, then restart profile. The locally cloned ru-marketplace-mcp repository can be kept or deleted, it won't affect DSH.

Q: When using full mode, the AI prompt token usage is very high?

A: Yes. Each request is approximately 13.6k token because DSH puts all 36 tool schemas into the session context. If you only occasionally compare prices, it is recommended to temporarily set RU_MARKETPLACE_MCP_FULL=1 then switch back.

Learning Curve

Beginner — The 14 skills themselves are "instruction manuals", the AI assistant can directly determine which tool to call; ordinary users only need to configure environment variables. Sufficient for daily use, but advanced level required for deploying CDP channel in CDN encapsulation or containers.

Known Issues and Limitations

  • Wildberries search result prices are slightly higher than actual product card prices (measured 2026-07-28: 60,571 vs 60,275), if the price difference between two candidate products is within 1%, use wb_card to confirm again
  • Wildberries search pagination loops back to first page at the end (HTTP 200, no error), deduplicate by nm_id when paginating
  • Complete mode uses approximately 13.6k token per request (36 tool schemas), recommended to enable on demand; compare mode only uses 0.9k token
  • Avito, Megamarket, Taobao, AliExpress, DNS, Citilink platforms require external Chrome via CDP coordination; these features are completely unavailable when Chrome is not started
  • Outside of Russia or on data center IPs, platforms like Ozon/Avito will directly reject requests, must access from Russian residential IPs
  • Detsky Mir has no text search API, comparison results will skip it, need to use detmir_category to browse by category separately
  • Yandex Market Plus member prices (25-30% lower than regular prices) will never participate in price comparison sorting, to avoid "fake cheap"
  • Taobao prices are reported in CNY, price_rub field is null, they won't enter RUB price sorting — CNY to RUB requires manual conversion at current exchange rate, the plugin won't hardcode exchange rates
  • WB reviews and questions are indexed by imt_id (aggregated product ID) rather than nmId (single SKU ID), must first use wb_root_info(nmId) to get imt_id before querying reviews

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/Vladimir-Human/ru-marketplace-mcp/dsh)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory