К основному содержанию
скилл CX Codex

marketplace · vladimir-human — скилл для Claude Code: настройка и установка

Скилл marketplace для Claude Code помогает подключить единый MCP-сервер маркетплейсов и выбрать нужный маршрут. Запросы о сравнении цен он направляет в compare-prices, а задачи по одному источнику пропускает.

MIT ★ 203 обновлён 2026-10-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Vladimir-Human/ru-marketplace-mcp --skill marketplace -a claude-code
Открыть на GitHub

Что делает marketplace

Скилл объясняет, как подключить один сервер marketplace вместо отдельных записей для источников. Он описывает инструменты marketplace_sources для сведений о подключённых и пропущенных источниках и marketplace_health для состояния браузерного соединения и ограничений навигации. Запросы о самой низкой цене направляются в compare-prices.

Команда marketplace-mcp install [client] печатает настройки MCP или записывает их в конфиг клиента с флагом --write; marketplace-mcp doctor проверяет источники и сессию CDP. Для источников, которым нужен браузер, требуется запущенный Chrome с настроенным CDP. В CLI допустимы только claude, claude-code и cursor.

Инструменты MPStats подключаются только с платным токеном MPSTATS_MP_AUTH. Без него два инструмента MPStats не монтируются.

Какие задачи решает

  • подключить один MCP-сервер вместо отдельных записей для источников
  • узнать, какие источники подключены, а какие пропущены
  • проверить состояние CDP-сессии и доступность браузера
  • направить запрос о самой низкой цене в compare-prices

Примеры запросов агенту

  • Настрой единый MCP-сервер для маркетплейсов в Claude Code.
  • Покажи, какие источники подключены, а какие пропущены.
  • Сравни цены на товар во всех доступных источниках.

Как установить marketplace

1Через Skills CLI (Vercel)

npx skills add Vladimir-Human/ru-marketplace-mcp --skill marketplace -a claude-code

2Вручную: положить файлы

~/.claude/skills/marketplace/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/marketplace/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о marketplace

Как установить marketplace в Claude Code?

Выполни npx skills add Vladimir-Human/ru-marketplace-mcp --skill marketplace -a claude-code. Файл скилла находится по пути ~/.claude/skills/marketplace/SKILL.md.

Что делает marketplace?

Скилл помогает настроить единый MCP-сервер для источников и объясняет, как использовать сведения об источниках и состоянии соединения. Запросы о сравнении цен он направляет в compare-prices.

Что нужно для работы marketplace?

Для источников, использующих браузер, нужны запущенный Chrome и настроенный CDP. Инструменты MPStats требуют платный токен MPSTATS_MP_AUTH.

Исходный текст

SKILL.md · MIT
---
name: marketplace
description: Use this skill when the operator wants the full marketplace mount, routing metadata, or client setup. Trigger on "один MCP", "все источники", "marketplace_sources", "настроить marketplace", or "full marketplace". Route price questions such as "где дешевле" and "compare prices" to compare-prices; skip single-source tasks.
---

# 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 `doctor` runs 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_health` names 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
  `<file>.bak-<timestamp>`). 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_SOURCES` on 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.

© Vladimir-Human · MIT · Vladimir-Human/ru-marketplace-mcp

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — marketplace от других авторов.

marketplace официальный Vercel Labs Помогает находить и подключать интеграции Vercel Marketplace через CLI до написания кода приложения. Полезен для магазинов, платежей и мониторинга. CX Codex GP ChatGPT +1 14установок linkfox-mpstats-ozon-seller-products linkfox-ai Скилл linkfox-mpstats-ozon-seller-products для Claude Code показывает товары продавца на Ozon по sellerId: продажи, выручку, цены, рейтинг и остатки. Запускается для сортировки, фильтрации и сравнения магазинов. CX Codex +1 415установок mpstats mpstats-io Даёт агенту доступ к API MPSTATS: продажи, остатки, карточки товаров на Wildberries, Ozon и Yandex Market. Подключается в задачу исследования ниши или анализа конкурентов. CX Codex +1 766установок photo-editor mpstats Готовит визуалы для карточек маркетплейсов через MPSTATS Photo Editor API. Убирает фон, перекрашивает, апскейлит, собирает инфографику и фотосессии из нескольких кадров. CX Codex +1 657установок pp-facebook-marketplace user Скилл pp-facebook-marketplace управляет поиском, отслеживанием объявлений и ответами покупателям на Facebook Marketplace через отдельный CLI. Помогает продавцам вести переписку и готовить черновики. CX Codex +1 141установок linkfox-mpstats-ozon-category-products linkfox-ai Скилл linkfox-mpstats-ozon-category-products для Claude Code ищет товары внутри категории Ozon в России и показывает их метрики. Запускается для сортировки SKU, фильтрации и сравнения результатов. CX Codex +1 429установок connector-marketplace-strategy Samuel Berthe Скилл connector-marketplace-strategy помогает решить, стоит ли SaaS запускать свой маркетплейс приложений и коннекторов, и описывает модель работы: курирование, партнёры, правила, take-rate, посев. CX Codex +1 10 500установок

Из того же набора16

Весь набор →
taobao-connector Скилл taobao-connector для Claude Code ищет товары на Taobao и читает карточки. Запускается на запросы о товарах, ценах и магазинах Taobao. CX Codex +1 ★ 203звёзд репо ozon-connector Скилл ozon-connector для Claude Code ищет товары на Ozon и собирает данные о карточках, ценах, рейтингах и отзывах. Запускается на запросы о поиске и сравнении товаров на маркетплейсе. CX Codex +1 ★ 203звёзд репо mpstats-connector Скилл mpstats-connector для Claude Code получает аналитику продаж и остатков товара на Ozon или Wildberries через MPStats. Запускается по запросу о продажах конкретного артикула или динамике за 30 дней. CX Codex +1 ★ 203звёзд репо megamarket-connector Скилл megamarket-connector для Claude Code ищет товары на Megamarket и открывает карточки. Запускается по запросам о Megamarket, его каталоге или ценах. CX Codex +1 ★ 203звёзд репо lamoda-connector Скилл lamoda-connector для Claude Code ищет товары Lamoda и извлекает сведения из карточки. Поиск запускается по запросу о Lamoda, а карточка товара — по SKU или ссылке. CX Codex +1 ★ 203звёзд репо dns-connector Скилл dns-connector для Claude Code ищет электронику в каталоге DNS-Shop и открывает карточку товара. Для работы нужен Chrome оператора, подключённый через CDP. CX Codex +1 ★ 203звёзд репо detmir-connector Скилл detmir-connector для Claude Code получает цены и данные о наличии товаров из «Детского мира». Он включается для проверки товара или просмотра категории, но не для текстового поиска. CX Codex +1 ★ 203звёзд репо compare-prices Скилл compare-prices для Claude Code сравнивает цены на товар в поисковых источниках маркетплейсов. Запускается на запросы вроде «где дешевле» и «найди самую низкую цену». CX Codex +1 ★ 203звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой