Find similar homes nearby
find_similar_homesHomes like one listing in its own market, picked by Cubi's similarity model.
Use when the user likes a home and wants more like it nearby ("more like
#2", "anything similar?"). Returns up to `limit` listings in the same city
with the same type family and a similar size, ranked by Cubi's similarity
model: a nearest-neighbour search over each listing's concept embedding (a
50-dimension PCA of its catalogued features) followed by a hybrid ranker
over stated features, size, location and asking price; `method` says
which embedding served the request. Each match carries a `card` (price,
size, place, link) and a `why` sentence written by the ranker from what
both listings state ("same city · within 7% on price") — relay that
reason, don't invent one. Asking prices, not valuations: never call a
match cheaper "better value".
For a home like this one in ANOTHER city, call `find_similar_elsewhere`.
Args:
listing_id: Source-prefixed id of a listing already shown (e.g.
`remax:12345`). Do not invent one.
lang: ISO 639-1 code (en/pt/es/fr/de/nl/ru) for the `why` sentences.
limit: How many matches to return (1-5, default 3).
Returns:
JSON: seed_id, count, method {embedding, ranker, scope}, matches[{card,
why, similarity}]; or a not-found message.
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": {
"listing_id": "<listing_id>"
},
"name": "find_similar_homes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | ISO 639-1 code (en/pt/es/fr/de/nl/ru) for the `why` sentences. | en |
| limit | No | How many matches to return (1-5, default 3). | |
| listing_id | Yes | Source-prefixed id of a listing already shown (e.g. `remax:12345`). Do not invent one. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |