Match a shopping list to products
match_shopping_listSearch every item on a shopping list in one call and return product candidates per line for building a basket; compare unit price, promotions, and stock before choosing.
Instructions
Search for every line of a shopping list in one call and return the top candidates per line. Use this first when building a basket, then pick one candidate per line (compare unit_price, promotions and stock).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"items": "<items>"
},
"name": "match_shopping_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Result order; defaults to relevance. Price sorting uses pack price, not unit price. | |
| items | Yes | Shopping-list lines; each may carry its own filters. | |
| in_stock_at | No | Only products in stock at this store (or at any store). Omit to include out-of-stock products; each product reports `in_stock` either way. | |
| candidates_per_item | No | Candidates to return per line (default 3). |