Compare Prices Across Russian Marketplaces
compare_pricesCompare prices across Russian marketplaces in one query, then get a price-ranked list and per-source status showing which marketplace has the product for less and whether all sources responded.
Instructions
Price one product across every configured Russian marketplace at once.
Queries each marketplace concurrently and returns a single list ranked by price, plus a per-source report of what answered and what did not. This is the tool for "where is X cheapest" — running the per-marketplace search tools one at a time gives the same data far more slowly and without the ranking.
Two things to read carefully in the output:
cheapestis chosen on everyday prices. Yandex Market's subscriber price appears asprice_with_subscription_ruband is deliberately excluded from ranking, since it requires a paid Yandex Plus subscription.source_outcomesshows which marketplaces answered. A blocked or timed-out source means the comparison is partial, not that the product is absent there —completetells you which case you are in.
Titles are matched loosely: marketplaces name things differently, so scan the results rather than assuming every row is the identical model.
Error Format
On validation failure, raises ToolError with a JSON message describing the
error code and whether it is retryable. Individual source failures do NOT
raise — they are reported in source_outcomes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What to price, in Russian — e.g. 'стиральная машина узкая' or 'iphone 15 128'. | |
| sources | No | Restrict to specific marketplaces (wildberries, yandex_market, ozon). Omit to query all. | |
| per_source_limit | No | How many offers to take from each marketplace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | The query that was priced. | |
| offers | No | All offers, cheapest first. Offers without a price are kept at the end. | |
| cheapest | No | Lowest everyday price found. None when no marketplace returned a price. | |
| complete | No | True only when every queried marketplace answered. False means the ranking is partial. | |
| warnings | No | Connector-level warnings (partial data, no prices). | |
| sources_ok | No | Marketplaces that answered successfully. | |
| total_offers | No | Total offers across all marketplaces. | |
| server_version | No | Connector version. | |
| source_outcomes | No | Per-marketplace outcome, including failures — read this before trusting the ranking. | |
| sources_queried | No | Marketplaces that were attempted. | |
| price_spread_rub | No | Difference between the highest and lowest everyday price — how much the choice is worth. |