{"ok":true,"site":{"host":"beep.es","url":"https://www.beep.es/","type":"live","category":"Commerce","desc":"Beep Informática is a Spanish chain of local computer shops selling laptops, PCs, components, gaming gear and electronics online.","tools":[{"name":"search_products","kind":"answer","impl":"imperative","description":"Busca productos en el catálogo de la tienda por texto libre. Devuelve nombre, precio, disponibilidad, SKU y URL de cada resultado. NO navega ni añade nada al carrito: usa navigate_to para llevar al usuario a los resultados y add_to_cart para comprar.","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"inputSchema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Texto a buscar, ej. \"iphone 15\", \"portátil gaming\", \"cartucho HP 302\""},"limit":{"type":"integer","description":"Número máximo de resultados (1-50). Por defecto 10.","minimum":1,"maximum":50}}},"outputSchema":{"type":"object","properties":{"total":{"type":"integer"},"products":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"SKU del producto — úsalo en add_to_cart"},"title":{"type":"string"},"price":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"string"}}},"inventory":{"type":"object","properties":{"available":{"type":"boolean"},"quantity":{"type":"integer"}}},"url":{"type":"string","description":"Ruta interna de la ficha — úsala en navigate_to"},"brand":{"type":"string"},"image_url":{"type":"string"}}}},"search_url":{"type":"string"}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"get_product","kind":"answer","impl":"imperative","description":"Obtiene el detalle completo de un producto a partir de su ID o SKU (el campo «id» que devuelve search_products). Úsalo antes de add_to_cart para confirmar precio y stock.","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"inputSchema":{"type":"object","required":["product_id"],"properties":{"product_id":{"type":"string","description":"ID o SKU del producto en VTEX"}}},"outputSchema":{"type":"object","properties":{"product":{"type":"object","properties":{"id":{"type":"string","description":"SKU del producto — úsalo en add_to_cart"},"title":{"type":"string"},"price":{"type":"object","properties":{"currency":{"type":"string"},"amount":{"type":"string"}}},"inventory":{"type":"object","properties":{"available":{"type":"boolean"},"quantity":{"type":"integer"}}},"url":{"type":"string","description":"Ruta interna de la ficha — úsala en navigate_to"},"brand":{"type":"string"},"image_url":{"type":"string"}}}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"browse_categories","kind":"answer","impl":"imperative","description":"Devuelve el árbol de categorías de la tienda con sus URLs. Úsalo cuando el usuario quiera explorar el catálogo por secciones en lugar de buscar un producto concreto.","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"inputSchema":{"type":"object","properties":{}},"outputSchema":{"type":"object","properties":{"categories":{"type":"array","items":{"type":"object"}}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"get_cart","kind":"answer","impl":"imperative","description":"Devuelve el contenido actual del carrito: líneas con nombre, SKU, cantidad, precio unitario y totales. Funciona desde cualquier página.","annotations":{"readOnlyHint":true,"untrustedContentHint":true},"inputSchema":{"type":"object","properties":{}},"outputSchema":{"type":"object","properties":{"item_count":{"type":"integer"},"total":{"type":"number"},"currency":{"type":"string"},"line_items":{"type":"array","items":{"type":"object"}}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"add_to_cart","kind":"act","impl":"imperative","description":"Añade un producto al carrito por su SKU. Obtén el SKU con search_products o get_product; nunca lo inventes. La cantidad es incremental: llamar dos veces con quantity=1 deja 2 unidades.","annotations":{"readOnlyHint":false},"inputSchema":{"type":"object","required":["sku_id"],"properties":{"sku_id":{"type":"string","description":"SKU del producto (campo «id» de search_products)"},"quantity":{"type":"integer","description":"Unidades a añadir. Por defecto 1.","minimum":1},"seller":{"type":"string","description":"ID del vendedor en VTEX. Por defecto \"1\"."}}},"outputSchema":{"type":"object","properties":{"item_count":{"type":"integer"},"total":{"type":"number"},"currency":{"type":"string"},"line_items":{"type":"array","items":{"type":"object"}}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"update_cart_item","kind":"act","impl":"imperative","description":"Cambia la cantidad de una línea del carrito o la elimina. La cantidad es absoluta, no un incremento: quantity=0 elimina la línea. Identifica la línea con el SKU que devuelve get_cart.","annotations":{"readOnlyHint":false},"inputSchema":{"type":"object","required":["sku_id","quantity"],"properties":{"sku_id":{"type":"string","description":"SKU de la línea a modificar"},"quantity":{"type":"integer","description":"Cantidad final. 0 elimina la línea.","minimum":0}}},"outputSchema":{"type":"object","properties":{"item_count":{"type":"integer"},"total":{"type":"number"},"currency":{"type":"string"},"line_items":{"type":"array","items":{"type":"object"}}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"navigate_to","kind":"act","impl":"imperative","description":"Lleva el navegador del usuario a una página de la tienda: resultados de búsqueda, ficha de producto, categoría o carrito. Usa las rutas que devuelven las demás tools; no construyas URLs a mano. Tras esta llamada el usuario YA está en la página: no le pidas que haga clic en ningún enlace ni vuelvas a navegar.","annotations":{"readOnlyHint":false},"inputSchema":{"type":"object","required":["path"],"properties":{"path":{"type":"string","description":"Ruta interna que empieza por \"/\", ej. \"/search?q=iphone\", \"/product/mi-producto\", \"/cart\""}}},"outputSchema":{"type":"object","properties":{"navigated_to":{"type":"string"}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"name":"go_to_checkout","kind":"transact","impl":"imperative","description":"Lleva al usuario al checkout para finalizar la compra. Requiere el carrito con al menos un artículo. Tras esta llamada el usuario ya está en el checkout: no navegues de nuevo.","annotations":{"readOnlyHint":false},"inputSchema":{"type":"object","properties":{}},"outputSchema":{"type":"object","properties":{"item_count":{"type":"integer"},"total":{"type":"number"}}},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"}],"apiSurface":"spec","favicon":"/favicons/beep.es.png","toolCount":8}}