Agent skill

Mpstats Connector

by Vladimir-Human in Vladimir-Human/ru-marketplace-mcp

A skill your agent uses 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…

MITAuto-check passedMedia & Creative

Install Mpstats Connector

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Vladimir-Human/ru-marketplace-mcp mpstats-connector --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Vladimir-Human/ru-marketplace-mcp.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mpstats-connector .claude/skills/mpstats-connector && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mpstats-connector
GitHub stars
139
Token cost
~1.4k tokens
SKILL.md length
681 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses 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…

  • Works in 2 steps: mpstats_item([5107857210], place="ozon")… → Read price_avg_rub and stock_now for…
  • MPStats sales/stock analytics on a specific Ozon
  • SKILL.md covers When to use, When NOT to use, Prerequisites and Tools available, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Mpstats Connector is an agent skill from Vladimir-Human/ru-marketplace-mcp. 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 (MPSTATSMPAUTH env). Skip raw catalog price checks — use wb/ozon connectors (no account needed).

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Brand strategy and identity. The repository describes itself as: Одиннадцать маркетплейсов и недвижимость Циан как MCP-серверы: Wildberries, Ozon, Яндекс Маркет, Детский мир, Авито, AliExpress, Taobao, Мегамаркет, Lamoda, DNS, Ситилинк, Циан… The licence is MIT.

When your agent uses it

  • MPStats sales/stock analytics on a specific Ozon
  • Wildberries item — per-day sales
  • Current price and stock
  • FBS/FBO warehouse split

Example prompts

  • “аналитика ozon sku”
  • “mpstats по артикулу”
  • “/mpstats-connector”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit c17bd36. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mpstats Connector loads about 1.4k tokens when it runs. Until then it costs about 124 tokens; SKILL.md has 681 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~124
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Vladimir-Human/ru-marketplace-mcp at commit c17bd36, republished under its MIT licence (© Vladimir-Human). 681 words, ~1,446 tokens.

Download SKILL.mdSave it as .claude/skills/mpstats-connector/SKILL.md (or your agent's skills folder).
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).
Show full SKILL.md (247 more words)Show less

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 exposes only compare_prices and compare_sources through the cheap compare mount. Per-marketplace tools and marketplace_sources require RU_MARKETPLACE_MCP_FULL=1 and a profile restart; do not call them in the default mode.

© Vladimir-Human, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/mpstats-connector of Vladimir-Human/ru-marketplace-mcp.

Open the folder on GitHubat commit c17bd36

Compare with similar skills

Mpstats Connector next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mpstats Connector compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mpstats Connector this skillVladimir-Human/ru-marketplace-mcp139—~1.4kAutomated safety check: PassMIT
Yushio ViLynnouo/yushio221—~4.7kAutomated safety check: PassMIT
Design Masterminhnv0807/ai-business-skills610—~4.6kAutomated safety check: PassMIT
Resend Design Skillsgrowupanand/ConvoForm1021 repos~210Automated safety check: PassApache-2.0
Directautonomous-ai/openharness1.2k—~820Automated safety check: PassMIT
Resend Brandgrowupanand/ConvoForm1021 repos~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Yushio Vi

    Lynnouo/yushio

    Triggers — CN: 做一套VI · 做个VI · 品牌视觉识别 · VI提案 · VI设计 · 视觉识别系统 · 品牌画册 · brand book · 做品牌形象 · logo+吉祥物+周边整套 | EN: build a VI · brand identity system · VI proposal · brand guidelines · brand book · full…

    221 GitHub stars~4.7k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • Design Master

    minhnv0807/ai-business-skills

    Handles eight kinds of marketing visual requests, from logos and campaign key visuals to infographics and quote graphics, by generating images or writing paste-ready prompts.

    610 GitHub stars~4.6k tokensUpdated 27 days ago
    Media & CreativeAuto-check passed
  • Resend Design Skills

    growupanand/ConvoForm

    A skill your agent uses when needing Resend design resources.

    102 GitHub starsUsed in 1 repo~210 tokens
    Media & CreativeAuto-check passed
  • Direct

    autonomous-ai/openharness

    Create and revise a usable brand identity and coordinated launch materials from a business brief, using the Forme project and the person's own artwork, text and production requirements.

    1.2k GitHub stars~820 tokensUpdated today
    Media & CreativeAuto-check passed
  • Resend Brand

    growupanand/ConvoForm

    A skill your agent uses when creating Resend marketing materials, documents, presentations, or visual content.

    102 GitHub starsUsed in 1 repo~1.4k tokens
    Media & CreativeAuto-check passed
  • Ads Dna

    AgriciDaniel/claude-ads

    Extract a public-safe brand and offer profile for paid advertising from an authorized website and operator input.

    9.8k GitHub stars~279 tokensUpdated 2 days ago
    Media & CreativeAuto-check passed

More from Vladimir-Human/ru-marketplace-mcp

All 12 skills in this repo
  • Citilink Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Citilink electronics data — search or a product card.

    139 GitHub stars~927 tokensUpdated 4 days ago
    Auto-check passed
  • Aliexpress Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator asks to search AliExpress or read one of its product cards.

    139 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Avito Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Avito classifieds data — search listings, item cards, or seller reputation.

    139 GitHub stars~950 tokensUpdated 4 days ago
    Auto-check passed
  • Cian Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Russian real-estate data from Cian (cian.ru) — flats, rooms, houses or commercial property for sale, long-term rent or daily rent, or one offer's card…

    139 GitHub stars~2.1k tokensUpdated 4 days ago
    Auto-check passed
  • Compare Prices

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator asks where something is cheapest across marketplaces.

    139 GitHub stars~2.5k tokensUpdated 4 days ago
    Auto-check passed
  • Detmir Connector

    Vladimir-Human/ru-marketplace-mcp

    A skill your agent uses when the operator needs Detsky Mir data — prices and availability for kids' and baby goods, toys, strollers, nappies, kids' clothing.

    139 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed

Questions about Mpstats Connector

What does Mpstats Connector do?

A skill your agent uses 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…. Mpstats Connector is an agent skill from Vladimir-Human/ru-marketplace-mcp. 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.

When should I use Mpstats Connector?

Mpstats Connector fits situations like: MPStats sales/stock analytics on a specific Ozon; wildberries item — per-day sales; current price and stock; FBS/FBO warehouse split.

How do I install Mpstats Connector in Claude Code?

Run `npx skills add Vladimir-Human/ru-marketplace-mcp --skill mpstats-connector -a claude-code`. Or copy the skill folder (skills/mpstats-connector in Vladimir-Human/ru-marketplace-mcp) into .claude/skills/mpstats-connector in your project. Claude Code loads it when a task matches its description.

How do I install Mpstats Connector in Codex?

Run `npx skills add Vladimir-Human/ru-marketplace-mcp --skill mpstats-connector -a codex`. Or copy the skill folder (skills/mpstats-connector in Vladimir-Human/ru-marketplace-mcp) into .agents/skills/mpstats-connector in your project. Codex loads it when a task matches its description.

Can I use Mpstats Connector in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Vladimir-Human/ru-marketplace-mcp --skill mpstats-connector -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mpstats-connector, .gemini/skills/mpstats-connector, .github/skills/mpstats-connector and .opencode/skills/mpstats-connector in your project.

What does Mpstats Connector need to run?

SKILL.md names no scripts, command-line tools or credentials: Mpstats Connector is instructions for the agent only.

Does Mpstats Connector access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mpstats Connector safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mpstats Connector use?

Mpstats Connector is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mpstats Connector use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mpstats Connector?

Skills that share tags, products or a category with Mpstats Connector: Yushio Vi (Lynnouo/yushio, 221 stars), Design Master (minhnv0807/ai-business-skills, 610 stars), Resend Design Skills (growupanand/ConvoForm, 102 stars) and Direct (autonomous-ai/openharness, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mpstats Connector?

Vladimir-Human (a GitHub user) maintains it in Vladimir-Human/ru-marketplace-mcp, which has 139 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 5, 2026.

Source: Vladimir-Human/ru-marketplace-mcp on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.