Start a Hunt for a fashion product in Remode
watch_itemCreate or refresh an account-linked Hunt for a specific fashion product URL. Call this only when the shopper clearly wants Remode to keep watching this item over time: keep watching or looking, watch it for a lower price or second-hand options, alert or notify me, tell me or let me know when, start a Hunt, or an ask to hunt it for them that also asks what Remode will watch for, for example 'Hunt this for me and tell me what you will watch for, my size is M, I live in Switzerland': pass url, size exactly as the shopper wrote it, and region as a country code. A hypothetical or informational question about Hunts ('what would a Hunt watch for?', 'how does a Hunt work?') is not a request to start one: answer it without a write and offer to start a Hunt. A request for results now ('hunt down cheaper options for this link right now', 'find me', 'is it cheaper') is a one-time comparison: use check_price and never create a Hunt. If it is unclear whether the shopper wants ongoing watching, use check_price and offer to start a Hunt. After the call, say only Colette's confirmation at the start of the returned text, and its one question if that confirmation has one, then stop. Do not add small talk, do not say please wait, and do not say Carrie will look or that a second-hand search is running. Carrie speaks only in a later update when a verified second-hand piece exists. The rest of the returned text is the mandate, not a script to read out. A new hunt request needs no earlier read; read existing Hunts first only when the shopper refers to a Hunt they already have, because this can replace an existing Hunt's terms. Use update_watch for criteria edits; do not re-create an existing Hunt unless the shopper explicitly requests a replacement and all desired terms can be represented. Percent-off targets cannot be set here. Exact item only: the Hunt never widens to similar items. Optional terms: same-currency max_price, condition, and size supported by a retailer variant record. Explicit in_stock=false can enable restock monitoring; never infer stock. Persisted state and ongoing monitoring are inside Remode: this creates a Remode Hunt, not a reminder or scheduled task in the assistant, and Remode keeps checking until the Hunt is stopped. The call returns as soon as the Hunt is queued; it does not scan. Say only Colette's confirmation and its one question if present, then stop. Do not add small talk, do not say please wait, and do not say Carrie will look or that a second-hand search is running. Carrie speaks only in a later update when a verified second-hand piece exists.
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": {
"url": "<url>"
},
"name": "watch_item"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Retailer product URL from a Remode result. | |
| size | No | The shopper's size as the store labels it. Remode applies it only when it can read the store's own per-size stock; otherwise the Hunt continues for the exact item without a size and the result says so. | |
| color | No | The exact item's colour as the store names it. When the store sells the item in several colours, a size is applied only together with one of the store's own colour labels; on a single-colour product page the size is applied without a colour. | |
| price | No | Visible current price including currency when known. | |
| title | No | ||
| region | No | Shopping country code, such as US, CH, DE, or GB. | |
| in_stock | No | ||
| condition | No | Say-when condition for this exact item: new (new listings only; second-hand listings never count), pre_owned (second hand), or any (both). Use instead of preferences. | |
| image_url | No | ||
| max_price | No | Price finish line for this exact item: alert only at or below this price, in this currency. Must be the item's own currency; Remode never converts currencies. Works with condition new, pre_owned or any: a second-hand (pre_owned) watch can carry this absolute price ceiling. A percent-off target is not settable here. | |
| preferences | No | What Remode should look for. Defaults to lower price and second hand. | |
| use_saved_size | No | Use the shopper's saved usual size for this category as the size, when size is not given. Read-only; never changes the saved sizes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| size | No | ||
| region | Yes | ||
| watched | Yes | ||
| watch_id | Yes | ||
| preferences | Yes | ||
| price_target | No |