Compare products
compare_productsCompare 2 to 4 products side by side, as the store's compare page does: each product's card, then the spec rows by group with one value per product in the order given, whether each row differs and which value is better where a spec can be ranked. differences says whether any row differs. A product that cannot be compared (another category, past the limit, not found) is listed under rejected with the reason. url opens the same comparison on the store's website when it has a compare page.
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": {
"products": "<products>"
},
"name": "compare_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| locale | No | Answer language: en (default en). Names, labels and URLs follow it. | |
| products | Yes | 2 to 4 products of one category: public_id, page URL or model number. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | This comparison on the store's website; null when it has no compare page. | |
| category | Yes | The category the comparison is in. | |
| products | Yes | The compared products, in the order given. | |
| rejected | Yes | ||
| truncated | No | Present and true only when the answer outgrew the size budget and its last list items were left out; ask narrower to see them. | |
| comparison | Yes | Null with fewer than two comparable products. | |
| answer_type | No | What this answer is, for rendering. | |
| differences | Yes | Whether any spec row differs. |