yandex-market-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yandex-market-mcp Search for 'Sony WH-1000XM5' and sort by price ascending"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
yandex-market-mcp
English · Русский
An MCP server that gives LLM agents live, honestly-labelled data from Yandex Market: search with real pages, the site's sort orders and price windows; seller cards with the three prices kept apart; all sellers' offers of a product; reviews at the right level; buyers' questions; seller details with the legal entity.
Buyer side: reads the public storefront pages, no Yandex account needed. Looking for your seller cabinet (the official Partner API)? That is a different tool, e.g. dontsovcmc/mcp-server-yandex-market-seller.
Why another Yandex Market server
Market's pages are full of numbers that look like one thing and are another. Scrapers that take the big number on the page return data a buyer never pays. This server is built around not doing that:
Market trap | What this server does |
The big green price on tiles, cards and in schema.org data is the price with the Yandex Pay card; the plain price is visible only in the «Детали цены» popup |
|
«Скидка 41%» is counted from the Pay-card price |
|
The search price filter and price sorting work on the Pay-card price | Every answer says so ( |
The rating on a card belongs to the seller's card, which can pool several different products (one seller's card pools seven Fiskars axes, 745 ratings) |
|
«Отзывы и оценки у всех продавцов» is a model group that merges different products (JBL Tune 520BT + 720BT + 770NC) |
|
Page 1 of "popular" is almost entirely ads |
|
One product from several sellers = several tiles; | Tiles deduplicated by offer id; |
Promo codes and «−200 ₽ с доставкой по клику» look like price cuts |
|
Cross-border offers, markdown («Уценка»), «Версия: для других стран», «Оригинал» |
|
Market picks the city from the IP; | No fake |
«6.9K оценок», «72K» | Numbers with |
Every normal page contains an empty | Captchas are recognised by URL and SmartCaptcha markers only; empty frames and foreign pages are retried once, then reported as errors, never as data |
Every response carries fetched_at (UTC) and city.
Related MCP server: wildberries-mcp
Tools
Tool | What it returns |
| Page 1 = 8 tiles, later pages 16; sort |
| One seller's card ( |
| All sellers' offers of one product as tiles (sort |
| 10 per page; |
| 10 per page; questions with the answers shown on the site, exact dates, |
| Rating, exact ratings count and star split, orders, years on Market, status; legal entity (name, INN, OGRN, address, cross-border flag) |
| Up to 10 cards side by side: three prices, card rating with the pooling flag, seller, fastest delivery, «все предложения от» |
Author names, user ids and order numbers never appear in answers; names in sellers' greetings («Здравствуйте, Анна!», «Анна, добрый день!»), e-mails and phone numbers in texts are masked.
Requirements
Measured on 2026-09-25 (Linux, Python 3.13, a Russian home IP):
Python | ≥ 3.10, with uv (or pip) |
Browser | Not needed. Plain HTTP with a Chrome TLS fingerprint (curl_cffi) gets the same pages a browser does |
Display | Not needed |
Docker | Not needed |
Disk | ≈ 85 MB for the environment (curl_cffi 38 MB, the rest is the MCP SDK and pydantic) |
Memory | Peak RSS of the server process 110–113 MB during a full run of all tools (two runs; pages are 1.3–2.6 MB of HTML) |
Cold start | 0.4–0.5 s until the MCP client sees the tools (0.7 s via |
Request time | A page answers in 0.6–1.2 s; requests are spaced 4–5 s apart, so a call takes ≈ 1 s when idle, ≈ 5 s back-to-back; |
Network | A Russian home or residential IP. Market maps the city from it; datacenter IPs abroad have been reported to get a captcha at once |
Install
Claude Code:
claude mcp add yandex-market -- uvx --from git+https://github.com/SZhukovWork/yandex-market-mcp yandex-market-mcpAny MCP client (claude_desktop_config.json, .mcp.json, …):
{
"mcpServers": {
"yandex-market": {
"command": "uvx",
"args": ["--from", "git+https://github.com/SZhukovWork/yandex-market-mcp", "yandex-market-mcp"]
}
}
}From a checkout: uv venv && uv pip install -e . && .venv/bin/yandex-market-mcp.
Configuration (environment variables)
Variable | Default | Meaning |
|
| Region id you expect Market to assign to your IP (213 Москва, 2 Санкт-Петербург). If the page says otherwise, answers carry a |
|
| Seconds between requests (never below 3). The IP is usually shared with your own browsing |
|
| After a captcha the server does not query the site for this many seconds, also across restarts |
|
| The same pause after HTTP 403 / 429 persisted through one retry |
| — | Proxy URL, e.g. |
|
| Where the cookies ( |
yandex-market-mcp status shows whether a pause is active; yandex-market-mcp unblock clears it (for example
after you solved the captcha in your own browser).
What the numbers mean
price_rub— the price without the Yandex Pay card for an anonymous buyer in the reported city. Use it for comparisons and the landed price.price_with_pay_card_rubapplies only when paying with the Pay card.price_before_discount_rubis the crossed-out «Обычная цена» and can be inflated (Fiskars X21 was seen at «79 567 → 33 915» while honest sellers ask about 9 000).conditional_offers— promo codes and offers with conditions (minimum order, delivery mode, shop subscribers). They are listed, never subtracted.rating_of_this_card— the seller's card;pools_other_products: truemeans the reviews shown on the card are partly about other products of the seller.model_group_rating— all sellers of a Market "model", which can merge different products. There is no separate rating of one variant on Market; its reviews are available withget_reviews(scope="variant").low_evidence= fewer than 10 ratings.Delivery — dates and prices for the IP city without an address, as the card shows them; «Доставка Маркета» options are often 0 ₽, sellers' couriers can cost more. A missing price means unknown.
stock_left— units the offer has according to the page.all_offers.from_pay_card_price_rub— «Все N предложений от X»: X is the lowest price with the Pay card.
Limitations
City = the IP's city. Market ignores
lr/yandex_gid; choosing an address requires a login. Prices and delivery for another city are not available. Whether prices depend on the city at all was not verified.Search depth: at most 30 pages (≈ 470 items) per query, sort and price window. Page 1 has 8 tiles, later pages 16. With more results the answer carries
depth_cap: split the price range into windows.get_offersshows at most 16 offers per sort order. Market's server-rendered offers page ignorespage(checked: page 2 returns page 1 again). Call it with other sorts to see more offers.No price history — Market removed it in 2022 and the pages do not carry it.
Anonymous prices only. The site says «Войдите, и станет дешевле»: prices after login, personal discounts, split amounts, Plus points and cashback are not available (split is a yes/no flag; the raw
isPersonalDiscountflag is passed aspersonal_discount_flag_raw, its meaning unconfirmed).Search totals count loose matches and drift: the same query reported 2308 and, an hour later, 419 results; a nonsense query «finds» thousands. Check titles; do not treat
total_foundas a catalogue size.Legal entity of a seller comes from the site's seller-info popup, which the page loads with a POST to
/api/render-lazy— a path that robots.txt disallows. Onlyget_sellerandget_product(include_seller_legal=true)make that request; everything else reads regular pages.Customs duty — Market's rule for cross-border orders (duty above 200 € or 31 kg per order) is passed on; a fixed «Пошлина N ₽» is reported only when a tile shows one.
Unofficial: the server reads the state Market embeds in its pages. Market changes it without notice; parsers are isolated in
parse.pyand covered by tests on recorded pages. Implausible pages become errors.Captcha: the server never solves or bypasses it. It stops and pauses (30 min by default).
Roadmap
Optional account mode (personal prices after login) and the cart — later.
Checkout, payment and address changes are out of scope.
Development
uv venv && uv pip install -e '.[dev]'
.venv/bin/pytest # offline tests on recorded, anonymised pages
.venv/bin/pytest -m live -s # every tool over MCP stdio against the live site (14 requests, ~1.5 min)Please run the live test rarely: the IP is shared with your own browsing, and a captcha pauses the server for 30 minutes.
Disclaimer & credits
Not affiliated with Yandex. The server reads Market's internal page state, not an official API; use it for personal price research at a human request rate and respect Market's terms of use. Ideas for recognising real captchas (URL and SmartCaptcha markers, not the substring "captcha"), "empty frame" pages and retrying an empty redirect come from Vladimir-Human/ru-marketplace-mcp (MIT); no code was copied.
License: MIT.
Available Tools
7 toolscompare_productsARead-onlyIdempotent
Side-by-side rows for up to 10 seller cards: the three prices, rating of the card, seller, delivery.
One request per card, sequentially (about 5 s each). A card that fails gets an error row;
a captcha or rate limit stops the whole comparison.
Inputs: products (required). Returns: object
get_offersARead-onlyIdempotent
All sellers' offers of one product (the site's «Все N предложений»), as tiles.
Market's server pages show the first 16 offers per sort and ignore page (checked
2026-09-25), so this returns at most 16; call again with another sort to see more (dedupe by
offer_id). Also returns the model group's rating — labelled: it can merge different products.
One request.
Inputs: sku_id (required), model_id (required), sort. Returns: object
get_productARead-onlyIdempotent
One seller's product card, live: the three labelled prices, promo conditions, delivery, seller.
Also: rating of this seller's card with stars and a check whether the card pools other products, «Все N предложений от X» (X = lowest Pay-card price; list them with get_offers), badges with their real meaning, cross-border / markdown / version flags, stock, characteristics and question count. One request (three with include_seller_legal).
Inputs: product (required), include_specs, include_description, include_seller_legal. Returns: object
get_questionsARead-onlyIdempotent
Buyers' questions about a card with the answers shown on the site; by_seller marks the seller's answers.
Dates are exact. Names of buyers are never returned; greetings with a name in answers are masked. One request.
Inputs: product (required), page. Returns: object
get_reviewsARead-onlyIdempotent
Buyer reviews with date, stars, pros, cons, comment, votes, photo count and the product each is about.
The header numbers (rating, counts, stars) are the site's for the chosen scope; for scope="variant" the site still shows the whole card's numbers (labelled). Items without text are ratings only. Author names and order numbers are never returned. One request.
Inputs: product (required), page, sort, scope. Returns: object
get_sellerARead-onlyIdempotent
A seller's storefront header (rating, ratings count, orders, years on Market, status) and legal entity.
The legal entity (name, INN, OGRN, address, cross-border flag) comes from the site's seller-info popup, loaded with a POST to Market's /api/ (robots.txt Disallow) — two requests.
Inputs: business_id (required). Returns: object
search_productsARead-onlyIdempotent
Search Yandex Market like the site: real pages, the site's sort orders and a price window.
Each item: offer/card/model/SKU ids, title, card URL, the three labelled prices (without the Pay card, with it, crossed-out), discounts, seller, sponsored flag, rating of this seller's card with its count, badges, cross-border / markdown flags, stock and delivery dates. One request per call.
Inputs: query (required), page, sort, price_max, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct resource and action: search, single product card, all offers, comparison, reviews, questions, and seller info. Even the overlapping get_product and get_offers are clearly separated by scope (one seller vs. all sellers).
All tool names follow a consistent verb_noun snake_case pattern: search_products, get_product, get_offers, compare_products, get_reviews, get_questions, get_seller. No mixed conventions or vague verbs.
Seven tools is well-scoped for a marketplace research API. Each tool covers a distinct user need without redundancy or bloat.
The set covers the full product research lifecycle: discovery (search), deep dive (product, offers, compare), social proof (reviews, questions), and seller trust (seller info). No obvious dead ends or missing core operations for a read-only marketplace tool.
Related MCP Connectors
Unblocking and fresh web data for agents: URL to Markdown, YouTube, Maps, Amazon, jobs. Pay per call
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
RU merchant catalog for AI agents: live price, stock, choices and controlled checkout. Not x402.
Merchant product catalogs for AI agents: price, availability, specs, variants, buy links. Read-only.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to run RU-first web searches through the Yandex index and extract web pages into clean reader-mode Markdown, bypassing anti-bot blocks.336 npmMIT
- AlicenseAqualityBmaintenanceEnables LLM agents to query live Wildberries marketplace data — product search with pages, sorting, price filters, per-article ratings and reviews, weekly price history, and seller legal details — with honest, sanity-checked answers and automatic anti-bot handling.5MIT
- AlicenseAqualityCmaintenanceEnables LLM agents to retrieve live, accurately-labelled product data from Ozon's public storefront, including search with pagination and sorting, all price variants, delivery dates, seller legal details, variants, and SKU-specific ratings and reviews, all without an Ozon account.4MIT
- AlicenseAqualityCmaintenanceEnables LLM agents to access live aliexpress.ru storefront data, including variant-specific ruble prices, order-accurate coupons, delivery quotes to Russian cities, seller info, and paginated buyer reviews with filters.4MIT