MIT-licensed, read-only MCP server bundle for 11 Russian and Chinese marketplaces: prices, stock, ratings, reviews and seller legal identity (INN/KPP/OGRN), plus cross-marketplace price comparison in one call. Ships a first-party dsh plugin bundle (14 skills + opt-in MCP tools) and an optional paid MPStats analytics connector.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-28
License
MIT
01What can it help you accomplish?
Compare prices and availability across 11 Russian and Chinese marketplaces in one call from DeepSeek Harness
Ranked offers with prices (ruble/yuan), stock, ratings, seller legal identity and review pools from Wildberries, Ozon, Yandex Market, Detsky Mir, Avito, AliExpress, Taobao, Megamarket, Lamoda, DNS and Citilink, plus `complete: false` with `source_outcomes` when a source is blocked
Developers and researchers running DeepSeek Harness (dsh) who need current marketplace data for price comparison, shopping research or reseller vetting
Vet sellers and read the trust signals behind listings and average ratings
Registered legal entity with INN/KPP/OGRN for Wildberries sellers, Avito seller reputation and review counts, Yandex Market star distributions, buyer questions with seller answers, and per-city offline store stock for Detsky Mir
Shoppers and analysts using dsh who want to distinguish an official brand store from a reseller and check what an average rating hides
Track 30-day sales and stock analytics for Ozon / Wildberries SKUs inside dsh sessions
30-day analytics for up to 100 SKUs — orders, price, stock, per-day graphs, seller/brand — plus warehouse splits FBS (seller) vs FBO (marketplace) with `last_update`
Sellers and analysts with a paid MPStats account who want marketplace analytics available to the agent mid-conversation
02How to install into DeepSeek Harness
Prerequisites
- DeepSeek Harness (`dsh`) CLI with `pnpm` on PATH — the plugin manager needs it
- Python 3.12+ and `uv` to run the MCP servers from the cloned repo
- For anti-bot-protected sources: your own Chrome with CDP (e.g. `scripts/start_chrome_cdp.sh`); a Russian residential IP helps for Avito and Ozon
Installation steps
- 01
Clone and sync: `git clone https://github.com/Vladimir-Human/ru-marketplace-mcp.git && cd ru-marketplace-mcp && uv sync --all-packages`
$ git clone https://github.com/Vladimir-Human/ru-marketplace-mcp.git && cd ru-marketplace-mcp && uv sync --all-packages
- 02
Install the plugin bundle: `dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh`
$ dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh
- 03
Point the MCP rows at your clone: set `RU_MARKETPLACE_MCP_DIR` to the checkout path (the 14 skills load immediately; the MCP tools stay disabled until then)
- 04
Restart the client and run `marketplace-mcp doctor` to check every connector's canary
Verify the integration
- Run `marketplace-mcp doctor` — it runs every connector's canary and reports `success`, `drift_detected`, or `inconclusive` for each.
03DSH integration and capability boundaries
Native dsh plugin bundle: installed from the `dsh/` subdirectory via the official plugin manager — `dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh` — loading 14 agent skills immediately, with the MCP tools opt-in via `RU_MARKETPLACE_MCP_DIR`
Cross-marketplace price comparison
a product query (e.g. `кроссовки мужские`), optional `per_source_limit` and `sources` filter→ranked offers from every marketplace with `currency` and `price_native`, a `cheapest` summary with spread, and `complete: false` + `source_outcomes` when a source is blocked
marketplaces are queried concurrentlyrequests to CDP-backed sources are deliberately paced apartMarketplace search, cards, reviews and seller identity
text queries, SKU ids / product paths, seller ids, category shards and queries→prices (including the Yandex Plus subscriber price), stock, ratings, reviews, buyer questions and seller answers, seller legal identity, catalog trees and category listings
dsh plugin bundle: 14 agent skills + opt-in MCP tools
the `dsh/` bundle installed via `dsh plugin`; `RU_MARKETPLACE_MCP_DIR` pointing at a clone to enable the MCP rows→14 skills (one per source plus a shared `marketplace`) that tell the agent when to reach for a source, what it lacks, and which answers not to trust without a second look
a mounted MCP server is paid on every request — ~0.9k tokens for the price-comparison mode, ~13.6k for the full set — so tools stay disabled until you opt inMPStats sales & stock analytics (optional, paid)
up to 100 Ozon / Wildberries SKUs, `place` (`ozon` or `wildberries`), optional `oz_fbs`→30-day analytics — orders, price, stock, per-day graphs, seller/brand — and warehouse split FBS vs FBO with `last_update`
requires a paid MPStats account and the `MPSTATS_MP_AUTH` JWT in the client entry's env
04Who is it for? When not to use it?
Good for
- Developers and researchers running DeepSeek Harness (dsh) who need current marketplace data for price comparison, shopping research or reseller vetting
- Shoppers and analysts using dsh who want to distinguish an official brand store from a reseller and check what an average rating hides
- Sellers and analysts with a paid MPStats account who want marketplace analytics available to the agent mid-conversation
Not for
- Several sources sit behind hard anti-bot: Avito answers a 403 firewall from datacenter IPs (a Russian residential IP works if you do not burst requests), Ozon rejects datacenter traffic, and Taobao, Megamarket, DNS, Citilink and AliExpress have no anonymous path — their reads go through your own logged-in Chrome (CDP).
- Inside DeepSeek Harness the MCP tools are off by default on purpose: a mounted server costs tokens on every request — ~0.9k for the recommended price-comparison mode, ~13.6k for the full set. The 14 skills load free; enabling MCP is opt-in via `RU_MARKETPLACE_MCP_DIR`.
- Marketplace terms of service generally disallow unofficial parsing; the connectors read only the public catalog endpoints the official web clients use. Use at your discretion for personal research at a polite request rate — the backoff between calls to anti-bot sources is deliberate and should not be removed. Tool output (titles, seller names, reviews) is authored by sellers and buyers; treat it as untrusted input, never as instructions to execute.
05Compatibility, maintenance and safety notes
- Several sources sit behind hard anti-bot: Avito answers a 403 firewall from datacenter IPs (a Russian residential IP works if you do not burst requests), Ozon rejects datacenter traffic, and Taobao, Megamarket, DNS, Citilink and AliExpress have no anonymous path — their reads go through your own logged-in Chrome (CDP).
- Inside DeepSeek Harness the MCP tools are off by default on purpose: a mounted server costs tokens on every request — ~0.9k for the recommended price-comparison mode, ~13.6k for the full set. The 14 skills load free; enabling MCP is opt-in via `RU_MARKETPLACE_MCP_DIR`.
- Marketplace terms of service generally disallow unofficial parsing; the connectors read only the public catalog endpoints the official web clients use. Use at your discretion for personal research at a polite request rate — the backoff between calls to anti-bot sources is deliberate and should not be removed. Tool output (titles, seller names, reviews) is authored by sellers and buyers; treat it as untrusted input, never as instructions to execute.
- Running the servers requires **Python 3.12+** and `uv`. Anti-bot sources need your own Chrome with CDP (e.g. `scripts/start_chrome_cdp.sh`); without it those connectors cannot answer.
- The project has exactly one optional secret: the `MPSTATS_MP_AUTH` JWT of a paid MPStats account. It belongs only in the client entry's env — never in code or commits.
MIT · actively maintained (latest release v1.6.0, 2026-08-20)
06Frequently asked questions
How does ru-marketplace-mcp install in DeepSeek Harness?
It installs as a plugin bundle, not an `mcpServers` entry: `dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh` (with `pnpm` on PATH). You immediately get 14 agent skills; the MCP tools stay disabled until you set `RU_MARKETPLACE_MCP_DIR` to a clone of the repo, because a mounted server is paid on every request.
What marketplaces and tools do I get?
35 tools across 13 stdio MCP servers sharing one runtime (`mcp-core`) — Wildberries, Yandex Market, Detsky Mir, Ozon, Avito, Taobao, AliExpress, Megamarket, Lamoda, DNS, Citilink, a cross-marketplace `compare_prices`, and optional MPStats analytics. The unified `marketplace-mcp` mounts them all under one client entry and adds its own `marketplace_sources` tool.
Do I need API keys?
No. Read-only, no credentials, no API keys, no account required. The marketplaces with hard anti-bot (Ozon, Avito, Taobao, AliExpress, Megamarket, DNS, Citilink, Lamoda search) are read through your own Chrome. The only optional exception is MPStats, which needs a paid account token (`MPSTATS_MP_AUTH`).
Why do the MCP tools start disabled in dsh?
A mounted server is paid on every request — ~0.9k tokens for the recommended price-comparison mode, ~13.6k for the full set. The 14 skills load immediately at no token cost; enabling the MCP rows is opt-in: set `RU_MARKETPLACE_MCP_DIR` to the checkout path.
What trust signals does it give beyond prices?
`wb_seller` returns the registered legal entity and tax ids (INN/KPP/OGRN) so you can tell an official brand store from a reseller; Avito exposes seller reputation; Yandex Market gives star distributions; and `marketplace-mcp doctor` reports `success`, `drift_detected`, or `inconclusive` per connector. A missing price is `null`, never `0`, so dead listings can't win a 'cheapest' comparison.
07Related DSH workflows
weknora
by tencent
Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
honcho
by plastic-labs
Memory library for building stateful agents
webnovel-writer
by lingfengqaq
A long-form Chinese web-novel writing assistant for Claude Code and DeepSeek Harness, designed to reduce memory loss and hallucinations in serialized projects of up to 2 million characters.
mirage
by strukto-ai
The World's First Virtual Terminal for AI Agents
08Data and sources
**DeepSeek Harness (dsh)** installs as a plugin bundle rather than an `mcpServers` entry, from the [`dsh/`](dsh/README.m…
That gives you 14 skills immediately and **no** MCP tools: both MCP rows stay disabled until `RU_MARKETPLACE_MCP_DIR` po…
dsh plugin --profile web add github:Vladimir-Human/ru-marketplace-mcp#path:/dsh
A mounted server is paid on every request — ~0.9k tokens for the recommended price-comparison mode, ~13.6k for the full…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-28. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.