search_beauty_prices

Search the beauty catalog and return the lowest current price per product.

Use when the user wants to find a beauty product, see what it costs, or
browse products by category, price, ingredients or brand values.

Results are grouped by EAN barcode: each product appears once, at the
lowest price among stores that currently have it in stock (or the lowest
listed price if it is sold out everywhere). Prices exclude shipping;
compare_product_prices returns shipping cost and total delivered price
per store for one product.

A non-empty query is required unless at least one filter (category,
key_ingredient, exclude_ingredient, exclude_controversial, attribute or
max_price) is set; an empty query with filters browses the catalog.

Each product carries two stock figures:
store_count - stores that list the product, including sold out
in_stock_store_count - stores that have it in stock right now

Ingredient filters map from natural language like this:

• "moisturizer with retinol" -> key_ingredient="retinol"
• "serum with retinol or vitamin C" -> key_ingredient="retinol,vitamin-c" (OR)
• "shampoo without sulfates and silicones" -> exclude_ingredient="sls,silicones"
• "fragrance-free / clean formulation" -> exclude_controversial=True

(excludes fragrance/parfum, parabens, silicones, SLS, mineral oil,
formaldehyde, phenoxyethanol, propylene glycol, denatured alcohol)

Args:
query: Product, brand or product type, e.g. "cerave foaming cleanser".
country: Market - "se" (Sweden), "no" (Norway), "dk" (Denmark), "fi" (Finland). More markets may be added over time;
get_service_info returns the current list.
category: Optional filter: skincare, makeup, haircare, fragrance, nails, body, accessories.
max_price: Optional maximum price in the market's local currency.
key_ingredient: Ingredient-group slug(s) the product must contain.
Comma-separated = OR (contains any of them), e.g. "retinol" or
"retinol,niacinamide". list_key_ingredients returns all valid slugs.
exclude_ingredient: Ingredient-group slug(s) the product must not
contain, e.g. "fragrance" or "sls,silicones".
exclude_controversial: Exclude all commonly avoided ingredients at once
(the list above).
attribute: Brand-level values filter. Slugs: "vegansk" (vegan),
"djurtestfri" (cruelty-free), "ekologisk" (organic/natural),
"skonsam" (gentle/free-from), "hallbar" (sustainable).
Comma-separated = AND (brand must match all). A brand matches on
either a third-party certification or its own stated claim;
get_product_details shows which applies.
limit: Maximum number of results (1-20).