Convierte una lista en lenguaje natural (ej. ["leche", "arroz 1kg", "café de grano"]) en productos concretos del catálogo, eligiendo por mejor precio por unidad y ofertas vigentes. Devuelve por ítem el producto elegido, hasta 3 alternativas para ajustar, el ahorro por ofertas, y el total estimado en CLP. Con branchId usa precios/stock de esa sucursal. Si se entregan los productos frecuentes del usuario en frequentCards (desde get_frequent_purchases con sesión iniciada), se priorizan: la lista se arma con lo que la persona realmente compra. Si el usuario prefiere marcas específicas, incluirlas en el texto del ítem (ej. "leche colun").

Para cada ítem (nombre de producto o texto de búsqueda) sugiere reemplazos convenientes dentro del mismo catálogo. Por defecto: mejor precio por unidad (kg/lt/un) que el match actual. Con preferNatural: true cambia el criterio a 'más natural manteniendo el precio': trae alternativas de precio similar CON sus ingredientes y sellos nutricionales, para elegir la de lista de ingredientes más corta/limpia sin subir el gasto (usa la ficha; hoy Jumbo y Santa Isabel). Devuelve el producto actual y los reemplazos con su ahorro por unidad.

Devuelve los productos que el usuario compra habitualmente en la cadena, normalizados con su precio vigente, precio normal y precio socio Jumbo Prime cuando aplica. Base para armar la lista con lo que la persona realmente compra. Requiere sesión: entrega en cards el resultado de ejecutar el browserSnippet (una sola pasada al DOM) en www.jumbo.cl/productos-frecuentes ya logueado. NO rasques el estado de React ni improvises selectores; usa el snippet. El servidor nunca maneja credenciales.

Devuelve las listas de compra guardadas del usuario en la cadena, normalizadas a { id, name, items[] }. Requiere sesión: ejecuta el browserSnippet (GET /lists) en una pestaña YA LOGUEADA de www.jumbo.cl y pásame el JSON en rawLists. Para el detalle con items, repite el fetch a /lists/{scope}/{idList}. NO rasques el DOM ni React; es una llamada JSON directa. El servidor nunca maneja credenciales.

Agrega/actualiza productos en el carro de Jumbo del usuario. El servidor no maneja credenciales: devuelve un browserSnippet (PATCH /cart/items con su body) para ejecutar en una pestaña YA LOGUEADA de www.jumbo.cl. Si el navegador lo ejecutó y entregas el JSON del carro en rawCartResult, devuelvo el carro normalizado (total, ahorro y ahorro Prime). Acción reversible (se puede quitar del carro); no es una compra.

Normaliza el carro de Jumbo del usuario a { items, subTotal, total, savings, primeSavings }. El servidor no ve credenciales. FLUJO RÁPIDO (una sola llamada): ejecuta el browserSnippet que devuelve esta tool en una pestaña YA LOGUEADA de www.jumbo.cl y pásame el JSON en rawCart. NO extraigas el estado de React ni el DOM del carro a mano: es lento, frágil e innecesario (este fetch trae todo el carro directo). Si no pasas rawCart, devuelvo el snippet listo para ejecutar.

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.

Obtiene el detalle completo de un producto: precio vigente (price), precio normal (listPrice), precio socio Jumbo Prime (memberPrice) cuando existe, precio por unidad (unitPrice/unit), EAN, stock y oferta. Es la única fuente del precio socio en fase 1. Acepta la URL del producto (campo url de search_products), el path o el slug.

Lista las ofertas vigentes del supermercado (precio rebajado: price vigente vs listPrice normal). Filtrable por categoría (ej. "Despensa", "Lácteos") y por sucursal (branchId). El precio socio exacto se consulta con get_product (memberPrice). Nota: primeOnly (ofertas exclusivas socios) ya no está disponible en Jumbo — el landing dedicado fue discontinuado; devuelve un error accionable.

Devuelve los productos con MAYOR descuento vigente y stock real, ordenados por porcentaje de descuento, para recomendar aprovechar ofertas. Cada resultado trae discountPct, saving (ahorro CLP) y memberSaving (ahorro extra socio Prime) además de nombre, precio, precio normal, unidad y foto. Filtrable por category y minDiscountPct. Pasar excludeIds (ids del carro o frecuentes) para destacar solo oportunidades que el usuario aún no tiene. primeOnly para ofertas exclusivas de socios. Hoy disponible en Jumbo (colección de ofertas verificada).

Estima el total de una misma lista (ítems en texto libre) en varias cadenas chilenas y señala la más barata entre las que tienen todos los productos. Devuelve por cadena el mejor match por ítem y el total. IMPORTANTE: cada cadena resuelve el ítem por su cuenta, así que el 'más barato' puede ser un producto o formato distinto; usa el campo comparability (same/similar/mixed por ítem) y compara por precio por unidad, no solo por total. Capacidad secundaria: para el día a día conviene build_list con tu sesión. Nota: tottus/lider solo se incluyen si está configurado el puente de navegador (bloquean el fetch directo); si una cadena falla, se reporta y las demás siguen.

Toma una lista de ítems y, por CADA ítem, elige la cadena donde sale más barato (por precio por unidad cuando todas lo informan), agrupando la compra por cadena (la leche en una, el pan en otra). Devuelve plan por cadena, picks por ítem con alternativas, basketTotal (comprando cada cosa donde es más barata), singleStore y splitSaving (ahorro vs comprar todo en una sola cadena), y missing. Por defecto compara jumbo, santaisabel y unimarc (las que responden desde el servidor); tottus/lider requieren el puente de navegador (browserHtml de search_products). NO agrega al carro: para eso usa add_to_cart (hoy solo Jumbo, con sesión); para el resto quedan los links (url) de cada producto.

Diagnóstico en vivo: qué cadenas soportadas están respondiendo ahora y con qué latencia. Úsalo si otra tool falla, para distinguir un endpoint caído de un error de uso.

Obtiene el código de sucursal (branchId, ej. "jumboclj512") leyéndolo del navegador, para no pedírselo al usuario. Devuelve un browserSnippet para ejecutar en www.jumbo.cl (con la comuna/tienda ya elegida). El snippet retorna { found, branchId } o, si no hay tienda elegida, { found:false, hint }. Pasa ese resultado en discovered para que la tool lo valide y te confirme el branchId a usar.