Buscar productos
search_productsSearch for products across Chilean supermarkets, compare prices including unit prices, and filter by store, price range, stock, and branch for real-time local availability.
Instructions
Busca productos en el catálogo de un supermercado chileno y devuelve resultados enriquecidos: name, brand, description, imageUrl, url. Precios en CLP: price es el precio vigente (con oferta si la hay), listPrice el normal cuando hay descuento, unitPrice/unit el precio por unidad base (kg/lt/un) para comparar formatos. Filtros opcionales: maxPrice/minPrice (CLP), inStockOnly; orden con sortBy (price = más barato primero, unitPrice = mejor precio por kg/lt). Con branchId (sucursal) los precios/stock son de esa tienda. Para el precio socio de un producto puntual, usar get_product.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Página de resultados. | |
| limit | No | Máximo de resultados (1-50). | |
| query | Yes | Texto de búsqueda, ej. "leche descremada" o "arroz grado 1". | |
| store | No | Cadena donde buscar: jumbo, santaisabel, unimarc, tottus o lider. unimarc/tottus/lider requieren IP residencial (la máquina del usuario). | jumbo |
| sortBy | No | Orden: relevance (default), price (más barato primero) o unitPrice (mejor precio por kg/lt). | relevance |
| branchId | No | Código de sucursal para precios/stock locales, ej. "jumboclj512". Omitir para catálogo nacional. | |
| maxPrice | No | Filtra productos con precio vigente <= a este valor (CLP). | |
| minPrice | No | Filtra productos con precio vigente >= a este valor (CLP). | |
| browserHtml | No | Líder y Tottus: HTML de la página de búsqueda (o el JSON de __NEXT_DATA__) obtenido en un navegador real que ya pasó el antibot. Si se entrega, se parsea eso en vez de hacer el fetch (que la cadena bloquea por fingerprint del cliente). Flujo: llamar sin browserHtml → se devuelve openUrl+browserSnippet → ejecutarlo en el navegador → reintentar con browserHtml. | |
| inStockOnly | No | true = solo productos con stock real. |