search_products
Search grocery product catalogs by keyword with filters for country, retailer, brand, category, and price to find matching products with pricing and retailer info.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| tag | No | ||
| city | No | ||
| page | No | ||
| sort | No | ||
| brand | No | ||
| chain | No | ||
| country | No | ||
| category | No | ||
| currency | No | ||
| retailer | No | ||
| max_price | No | ||
| min_price | No | ||
| page_size | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hits | Yes | ||
| page | Yes | ||
| found | Yes | ||
| query | Yes | ||
| facets | Yes | ||
| page_size | Yes |