Search products across independent stores
search_productsSearches US online stores' product catalogs for shopping requests such as product types, brands, budgets and gift ideas. It covers US stores for US shoppers only. Supply requestedBrandNames as an array of the complete brand names the shopper explicitly named, or an empty array when none is named. Each result describes a selected variant, with its Nobi variant ID (id and variantId), parent productId, merchantId, source IDs, name, store, catalog price and currency, stock status, image and link. People buy from the store. When linkLabel is set, such as "We may earn a commission", show it beside that product's link. For follow-up calls in this conversation, send the visitorId returned by a previous result unchanged. Omit it on the first call; do not invent one.
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 |
|---|---|---|---|
| limit | No | How many products to return, from 1 to 20. The default is 10. | |
| query | Yes | What the user is looking for, in plain words, with the details that matter to them, such as "waterproof hiking boots" or "linen dress for a summer wedding under $150". | |
| visitorId | No | For follow-up calls in this conversation, send the visitorId returned by a previous result unchanged. Omit it on the first call; do not invent one. | |
| requestedBrandNames | No | When the shopper explicitly names brands or stores, list their complete names exactly as written, such as Regal Rose or Mirror Palais. Do not include colors, materials, styles, product types, or guessed brands. Use an empty list when none is named. This helps find the requested products even when a named brand is absent from this catalog. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| products | Yes | ||
| visitorId | No | For follow-up calls in this conversation, send the visitorId returned by a previous result unchanged. Omit it on the first call; do not invent one. |