Search products
search_productsFind product IDs and matching catalog items by query, brand, category, price, and rating; filters apply before ranking, returning titles, brands, prices, and ratings.
Instructions
Search the product catalog and return the best matches with id, title, brand, price and rating.
Use this first to find product ids. Filters are applied before ranking.
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": {
"query": "<query>"
},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | 'hybrid' (default, best overall) fuses keyword and semantic ranks; 'keyword' is BM25 full-text, best for exact model or part numbers; 'semantic' matches meaning, best for descriptive queries. | hybrid |
| brand | No | Case-insensitive substring of the brand or store name. | |
| limit | No | Number of results (1-50). | |
| query | Yes | What the user is looking for, in their own words or as keywords. | |
| category | No | Restrict to one category, e.g. 'Appliances' or 'Video_Games'. See catalog://stats. | |
| max_price | No | Maximum price in USD. Products without a price are excluded when set. | |
| min_price | No | Minimum price in USD. Products without a price are excluded when set. | |
| min_rating | No | Minimum average star rating (0-5). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| count | Yes | ||
| query | Yes | ||
| results | Yes |