find_deals
Find purchasing options for a specified product, including offers for the same product, alternatives with compatible key attributes, and models with specification upgrades or downgrades. Prices are in USD. query applies only to dupe/ladder. For same_product, use search_products(query) to select a Product first, then pass its product_id without query. Alternative requirements include alternatives joined with or, reference values to keep or not fall below, and specs allowed to get worse. Returns results with product_id, offer_id, title, purchase url, price, currency, seller, coupon and differences, plus summary, comparison and coverage. For dupe/ladder, an optional reference identifies the reference product and price; optional results[].price_delta is the USD difference for the reference quantity (negative is cheaper). Ladder results[].direction is up, down or mixed for specification changes, not price movement. summary reports comparison and returned-offer counts. comparison.product_count, offer_count and retailer_count count distinct products, eligible offers and known retailers whose prices were compared in this call before applicable price filters and the result limit; dupe counts include the reference product. Price excludes tax and shipping and already deducts the single applicable coupon.discount shown; do not deduct it again. The coupon still requires application and its conditions must be met. A null discount is not deducted; a null coupon does not prove no promotion exists. New sellers have null offer_id; use their purchase URL. Returns available purchase quotes only; when no eligible quotes are found, results is empty. Read differences for suitability: matching catalog specs does not guarantee every function is identical. coverage explains the price basis for the requested mode, candidate scope, result limits and unverified attributes. Requirements that cannot be mapped are excluded from filtering and listed in differences and coverage; tell the shopper which conditions were excluded and report the results obtained using the remaining conditions.
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": {
"product": "<product>"
},
"name": "find_deals"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | mode=same_product matches the reference listing or standalone description; conflicting variants and international, refurbished, rental or custom listings go in set_aside. Unspecified pack sizes/options may differ. Requirements are matched by search_products at Product level; omit query here. mode=dupe finds alternative models with compatible key attributes; they may be cheaper or more expensive than the reference product. mode=ladder finds models with specification upgrades or downgrades and shows the differences. | same_product |
| query | No | Optional Product requirements for dupe/ladder only. For same_product, send requirements to search_products and pass the selected product_id without query. Unmapped requirements are reported as unverified. Use short feature/value clauses for stated requirements; preserve exact values, ranges, comparison directions and exclusions. Label soft preferences as preferred. Include an absolute USD budget, a cheaper-than-reference requirement, a request to keep a reference value ("keep the capacity") or not fall below it ("battery life no worse"), or permission for a spec to get worse ("capacity may be smaller") only when the shopper asks; otherwise do not infer them. State accepted alternatives with "or"; requirements they share apply to each. A budget is optional. Keep the reference item in product; do not turn its brand/model into candidate filters unless requested. Leave fact-reporting requests without target values and answer-format instructions out of query; retain them for detail checks and the answer. Do not loosen stated requirements yourself to obtain results; pass on only the shopper's own permission for a spec to get worse. Rating, review-count and order requests are not filters here and are reported as unresolved. Omit query when no extra conditions apply. | |
| product | Yes | One product URL, ASIN, GTIN, product ID, model number or short description. Pass URLs and IDs alone, without appended requirements. |