search
Find car versions in Carbase by brand, model, filters, and name keywords; retrieve list prices, fuel types, and version IDs for specification lookup or comparison.
Instructions
Search Carbase by brand, model and/or filters. Returns at most max_versions versions.
filters: filter key -> option value(s) or a range, keys and values from list_filters. e.g. {"fuel_type": ["elektrisch", "elektro-benzine"], "body": "suv", "price": {"max": 40000}, "year": {"min": 2022}} name_contains: keep only versions whose name contains all these words ("1.5 tsi"). sort: orders model generations (for "price": by their cheapest version) and, with "price", the versions inside each generation. It is not a global ranking of versions: for "the N cheapest", fetch more (e.g. max_versions=100) and compare the prices. cursor: next_cursor from a previous call with the same arguments, to continue.
Returns total_versions (Carbase's count, before name_contains), returned, next_cursor (null when there is nothing more) and model generations (model, body, years, price range), each with its versions (id, name, years, fuel, transmission, energy label, list price, bijtelling %). Prefer narrowing (filters, name_contains) over paging through hundreds of versions. Use a version id with get_specs or compare_versions.
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": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | make_model | |
| brand | No | ||
| model | No | Model slug from list_models, e.g. 'golf' | |
| cursor | No | ||
| filters | No | ||
| descending | No | ||
| max_versions | No | ||
| name_contains | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | Yes | ||
| returned | Yes | ||
| generations | Yes | ||
| next_cursor | Yes | ||
| total_versions | Yes |