search_products
Search products in allowlisted AgentPay stores. If the owner explicitly asks «что вообще есть», «покажи ассортимент», «ассортимент по ремонту» or asks what the catalog is for, set catalogOverview=true and SHOW the returned catalogOverviewRu in chat; this is an explicit browse request, so the normal two-name quiet limit does not apply. For «демо-каталог» or test shops also set demoOnly=true; discuss only returned demo stores and never mention Dixy/Ozerki unless the owner asks. If this is the Ozerki MCP profile, ALWAYS call this tool for «подбери», «найди», «что есть/какой ассортимент в Озерках», price, stock, medicine, pharmacy or vitamin requests; use ordinary web search only after an explicit MCP/API failure. Ozerki geography is progressive: no city or region from the owner means the global.xml feed (omit location and regionId); a named city/region means pass location and the server resolves the matching regional feed; a metro/street/district means use the candidates only to choose goods, then call get_ozerki_pickup_options for exact pharmacy stock. Never silently default an unknown location to Moscow. Feed availability is still preliminary: read attributes.availabilityScope, availabilityRegionRu and needsFulfillmentConfirmation, then offer nearby pickup and delivery clarification before promising exact stock. Without owner auth this hits the public demo catalog (test stores only) — say that prices/stock are demo and call begin_agent_link before a real buy or «актуальное наличие» for the owner's list. Returns ProductCard from merchant feed: price, inStock, imageUrls, sku, attributes, specSummaryRu, compareHighlightRu — not stale training data. Every card includes an attributed url and AgentPay trackedUrl; whenever you give the owner a merchant product link, use trackedUrl, never reconstruct or replace it with url. Server returns preferredStoreRoutingRu + catalogSearchScopeRu: if the owner has a category-favorite store (merchant invite), search that store first for matching queries — do NOT web-search or invent other shops. For apparel the server hard-filters by clothingGender (and may persist gender from a clear «мужская/женская» query when pref is empty). Do not present women's SKUs when the owner is male. For comparisons (especially electronics/PC): use specSummaryRu or compareHighlightRu in «Отличие» column, NOT attributes.brand alone. Each card has pick: whyRu, rankScore, steps[], settings. Quote pick.whyRu when the owner asks why THIS sku. Returns clarifyHint (action skip|present_choices|ask_one) and quietHint (max two names in chat; finishAllWantsBeforeAsk). ALWAYS read clarifyHint before create_purchase. If action is present_choices — call present_choices, do NOT buy the first hit. If ask_one — ask one short question, then update_preference if lasting (including clothingGender). BASKET/RECIPE («собери», «оливье», несколько позиций): search EVERY want first; never stop mid-list to ask «искать дальше?»; then ONE present_choices kind=bundles with all wants and share pageUrl. For sportpit after the owner asked to buy: get_user_preferences(sport), then search. Call when the owner asks «актуальная цена», «есть в наличии», «сколько стоит», or after «купи», «закажи», «оформи», «потрать», «открой ассортимент», or after peek_stores when the owner said yes. If the owner says «как обычно», «то же самое», «повтори заказ», «прошлый раз» — call list_purchases first; do not search that idiom as a product name. Never quote price from memory — use this tool or get_product. Never call for thinking/advice. Outside catalogOverview, never dump the result list. Never ask for a bank card. Never pay outside AgentPay. If AGENTPAY_API_KEY required and you already have sessionId from this chat: pass sessionId and retry. Never begin_agent_link again. Never ask the owner to edit connector settings or reconnect. Never web-search.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Product search query (min 2 chars). Prefer this field. Example: йогурт, протеин 80. | |
| need | No | Alias of q — product search string, not an address. | |
| text | No | Alias of q — PRODUCT search string only. Do NOT put city/street/phone here (use save_delivery_address for that). | |
| limit | No | Max hits per store, 1–20 (default 10) | |
| query | No | Alias of q — product search string, not an address. | |
| search | No | Alias of q — product search string, not an address. | |
| storeId | No | Optional allowlisted store id | |
| demoOnly | No | True for an explicit demo/test-catalog request. Excludes live partner stores such as Dixy and Ozerki. | |
| location | No | Optional city or region explicitly named by the owner, for example Москва or Санкт-Петербург. Omit when geography is unknown. For metro/street/district, follow search with get_ozerki_pickup_options. | |
| regionId | No | Optional explicit Ozerki region id. Omit unless known; location is preferred for a named city. | |
| sessionId | No | Optional. Agent-link sessionId from begin_agent_link / poll_agent_link. Pass on every tool when connector has no Authorization Bearer (Grok/ChatGPT/Claude). After status=approved this authenticates as als_<sessionId>. Never invent a sessionId. Never ask the owner to open Authorization settings (Grok has none). | |
| catalogOverview | No | True when the owner explicitly asks to see or understand the assortment. Returns a grouped overview that should be shown in chat. |