Compare Prices

Cross-Marketplace Price Comparison

One tool call queries every installed searchable marketplace concurrently and returns a single price-ranked list. Use it instead of calling each marketplace's search tool in sequence: same data, one round trip, plus the ranking and the spread. Offers are de-duplicated on (source, product id), so one listing can't hold two ranking slots. Taobao is in the fan-out too, and it prices in yuan — see the note below before you rank its rows against rouble sources.

When to use

• "Где дешевле купить X?" — the canonical case
• Deciding between marketplaces before a purchase
• Establishing a market price range for a product category
• Checking whether one marketplace is overcharging

When NOT to use

• A question about one specific marketplace → use wb_*, ozon_*, yandex_*
• Detail on one known product (reviews, seller, stock) → *_card tools
• Kids' goods by category → detmir_category (Detsky Mir has no text search)

Tools

• compare_prices(query, per_source_limit=5, sources=None, in_stock_only=False) — the main tool. Returns offers cheapest-first plus a per-source outcome report.
• compare_sources() — which marketplaces this installation can query. Call it when a comparison comes back partial and you need to know why.
• compare_verify_offer(source, product_id_or_url, expected_price_rub=None, expected_identity=None) — verify the winning offer through its native card tool without enabling the full unified marketplace mount. Use the source and product id/url returned by compare_prices. Pass the raw price_rub as expected_price_rub to get an explicit live price_verification delta; a mismatch means the search row may be stale or refer to a different seller offer under the same product id. Supply expected_identity with known gtin, or mpn and brand, plus variant_attributes when needed. identity_verification.match reports exact, mismatch, likely, or unknown and its reasons. Manufacturer fields absent from the native card remain unknown; titles and seller articles never supply MPN evidence. This check does not change the price ranking.
• decision_inspect(source, product_id_or_url) — return a native shortlisted card through the decision profile; use compare_verify_offer for an explicit identity verdict.
• compare_browser_snapshot(handoff_id) — returns the current retained viewport as MCP image content plus metadata for a same-session, unexpired handle. It never solves, OCRs, or sends the image to another service. Skip it when the client has no image input capability; a missing or foreign handle is not_found.

Reading the result correctly

Read source_outcomes[].warnings even when status is ok. These preserve native diagnostics about incomplete fields, fallback extraction, coupon prices, and truncated grids. complete describes which sources answered; it does not certify data quality, identical products, or a full catalog search. The same diagnostics appear in top-level warnings prefixed with the source.

Three fields decide whether the answer is trustworthy:

complete — true only when every queried marketplace answered. When false, the ranking covers a subset. Never say "X is cheapest" without checking this; say "cheapest among the marketplaces that responded" instead.

source_outcomes — per-marketplace status: ok, blocked (anti-bot or rate limit), timeout, error, not_installed. A blocked Ozon does not mean the product is absent from Ozon — it means the request was refused.

price_with_subscription_rub — Yandex Market's Plus-subscriber price, 25-30% below its everyday price. Ranking deliberately ignores it. Quote price_rub as the price; mention the subscriber price only as a footnote, and only if the operator has Plus.

currency and price_native — every offer reports its currency (lowercase ISO, default rub) and the price in that currency as the marketplace shows it. For rouble sources price_native equals price_rub; for Taobao it holds the yuan price while price_rub is null. Only rub offers rank, so a foreign-currency row rides along with its real price visible but out of the ranking — the foreign_currency warning counts them. Read price_native if you want to convert.

Workflow

Standard comparison:

1. compare_prices(query="стиральная машина узкая")
2. Check complete. If false, name the marketplaces that failed and why.
3. Report cheapest_comparable when it is present, rather than blindly quoting cheapest. The raw cheapest row can be an accessory or a used/display condition; the comparable field is the safer like-for-like candidate. Keep cheapest visible when explaining the warning.
4. Report price_spread_rub — the spread is what makes the comparison actionable.
5. Use compare_verify_offer on the winning row for a cheap card-level check; then use a native *_card tool for deeper reviews or seller details.

Set in_stock_only=true when the user asks where the item can be bought now. The response keeps excluded offers for audit, but ranks and selects winners only from listings whose marketplace explicitly reports stock.

When a source is blocked:

1. Read source_outcomes: error_code, retryable, requires_user_action, and challenge_type are machine-readable. detail is redacted and truncated; do not parse it for recovery instructions. Older connectors may omit a code.
2. If requires_user_action=true, keep successful offers visible and pause that source. retryable=true means a later retry can succeed after the challenge clears; it does not authorize a retry loop. Complete the required interaction in the connected scraping profile. A different browser profile has different cookies. If handoff_expires_at is present, the challenged tab is retained: complete the interaction there and repeat in the same MCP session before expiry. The source reads that exact page without new navigation. Otherwise the temporary tab closes normally. Retention is opt-in through CHROME_CHALLENGE_HANDOFF_S and currently covers Lamoda search and Taobao search/card DOM challenges. Do not change the original query or arguments when resuming, and do not assume automatic CAPTCHA completion.
3. After the browser action completes, call compare_prices with the same query, filters and limit, and sources restricted to the failed sources. Do not re-query healthy sources merely to recover one marketplace. This retry's complete applies only to its own sources_queried; older results are from a different observation time. Verify finalists before presenting a winner.
4. Retry once for a timeout; a rate limit needs a genuine wait. A generic blocked transport error is not proof that logging in will fix it. Use the source-specific skill and compare_sources() to inspect prerequisites.