search_products
Search Citilink's catalog with city, price, category, availability, and sorting filters to retrieve local prices, ratings, stock, and pickup information for comparison.
Instructions
Search Citilink like the site does: pages of 48, sorting, price window, category, availability.
Per item: regular price (null = not sold in the city), strikethrough price,
club price only when the site shows it, bonuses (not a discount), lot size
when sold in lots, the product's own rating next to the group rating the
site shows, units in the area's stores, earliest pickup date, badges and
promo codes, markdown flag. total_found is Citilink's match count;
has_more whether another page exists; categories lists categories of
the matches (use an id as category_id, a slug with find_markdown);
price_range_rub is the site's price-filter span for the query (handy
for cutting price windows).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | City: id ('ekat_cl', 'ekat_cl:5x0029236') or name ('Екатеринбург', 'Кировск, Мурманская'). Default: CITILINK_CITY, else Екатеринбург | |
| page | No | Result page, 48 items per page (Citilink's hard cap) | |
| sort | No | Order: relevance, price_asc/price_desc, discount (biggest first), rating, opinions (most reviewed first) | relevance |
| limit | No | Return at most this many items of the page | |
| query | Yes | Search phrase as typed on the site (Russian works best) | |
| price_max | No | Upper price bound, rubles (regular price) | |
| price_min | No | Lower price bound, rubles (regular price) | |
| category_id | No | Narrow to one category: an `id` from `categories` of a previous answer | |
| availability | No | any; in_store_now = the site's «Забрать через 5 минут» filter (quick pickup in the city's area); pickup = «Доступен самовывоз»; delivery = «Доступен для доставки» | any |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||