Entry point for product discovery on ozon.ru. Default compact=true: sku, name, price, rating, reviews, brand, url (+ reviewTrust / variantCount|configCount when >1). Pass compact:false or rich:true for full nested variants/configs/images. Do NOT guess category slugs — call ozon_list_categories (or copy from ozon_search_filters / a real ozon.ru URL); omit category for plain text search. Use priceMin/priceMax (enforced client-side), filters{}, excludeBrands, minReviews. For seller trust in ONE call: minSellerRating / minSellerOrders (+ withDelivery:true for PVZ dates). Prefer limit 5–8. Next: ozon_product_details / ozon_compare_products / ozon_product_offers.

Product card. Default compact=true: price, seller, location, delivery, characteristics, nutrition{} (proteinG/carbsG/fatG/kcal/per — auto-loads features for food-like cards). imageDataUri:true → small Data URI thumbnail for canvases. compact:false / rich:true keeps images[] URLs + full description. For ALL specs: ozon_product_specs.

Fetch 1–40 product cards in one call (nutrition + optional imageDataUri). imageDataUri only for ≤24 SKUs (auto-disabled above). For huge canvases prefer Docker script over stuffing MCP context. Reload MCP after upgrades so Cursor sees new tool schemas.

Buyer reviews for a product SKU. Default variantOnly=true matches Ozon UI «Этот вариант» (only reviews left on this exact color/config SKU — may be empty while the card shows pooled totals). Pass variantOnly=false for all sibling variants on the same card. sort=helpful|date|product|default. hasPhotos=true keeps photo reviews. Each review: aboutProduct, likelySellerGeneric, matchedSku, isOtherVariant, variant[] labels, reviewsScope (product|otherVariant|seller|crossListing|unclear). If count=0 with variantOnly, retry variantOnly=false and label quotes as other-variant.

Questions and answers on the product page (not reviews). Use for compatibility, package contents, warranty, regional versions, setup tips — things buyers ask before purchase. Returns question text, author, date, and answers (seller or buyers). Requires product sku or URL.

Lists sellers for the product cluster. includeCurrent=true (default) prepends THIS card's seller with isCurrentListing=true and delivery from the product page (not only /otherOffers). Each row: price, rating, delivery text, advantages[] (all badges, not only first), productUrl, sellerUrl. Delivery dates follow location.city / pickupAddress — call ozon_search_cities then ozon_set_city (optionally with address for a specific PVZ area) first. Requires product sku.

Product configuration options: memory size, color, storage, etc. Each variant has its own sku and price. Use when user asks '512GB or 1TB?', 'what colors available?', or needs sku for a specific configuration. Returns aspects[] with variants[]: sku, label, price, oldPrice, available, url.

Technical characteristics from the listing (fieldCount varies — many cards are sparse with <8 fields). Also returns nutrition{} when macros are in the table. When sparse/specsIncomplete=true, do not invent numbers; try another SKU or ozon_product_questions. More complete than ozon_product_details.characteristics when the seller filled the table.

Shop profile for a seller. Use when user asks 'is this seller trustworthy?' or before buying from unknown shop. Returns: shop name, logo, subtitle, rating, orders + reviewCount (from badges like «20,6 K заказов»), badges with human labels, infoUrl, isExpress/isOfficial hints. Product-card seller.rating is often richer than this page.

Product listing from a seller's shop page. Use when user wants to see what else this shop sells. Returns same fields as ozon_search items plus seller info. Supports sort and price filters.

Products inside a category without text search. Use for browsing a department with priceMax/filters. Returns products, breadcrumbs, top brands. IMPORTANT: Ozon matches the numeric id only — a guessed stem+id can open a different category. Always copy slug from ozon_list_categories (or ozon_search_filters / real ozon.ru link). Mismatch of text prefix vs real category → error. Supports filters{} like ozon_search.

Official brand storefront on Ozon. Accepts brand name, slug-id ("name-123"), or /brand/... URL. Plain names are resolved via Ozon search. Returns brand products (ads filtered out). Supports filters{}.

Cross-sell block from product page ('Покупают вместе', accessories, similar items). Use when user asks what to buy with this product or wants alternatives. Returns product list same format as ozon_search.

Compare 2–8 products. Default compact=true: matrix + slim product rows (no per-SKU characteristics dump / missingKeys). compact:false keeps full characteristics + missingKeysByProduct. extracted{} from characteristics/title only.

Available filters and sort options BEFORE / alongside searching. Default compact=true truncates long facet option lists (keeps brand/category/price fuller; category options include slug+url). Pass compact:false for complete options. For browsing the category tree use ozon_list_categories. Does not return products.

Live category directory from Ozon (not a hardcoded map). Returns title + slug + url. No args → top departments. parent=slug|id|title → children. query=text → category facet for that search. Copy slug into ozon_category_browse / ozon_search.category — never invent stems.

Live city lookup via Ozon maps API (not a static list). Use when user asks about delivery to a city or you need options to choose from. Pass first letters or full name: "Каз", "Санкт", "Екатеринбург". Returns cities[]: label, city, region, lat, lng, uid. Show options to user, then ozon_set_city(city).

Current delivery city/region for this browser session. Anonymous sessions default to Москва. Use before quoting delivery dates. Returns { city, region, pickupAddress }.

Change delivery city for the session (picks a pickup point via Ozon map). Call ozon_search_cities first to show the user valid options from Ozon. Pass address to bias PVZ toward a street/district (e.g. city=Зеленоград, address="Заводская 14к2"). Returns requestedCity and location { city, region, pickupAddress }. Affects delivery in ozon_product_details / ozon_product_offers. Takes ~20–40s.