Search the grocery product catalog by keyword with faceted filtering.

Returns matching products with name, brand, price, unit price, retailer and a URL, plus facet counts for retailers, brands and countries.

Args: q: Free-text query (e.g. "potatoes", "krumpli"). Empty returns all, sorted by sort or recency. country: ISO 3166-1 alpha-2 country code (e.g. HU, FR). retailer: Retailer slug (e.g. tesco-hu, auchan-fr). chain: Chain slug (e.g. tesco, auchan). brand: Brand free-text token. tag: Tag slug (e.g. vegan). category: Category slug at any level (L1/L2/L3, e.g. fresh-produce, dairy-eggs, vegetables/potatoes); matches the whole subtree. city: City free-text token filtering stores carrying the product. currency: ISO 4217 currency code (e.g. HUF, EUR). min_price: Minimum latest price (inclusive). max_price: Maximum latest price (inclusive). sort: Stable sort token: relevance, newest, oldest, price_asc, price_desc, unit_price_asc, unit_price_desc. page: 1-indexed result page. page_size: Hits per page (1-100).

Returns: A structured search response.

Raises: mcp.server.mcpserver.exceptions.ToolError: If the search API is unavailable; the message starts with the API's stable error token.

Get aggregated price-history stats for one product over a date range.

Returns min/max/avg/first/last price plus the net change over the window, pooled across every store carrying the product. Pair with search_products first and pass a hit's id here verbatim.

Args: product_id: Opaque product id from a search hit (e.g. rp_550e8400e29b41d4a8b2c3d1e9f7a6c8). from_date: ISO date, inclusive lower bound (e.g. "2026-01-01"). to_date: ISO date, inclusive upper bound; defaults to today.

Returns: Aggregated price-history stats.

Raises: mcp.server.mcpserver.exceptions.ToolError: If the API is unavailable or the product is not found; the message starts with the API's stable error token.