marketplace Skill
当操作员需要完整的市场挂载、路由元数据或客户端配置时使用此技能。触发词包括 "один MCP"、"все источники"、"marketplace_sources"、"настроить marketplace" 或 "full marketplace"。价格类问题如 "где дешевле" 和 "compare prices" 应路由到 compare-prices;单数据源任务请跳过。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
Unified Marketplace Server
One server mounting every installed connector as a namespaced toolset:
wb_, ozon_, yandex_, detmir_, avito_, taobao_, megamarket_*,
lamoda_, dns_, citilink_, aliexpress_, cian_, mpstats_ plus
compare_prices / compare_sources and its own marketplace_sources and
marketplace_health. Tool names keep their prefixes, so habits and configs
carry over — but the operator wires a single marketplace entry instead of
fourteen. The server exposes 41 tools with MPSTATS_MP_AUTH set and 39 without
it: the two mpstats_* tools are not mounted until the paid token is
configured, because without it every call would answer auth_missing.
When to use
- "Where is X cheapest" — compare_prices fans out across all searchable sources
- Client setup: one config entry, not fourteen
- Health overview: the CLI's
doctorruns every selfcheck at once - A source came back empty and you can't tell installed-but-quiet from never-loaded
→ marketplace_sources
- Planning a fan-out, or a call just failed with a CDP/transport error
→ marketplace_health first: is Chrome up, is the host cooling down
- A source wants a human at the browser →
marketplace_healthnames the page
Tools
marketplace_sources()— no arguments; returns `{mounted, skipped,
mounted_count, skipped_count, capabilities, needs_cdp, server_version}`.
capabilities is static routing metadata per source: access tier, CDP/login
requirements, currency, text-search support, and whether the connector is
mounted. needs_cdp is the sorted subset of mounted whose reads can go
through the operator's Chrome, so a dead browser is a reason to read
marketplace_health before spending a call. skipped maps a source name to
the reason it is unavailable: an import error (usually a missing dependency), a
missing credential its tools need (MPStats without MPSTATS_MP_AUTH), or a
MARKETPLACE_SOURCES deselection. Connectors are imported
defensively, so a missing dep removes a marketplace instead of killing the server —
but from the client an absent source looks identical to one that found nothing.
Call this to tell the two apart: a name in skipped was never queried at all.
marketplace_health()— no arguments; read-only transport health without
spending a navigation. Returns `{cdp, budget, handoffs, unblock,
server_version}. cdp` is the scraping Chrome as it answers on the configured
CDP address: reachable, host, port, version, page_targets, and a
short reason/error when it is down. budget is the shared navigation
budget: limits, in_flight, and per host `{refusals, open, retry_after_s,
opens} — an open host fails fast for retry_after_s more seconds. handoffs`
lists the retained challenge pages. unblock maps each mounted source with a
page to the URL a human opens in the scraping Chrome. The tool never starts
Chrome, opens or closes a tab, or touches a marketplace, and it never raises:
a broken part is reported inside the answer. It does not prove a source is up
— only a real call does.
Operator CLI
marketplace-mcp install [client]— print the exact mcpServers JSON to paste, or
write it into the client's own config file with --write (the old file is kept as
.bak-). From a source checkout it prints the real filesystem path
of that checkout, so there's no /path/to/ru-marketplace-mcp placeholder to
hand-edit; installed as a wheel, it prints the console-script paths on PATH
instead. The default block is one marketplace entry running the unified server;
--per-source prints one entry per source. client must be one of claude,
claude-code, cursor — an unknown name is rejected, not answered with a Claude
block.
marketplace-mcp doctor [--status-file path]— per-source health plus a CDP
session probe, with an optional machine-readable JSON snapshot for monitoring. Exit
codes are meaningful for cron and CI: 0 everything healthy, 1 a parser drifted
(the alarm — someone has to look), 2 nothing drifted but at least one source
couldn't be judged (blocked, no CDP, wrong region). "Couldn't check anything" is a
2, never a 0.
Gotchas
- Recovery-aware clients should read
source_outcomes.requires_user_action
before scheduling retries. Keep answered sources visible, show the affected
marketplace and challenge_type, and retry that source after the browser
interaction completes. A challenge is not an empty product search. See the
compare-prices skill for the retry contract. handoff_expires_at confirms that
the source retained its tab; repeat the same operation in the same MCP session
after browser action and before that expiry. See docs/CDP_SETUP.md for opt-in
configuration and supported sources.
- A source whose optional deps are missing is simply absent from the set —
marketplace_sources says which and why.
- Set
MARKETPLACE_SOURCESon the unified server to mount only a comma-separated
subset (wildberries,ozon,compare); unset or blank keeps every source. The
aliases wb, ym/yandex, detmir, and ali work too. Unknown names fail
at startup instead of silently producing a partial server, and deselected
sources are reported with a deselected reason.
- compare_prices ranks on everyday ruble prices; Taobao (CNY) is reported in
price_native but never ranked against rubles.
DSH activation
In DeepSeek Harness the default profile mounts compare-mcp, which exposes
exactly 4 tools: compare_prices, compare_sources, compare_verify_offer
and compare_browser_snapshot.
The middle decision-mcp profile adds decision_inspect (5 tools). This
skill's own tools — marketplace_sources and marketplace_health — and every
per-marketplace tool need RU_MARKETPLACE_MCP_FULL=1 and a profile restart;
do not call them in the default mode.