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

mpstats-connector — скилл для Claude Code: установка и аналитика

Скилл mpstats-connector для Claude Code получает аналитику продаж и остатков товара на Ozon или Wildberries через MPStats. Запускается по запросу о продажах конкретного артикула или динамике за 30 дней.

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

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

Что делает mpstats-connector

Скилл запрашивает данные MPStats по SKU: графики заказов, цены и остатков за 30 дней, текущие цену и остаток, среднее число заказов в день и сведения о продавце и бренде. Отдельный запрос показывает запасы на складах FBS и FBO; несколько SKU можно сравнить одним вызовом.

Для работы нужны платный аккаунт MPStats, токен MPSTATS_MP_AUTH и запущенный сервер marketplace-mcp с подключёнными инструментами. Без токена инструменты возвращают ошибку auth_missing. Скилл ищет данные по SKU, а не по названию или категории; для простого просмотра цены и наличия без MPStats предусмотрены коннекторы wb_card и ozon_card.

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

  • получить график заказов товара за 30 дней
  • сравнить продажи нескольких SKU
  • узнать текущую цену и остаток товара
  • разобрать запасы по складам FBS и FBO

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

  • Покажи продажи и остатки товара на Ozon по артикулу 5107857210 за 30 дней.
  • Сравни динамику заказов этих SKU на Wildberries: sku1, sku2.
  • Раздели остатки товара на запасы FBS и FBO.

Как установить mpstats-connector

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/mpstats-connector/SKILL.md

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

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

Вопросы о mpstats-connector

Как установить mpstats-connector в Claude Code?

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

Что делает mpstats-connector?

Получает через MPStats аналитику продаж и остатков товаров на Ozon и Wildberries по SKU. Возвращает графики, данные о продавце и бренде, а также разбивку запасов по FBS и FBO.

Что нужно для работы mpstats-connector?

Нужны платный аккаунт MPStats, его JWT-токен в переменной MPSTATS_MP_AUTH и сервер marketplace-mcp с подключёнными инструментами.

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

SKILL.md · MIT
---
name: mpstats-connector
description: Use this skill for MPStats sales/stock analytics on a specific Ozon or Wildberries item — per-day sales, current price and stock, FBS/FBO warehouse split, seller/brand identity, and a rolling orders-per-day average. Trigger on "продажи товара на озон", "аналитика ozon sku", "mpstats по артикулу", "продажи за 30 дней", or English equivalents. Requires a paid MPStats account (MPSTATS_MP_AUTH env). Skip raw catalog price checks — use wb_/ozon_ connectors (no account needed).
---

# MPStats Connector

Paid-account sales/stock analytics for Ozon and Wildberries items, via the
MPStats browser-plugin API (`plugin.mpstats.io/pluginapi`). Unlike the
anonymous catalog connectors in this workspace, this one is **optional**: it
needs a paid MPStats account configured as the `MPSTATS_MP_AUTH` env var (the
raw `mp_auth` JWT cookie from a logged-in browser plugin session at
mpstats.io). Without it the server boots cleanly, every tool returns
`auth_missing`, and no other connector is affected — like every source here,
it is a pleasant extra you opt into, not a requirement.

## When to use

- Per-SKU 30-day **sales analytics** — orders graph, price graph, stock graph
- **Current price and stock** for an item (today's reading off the graph tail)
- **Warehouse stock split** — FBS (seller warehouse) vs FBO (marketplace warehouse)
- Seller/brand identity and a rolling **orders-per-day** average
- Sales-trend comparison across several SKUs in one batched call

## When NOT to use

- Bare price/availability checks with no account — use `wb_card` / `ozon_card`.
- Reviews, categories, seller tax identity — MPStats does not surface those; use
  the catalog connectors.
- Search by text or category browsing — MPStats analytics is keyed by SKU, not
  by query.

## Prerequisites

Set `MPSTATS_MP_AUTH` to the raw JWT (no `mp_auth=` prefix, no quotes):

```
export MPSTATS_MP_AUTH='eyJ0eXAiOiJKV1Qi...'   # from a logged-in mpstats.io session
```

Without it, every tool returns an `auth_missing` error (retryable: false) and
the server still boots cleanly. Treat the token as a secret: it identifies a
paid, quota-billed account. Never log it, never commit it.

## Tools available

- `mpstats_item(skus, place, oz_fbs=True)` — per-SKU 30-day analytics. Up to 100
  SKUs per call. Returns, per SKU: `seller`, `seller_id`, `brand`, `stock_now`,
  `price_avg_rub`, `orders_per_day`, `days_on_stocks`, `totals` (orders/sum/
  sum_prev), and four per-day graphs (`orders_graph`, `prices_graph`,
  `count_graph`, `rubrics_graph`).
- `mpstats_warehouses(skus, place)` — per-SKU warehouse stock split: `fbs`
  count, `fbo` total (collapsed from the upstream per-warehouse list), the raw
  `fbo_warehouses` list, and the upstream `last_update` timestamp.

**Not an MCP tool:** `mpstats_selfcheck()` is a tri-state health canary:
`success`, `drift_detected` (reachable but unparseable — code change needed), or
`inconclusive` (transport failure / missing auth — says nothing about the
parsers). It is CLI-only — `marketplace-mcp doctor` runs every connector's canary
at once.

## Marketplace parameter

`place` is `"ozon"` or `"wildberries"`. `oz_fbs` is an Ozon-specific
Fulfilled-by-Seller flag (default true); harmless for wildberries.

## Workflow patterns

**Sales snapshot for one Ozon item by SKU:**
1. `mpstats_item([5107857210], place="ozon")` — current price/stock + 30-day graphs
2. Read `price_avg_rub` and `stock_now` for today; sum `orders_graph` for the
   window total; compare `totals.sum` vs `totals.sum_prev` for trend.

**Compare a basket of SKUs:**
1. `mpstats_item([sku1, sku2, ...], place="ozon")` — batched, request-order
   preserved. A SKU MPStats has no data for surfaces as a `meta.warnings` entry,
   not a silent gap.

**Stock split (where the units physically sit):**
1. `mpstats_item([...], place="ozon")` for `stock_now` (total)
2. `mpstats_warehouses([...], place="ozon")` for the FBS/FBO split and
   `last_update` (when MPStats last refreshed the snapshot).

## Graph semantics (gotchas)

- Graphs are length `days` (default 30), **oldest-first**; the final cell is
  "today". The current price or stock is the last **non-zero** cell.
- Price and stock diverge on an all-zero graph, deliberately. `price_avg_rub`
  becomes `None`, because a false `0.0` would rank a delisted item as the
  cheapest. `stock_now` becomes `0`, because "none in stock" is a real reading.
  An **empty** graph gives `None` for both — that one is genuinely no data.
- A zero cell means **"no data for that day"**, not "the value was zero".
  Sum the graph for a real total; do not read a single cell as the answer.
- `totals.orders` / `totals.sum` are MPStats' own aggregates over the window —
  prefer them over hand-summing unless you need a custom sub-window.
- A missing value is always `None`, never `0`: a zero would rank a dead listing
  as the top seller — the exact bug this connector's parsers exist to prevent.

## Error format

On failure, raises `ToolError` with a JSON body: `{"error": "<code>",
"message": "...", "retryable": <bool>}`. Codes: `auth_missing` (no/expired
token — not retryable), `bad_request` (bad SKU/place), `rate_limited`
(retryable, honours `retry_after_s`), `transport_down`, `parser_drift`
(upstream shape changed — code change needed), `not_found` (no analytics for
any SKU). Partial data (some SKUs missing) stays a success with `meta.warnings`
and `meta.healthy: false` — silence never reads as success here.
## 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
connector's own tools and `marketplace_sources` 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

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

Все скиллы по теме «Данные и базы» →
mpstats mpstats-io Даёт агенту доступ к API MPSTATS: продажи, остатки, карточки товаров на Wildberries, Ozon и Yandex Market. Подключается в задачу исследования ниши или анализа конкурентов. CX Codex +1 766установок linkfox-mpstats-ozon-product-detail linkfox-ai Скилл linkfox-mpstats-ozon-product-detail для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode запрашивает полную карточку одного SKU на Ozon через MPSTATS. CX Codex +1 426установок linkfox-mpstats-ozon-product-search linkfox-ai Скилл linkfox-mpstats-ozon-product-search ищет товары Ozon по русскому ключевому слову или списку SKU через базу MPSTATS. Возвращает ID, название, бренд и продавца — отправная точка для разбора конкурентов. CX Codex +1 453установок Marketplaces MCP (RU) — Wildberries, Ozon, Yandex Market, Avito ilyautov MCP-сервер Marketplaces MCP (RU) — Wildberries, Ozon, Yandex Market, Avito для Claude Code подключает ИИ к кабинетам площадок через официальные API для анализа продаж, остатков и цен без ручной выгрузки отчётов. CX Codex +1 ★ 63звёзд репо parsee parsee-ru MCP-сервер parsee для сбора цен и скидок постоянного покупателя с Ozon и Wildberries. Помогает следить за витриной конкурентов прямо через диалог с ИИ-ассистентом. CX Codex +1 ★ 1звёзд репо netsuite-ai-connector-instructions Oracle NetSuite Скилл netsuite-ai-connector-instructions для Claude Code задаёт порядок выбора инструментов NetSuite, формат ответов и правила безопасности SuiteQL. Работает с живым аккаунтом через MCP-коннектор. CX Codex +1 863установок

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

Весь набор →
yandex-connector Скилл yandex-connector для Claude Code получает цены, рейтинги и отзывы с Яндекс Маркета. Запускается на запросы о цене товара, предложениях продавцов или отзывах. CX Codex +1 ★ 203звёзд репо wb-connector Скилл wb-connector для Claude Code получает данные Wildberries по запросу о товаре, продавце или категории. Он включается для проверки цены и остатков, анализа отзывов и сравнения SKU. CX Codex +1 ★ 203звёзд репо taobao-connector Скилл taobao-connector для Claude Code ищет товары на Taobao и читает карточки. Запускается на запросы о товарах, ценах и магазинах Taobao. CX Codex +1 ★ 203звёзд репо ozon-connector Скилл ozon-connector для Claude Code ищет товары на Ozon и собирает данные о карточках, ценах, рейтингах и отзывах. Запускается на запросы о поиске и сравнении товаров на маркетплейсе. CX Codex +1 ★ 203звёзд репо megamarket-connector Скилл megamarket-connector для Claude Code ищет товары на Megamarket и открывает карточки. Запускается по запросам о Megamarket, его каталоге или ценах. CX Codex +1 ★ 203звёзд репо marketplace Скилл marketplace для Claude Code помогает подключить единый MCP-сервер маркетплейсов и выбрать нужный маршрут. Запросы о сравнении цен он направляет в compare-prices, а задачи по одному источнику пропускает. 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звёзд репо

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

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