Search products by spec
search_productsFilters verified products in one category by spec values (for example watts, weight, ports, capacity) and returns up to 10, each with its source URL and check date. Numeric filters use min/max objects keyed by field name; yes/no filters use flags. Every response lists the fields that category can be filtered and sorted on. Products with an unknown value for a filtered field are left out. Recalled products are not included.
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": {
"category": "<category>"
},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| max | No | Optional. Maximum values as an object of {numeric field name: number}; a product passes when the field is at most that number. Same field names as min. Products with no value for the field are excluded. Example: {"weight_g": 300}. | |
| min | No | Optional. Minimum values as an object of {numeric field name: number}; a product passes when the field is at least that number. Field names end in their unit (_w watts, _g grams, _mm millimetres, _mah, _gbps). Valid names depend on the category and are listed in every response under filterable_fields.numeric. Products with no value for the field are excluded. Example: {"total_output_w": 100, "usb_c_ports": 2}. | |
| lang | No | Language of text fields (notes, labels, answers). One of: "en" (English), "zh-hant" (Traditional Chinese), "zh-hans" (Simplified Chinese). Default "en". Spec values and model numbers are the same in every language. Example: "zh-hant". | en |
| brand | No | Optional. Brand name, matched exactly but ignoring case and spacing. Up to 60 characters. No default (all brands). Example: "Anker" or "UGREEN". | |
| flags | No | Optional. Yes/no conditions as an object of {boolean field name: true or false}. Valid names depend on the category and are listed in every response under filterable_fields.yes_no. Example: {"pd31_epr": true} for chargers, {"flight_ok": true} for power banks. | |
| limit | No | Maximum number of products to return: a whole number from 1 to 10. Default 10. The response also gives total_matches. Example: 5. | |
| order | No | Sort direction when sort_by is set: "asc" (smallest first) or "desc" (largest first). Default "asc". Example: "desc" with sort_by "total_output_w" for the most powerful first. | asc |
| query | No | Optional. Space-separated words that must all appear in the product name, model number or other model numbers; case is ignored. Up to 120 characters. No default. Example: "Prime 160W" or "A2687". | |
| sort_by | No | Optional. One numeric field name to sort results by (same names as min and max). Products with no value for that field are left out when sorting. No default: without it, results keep the site's own order. Example: "weight_g". | |
| category | Yes | Required. The one product category to search, as a slug. One of: "chargers", "power-banks", "usb-c-cables", "mini-pcs", "kvm-switches", "usb-c-docks", "ssds", "nas", "wireless-chargers", "monitors", "memory", "power-supplies", "cpu-coolers", "graphics-cards", "video-cables", "ethernet-cables", "pc-power-cables", "usb-cables". Example: "chargers". |