搜索在租房源
search_listings查询北京可展示挂牌,按楼盘分页:每页一个楼盘的全部匹配房源;明确单楼盘直查一次返回全部。用户明确回复“下一个楼盘”才沿原条件、排序和session_token传pagination.next_cursor。直查传精确property_name(名称/别名/英文名),不匹配地址标题;无需模板、不受search_ready、不修改已有需求。歧义先澄清。原样展示display_text;total、district_count、property_count为全量,listings与property_groups仅本页;property_groups区分范围内无房与未发布。note_url为笔记入口,缺失提示如实保留;listing_ref不对客展示。不提供多房源比较、顾问排名或楼盘画像;授权后才request_viewing。沿用已有令牌,无令牌保存工具返回的session_token。
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_listings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | 城市,枚举:beijing(当前有数据)、shanghai/guangzhou/shenzhen(预留)。默认 beijing | |
| sort | No | 排序:match、newest、price_asc、price_desc。默认 match | |
| cursor | No | 仅用户明确回复“下一个楼盘”时传上次pagination.next_cursor;沿用原筛选、排序和session_token,一次返回下一楼盘全部挂牌,不自动翻页 | |
| exclude | No | 用户明确不考虑的硬排除项,例如 [别墅, 服务式公寓, 合租] | |
| has_gym | No | 是否有健身房;用于筛选确认有健身房或确认无健身房的楼盘,待确认项不命中 | |
| keyword | No | 楼盘、区域或地址关键词,例如:望京、太阳宫、中建宸园 | |
| bedrooms | No | 居室数量,例如 2 | |
| district | No | 行政区划代码,例如 110105(朝阳)、110108(海淀) | |
| features | No | 受控特征标签,全部满足,例如 [bathtub, floor_heating, pet_friendly] | |
| has_pool | No | 是否有泳池;用于筛选确认有泳池或确认无泳池的楼盘,待确认项不命中 | |
| max_area | No | 最大建筑面积,平方米 | |
| min_area | No | 最小建筑面积,平方米 | |
| max_price | No | 最高月租,元 | |
| min_price | No | 最低月租,元 | |
| pet_allowed | No | 是否明确允许养宠物;空值不命中 | |
| has_elevator | No | 是否有电梯;用于筛选确认有电梯或确认无电梯的楼盘,待确认项不命中 | |
| source_agent | No | 已知客户端。 | |
| has_clubhouse | No | 是否有会所;用于筛选有会所或无会所的楼盘 | |
| property_name | No | 具体楼盘直查:单个完整楼盘名称、别名或英文名,例如:东直门8号;仅匹配楼盘,不匹配房源标题或地址。无需需求模板,不要拼入多个楼盘;通常不同时传 keyword | |
| property_type | No | 物业类型:住宅、别墅、行政公寓;也接受 1/2/3 | |
| session_token | No | 当前匿名会话令牌;已有则沿用。property_name 直查未传时会返回新令牌,不必先创建需求。仅供宿主续接会话,不展示给客户 | |
| commute_target | No | 通勤目标:guomao、wangjing、zhongguancun、jinrongjie | |
| source_channel | No | 已知宿主渠道。 | |
| consultation_id | No | 沿用系统咨询 ID。 | |
| source_campaign | No | 已知活动批次。 | |
| host_instance_id | No | 已知宿主实例/租户范围。 | |
| max_floor_height | No | 楼盘层高上限,米 | |
| min_floor_height | No | 楼盘层高下限,米 | |
| max_commute_minutes | No | 到 commute_target 的最大楼盘通勤分钟数 | |
| host_conversation_id | No | 真实宿主聊天 ID;未知省略。 |