Find current deals for a need
search_dealsUse when someone wants to buy something, precise or vague ('noise-cancelling headphones under 200 €', 'a gift for a DIY dad'). Returns at most five offers seen in the last three days in France or Germany, each with price, merchant link when known, separate relevance, deal-quality and purchase-feasibility signals, and its unknowns; or 'no_offer' with the reason. max_price, ship_to and exclude are hard limits. Offers marked 'lead' are real but unconfirmed: check the merchant page before presenting them as available. Each offer has a merchant_link status: 'resolved' (merchant_url is the product page), 'pending' (being looked up: repeat the same search after retry_after_seconds, once), 'abandoned' with a reason (no lookup is under way: use merchant_search_url) or 'unknown'. merchant_market is the country of the shop and cross_border is true when it differs from ship_to: delivery there is then unverified. delivery gives the shipping cost the listing stated, not a quote for an address. id identifies the same offer across calls. The merchant's live price is never rechecked: purchase_feasibility stays below 1.0 and every limit on it is named in unknowns. 'no_offer' comes with the limits applied and why recent candidates were left out. A 'no_offer' answer may carry 'alternatives': at most two offers of the same product type, inside the same limits. An alternative is not what was asked: say so to the person, with what 'differs' lists (an 'observed' of null means unknown, not identical).
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_deals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | What the buyer wants, as said. | |
| exclude | No | Words an offer must not contain. | |
| ship_to | No | Delivery country, ISO 3166-1 alpha-2. | |
| currency | No | Currency of the ceiling. Only EUR is served. | EUR |
| max_price | No | Hard ceiling in euros. Never exceeded. | |
| price_includes_shipping | No | True when the ceiling must cover delivery too. |