Search used cars for sale
hm_search_carsFind used and zero-km cars sold in Hamrah Mechanic showrooms by filtering on brand, model, city, price, mileage, year, body type, fuel, gearbox, and color.
Instructions
Search the used and zero-km cars Hamrah Mechanic's showrooms sell, with filters.
Returns ad cards; hm_car gives one ad in full. Filters are inclusive; total is the match count. A brand also
matches its Iranian-assembled models; those cards add maker (e.g. saipa).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "hm_search_cars"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | ||
| city | No | ||
| fuel | No | ||
| page | No | 24 ads per page. | |
| sort | No | Order of results. | default |
| brand | No | Brand slug from hm_brands (one only), e.g. toyota. | |
| color | No | ||
| model | No | Model slug from hm_models; needs `brand`. | |
| max_km | No | Most km driven; 0 = zero-km only. | |
| origin | No | Imported, ChineseAssembly or Iranian. | |
| gearbox | No | ||
| year_max | No | Newest model year. | |
| year_min | No | Oldest model year (Solar or Gregorian, as the ad shows). | |
| price_max | No | Highest price, million Toman. | |
| price_min | No | Lowest price, million Toman (1000 = 1 billion). | |
| installments | No | Only cars that can be bought in installments. | |
| showroom_only | No | Only showroom stock. |