KuantoKusta

Search for products on KuantoKusta.pt — Portugal's main price comparator. Returns up to 48 products per page plus `available_filters` showing all filter options that can be applied to narrow the results. Filters are **dynamic** and change per product type — always read `available_filters` from the response rather than guessing values. Recommended workflow: 1. Call search with just `query` (and optionally `sort`/price range). 2. Read `available_filters` in the response to see areas, brands, and product-specific filters (color, capacity, energy class, typology…). 3. Call search again with the desired filter values to get refined results. Args: query: Search keywords, e.g. "frigorífico", "iphone 15", "tv 55 polegadas". area: Top-level category — use a value from `available_filters` where field="area". Example: "Electrodomésticos", "Informática". family: Sub-category within an area — use a value from `available_filters` where field="family". Example: "Grandes Electrodomésticos". sort: "cheap" (default) | "expensive" | "popular" | "alphabetical" | "newest". price_min: Minimum price in EUR (integer). price_max: Maximum price in EUR (integer). brands: List of brand names — use values from `available_filters` where field="brand". Example: ["Samsung", "LG"]. features: Dict of product-type-specific filter values — keys and valid values come from `available_filters` where field is NOT area/family/brand. Example: {"tipologia_s": "combinados", "cor_s": "inox", "classe_energetica_s": "classe a"}. For a laptop search the keys would be different (ram_s, os_s, etc.) — always derive them from the previous call's available_filters. page: Results page number (default 1; ~48 products per page

Get full details and all store prices for a KuantoKusta product. Pass the product URL from a `search` result. Returns the product name, description, technical specs (45+ attributes), and all store offers sorted by **total price** (product + shipping) — so you always see the true cheapest option, not just the lowest sticker price. Args: url: KuantoKusta product URL from a search result, e.g. "https://www.kuantokusta.pt/p/1967884/mini-com-congelador-smeg-fa120e"