Beijing premium rental consultant: demand intake, published listings, viewing handoff.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
仅在用户主动选择菜单 9（检查更新）时调用的只读版本检查工具。传入已加载 SKILL.md 的 version，比较当前 MCP 服务声明的最新 Skill 版本；发现更新时返回可复制的宿主安装地址和更新指引。不下载、不修改本地文件；不要把工具原始结果直接展示给租客。
宿主当前加载的 SKILL.md version，例如 0.9.0；无法读取时可不传
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http rentpro https://mcp.smartrent.xin/public-mcp
仅在用户主动选择菜单 9（检查更新）时调用的只读版本检查工具。传入已加载 SKILL.md 的 version，比较当前 MCP 服务声明的最新 Skill 版本；发现更新时返回可复制的宿主安装地址和更新指引。不下载、不修改本地文件；不要把工具原始结果直接展示给租客。
| Argument | Type | Description |
|---|---|---|
| current_skill_version | string | 宿主当前加载的 SKILL.md version，例如 0.9.0；无法读取时可不传 |
{
"type": "object",
"required": [],
"properties": {
"current_skill_version": {
"type": "string",
"description": "宿主当前加载的 SKILL.md version，例如 0.9.0；无法读取时可不传"
}
}
}确认租房需求版本。推荐只传 session_token；如传 demand_id，必须同时传同一需求的 session_token。仅允许确认满足当前字段目录必填规则的版本，默认物业类型、租金预算、地段位置、居室；以 search_ready 为准。
| Argument | Type | Description |
|---|---|---|
| demand_id | number | 需求 ID |
| version_no | number | 要确认的版本号，可选；不传则确认当前版本 |
| mutation_id | string | 本次确认幂等键；宿主重试同一次写入时必须复用 |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"version_no": {
"type": "number",
"description": "要确认的版本号，可选；不传则确认当前版本"
},
"mutation_id": {
"type": "string",
"description": "本次确认幂等键；宿主重试同一次写入时必须复用"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}获取一套当前可展示挂牌的客户可读详情。默认返回完整详情；通过 include 按需返回 core、price、photos、notes、property、semantic、transport 或 surrounding。只能使用 search_listings/search_listings_by_demand 返回的真实 listing_id/listing_ref 调用；不要向客户展示 listing_ref、来源、置信度、证据、治理状态或更新时间，没有可靠事实时说明待确认，不编造。
| Argument | Type | Description |
|---|---|---|
| include | array | 按需返回：core、price、photos、notes、property、semantic、transport、surrounding；不传则返回完整详情 |
| listing_id* | number | 房源 ID，必填 |
{
"type": "object",
"required": [
"listing_id"
],
"properties": {
"include": {
"type": "array",
"items": {
"type": "string"
},
"description": "按需返回：core、price、photos、notes、property、semantic、transport、surrounding；不传则返回完整详情"
},
"listing_id": {
"type": "number",
"description": "房源 ID，必填"
}
}
}获取房源经理公开联系方式和填写入口。保存并沿用返回的 session_token；pending 表示尚未写库。仅在主动询问联系方式时调用；明确要求联系、核验或约看使用 request_viewing。
| Argument | Type | Description |
|---|---|---|
| source_agent | string | 已知客户端标识，如 dsh、workbuddy、codex；未知省略，不向客户展示。 |
| session_token | string | 沿用当前对话凭证以关联需求和客资；首次省略。 |
| source_channel | string | 真实宿主渠道，如 dsh、workbuddy；未知传 mcp，不猜测、不向客户展示。连接头优先；可选兼容旧客户端。 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"source_agent": {
"type": "string",
"description": "已知客户端标识，如 dsh、workbuddy、codex；未知省略，不向客户展示。"
},
"session_token": {
"type": "string",
"description": "沿用当前对话凭证以关联需求和客资；首次省略。"
},
"source_channel": {
"type": "string",
"description": "真实宿主渠道，如 dsh、workbuddy；未知传 mcp，不猜测、不向客户展示。连接头优先；可选兼容旧客户端。"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}读取当前可用于楼盘层级筛选的条件目录。当前严格支持：小区有泳池、小区有健身房、小区有会所、标准层高、交付日期/近 N 年内、小区有地暖、明确环线区域/沿线，以及存在五居及以上、300㎡及以上、一梯一户的真实户型；户型条件是存在型匹配，不代表整盘全部户型或当前在租。新增商场、超市/生鲜（不含菜市场）、地铁站的明确直线距离条件；附近/方便等模糊要求先澄清距离范围。环线只接受目录列出的明确区域/沿线值，不直接按原始环线字段筛选。物业公司、绿化率、园林/景观等仍等待治理。结果针对当前由运营在管理后台发布的 MCP 楼盘范围，不是挂牌房源筛选，不创建或修改租房需求。
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}读取当前租房需求、search_ready、缺失必填项及 demand_editor 授权编辑链接。网页保存后必须用原 session_token 读取最新需求，齐全再自动调用 search_listings_by_demand，未齐继续收集。也可为原需求刷新过期链接，不创建另一份需求。如传 demand_id，必须同时传同一需求的 session_token。
| Argument | Type | Description |
|---|---|---|
| demand_id | number | 需求 ID |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}读取当前基础需求字段目录 basic_catalog、必填项 required_fields、深度筛选目录和已保存条件。推荐只传 session_token；如传 demand_id，必须同时传同一需求的 session_token。字段名称与允许提交的编码以目录为准；record_only 只记录需求，不承诺用于严格筛选。目录不返回数据库来源字段。
| Argument | Type | Description |
|---|---|---|
| demand_id | number | 需求 ID |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}菜单 2、业务楼盘目录。区→商圈→楼盘逐级浏览。无参返回行政区总览overview；选区/商圈后为properties，每页最多10个楼盘。原样展示display_text，保留换行。仅明确下一页续查。不修改需求，无需session_token，不受 search_ready 门禁限制。不返回具体房源；仅本页有房楼盘创建浏览会话。listing_count=0表示发布范围内暂无可展示房源，不承诺有房。primary_layout/rent_range缺失写待运营补充，不推断。具体楼盘在租房源用search_listings(property_name=单个楼盘名称)。
| Argument | Type | Description |
|---|---|---|
| view | string | overview区域总览；properties楼盘分页。有区/商圈默认properties，否则overview；明确看全部用properties |
| cursor | string | 仅明确下一页沿原view、区/商圈传上次pagination.next_cursor；每轮一页，不自动翻完 |
| district | string | 所选区名或编码，如朝阳、110105；不修改需求 |
| business_district | string | 所选商圈名称，包含匹配；可结合district，无匹配不放宽 |
{
"type": "object",
"required": [],
"properties": {
"view": {
"type": "string",
"description": "overview区域总览；properties楼盘分页。有区/商圈默认properties，否则overview；明确看全部用properties"
},
"cursor": {
"type": "string",
"description": "仅明确下一页沿原view、区/商圈传上次pagination.next_cursor；每轮一页，不自动翻完"
},
"district": {
"type": "string",
"description": "所选区名或编码，如朝阳、110105；不修改需求"
},
"business_district": {
"type": "string",
"description": "所选商圈名称，包含匹配；可结合district，无匹配不放宽"
}
}
}查看当前需求，不自动搜索。无已填条件返回 template_mode=blank_intake 和完整空白 template，无 demand_editor，不补定制页提示、链接或按钮。有实际条件（含部分填写、不限、否定或网页筛选）返回 template_mode=saved_demand 和有效 demand_editor，在内容外单独展示编辑入口。按内容判断。推荐只传 session_token；传 demand_id 须带同一需求令牌。不提供历史浏览。
| Argument | Type | Description |
|---|---|---|
| demand_id | number | 需求 ID |
| version_no | number | 需求版本号，可选 |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"version_no": {
"type": "number",
"description": "需求版本号，可选"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}提交客户咨询/看房意向到 RentPro 后台。适用于用户愿意留联系方式、希望顾问联系、需要人工核验或对一套/多套房源明确感兴趣时；该工具只创建或补全客资包，不自动承诺预约成功。支持匿名 session_token 续接同一会话；传 demand_id 时必须同时传同一需求的 session_token，服务端会校验归属后再把当前需求版本和快照附到客资。宿主重试同一次提交时复用 mutation_id，避免重复写入。
| Argument | Type | Description |
|---|---|---|
| note | string | 客户备注，例如预算、其他需求 |
| source | string | 兼容来源字符串，例如 mcp、mcp:workbuddy、mcp:workbuddy:it_seed_user:pilot_2026_09。默认 mcp |
| lead_id | number | 已有客资 ID。若之前已创建待补充联系方式客资，再次提交时传入该 ID 进行续填 |
| summary | string | 对话需求摘要，例如预算、区域、通勤、硬性要求和已关注房源 |
| demand_id | number | 当前租房需求清单 ID。传入后自动把当前需求版本和快照附到客资，供房源经理人工核验 |
| listing_id | number | 主房源 ID，可选 |
| mutation_id | string | 本次写入幂等键；宿主重试同一次提交时必须复用同一值 |
| source_tool | string | 触发客资的工具或入口，默认 request_viewing |
| contact_name | string | 联系人姓名或称呼 |
查询北京可展示挂牌，按楼盘分页：每页一个楼盘的全部匹配房源；明确单楼盘直查一次返回全部。用户明确回复“下一个楼盘”才沿原条件、排序和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。
| Argument | Type | Description |
|---|---|---|
| city | string | 城市，枚举：beijing（当前有数据）、shanghai/guangzhou/shenzhen（预留）。默认 beijing |
| sort | string | 排序：match、newest、price_asc、price_desc。默认 match |
| cursor | string | 仅用户明确回复“下一个楼盘”时传上次pagination.next_cursor；沿用原筛选、排序和session_token，一次返回下一楼盘全部挂牌，不自动翻页 |
| exclude | array | 用户明确不考虑的硬排除项，例如 [别墅, 服务式公寓, 合租] |
| has_gym | boolean | 是否有健身房；用于筛选确认有健身房或确认无健身房的楼盘，待确认项不命中 |
| keyword | string | 楼盘、区域或地址关键词，例如：望京、太阳宫、中建宸园 |
| bedrooms | number | 居室数量，例如 2 |
| district | string | 行政区划代码，例如 110105（朝阳）、110108（海淀） |
| features | array | 受控特征标签，全部满足，例如 [bathtub, floor_heating, pet_friendly] |
按同一持久化需求搜索，结果每页一个楼盘并完整返回该楼盘的匹配挂牌，不按套数截断。仅用户明确回复“下一个楼盘”才沿原需求版本、排序和身份传next_cursor。推荐只传session_token；demand_id须带同需求令牌，未齐不搜索。原样展示display_text：有效期→同版本demand_summary→全量统计→本页楼盘资料、demand_editor→本楼盘全部挂牌。摘要保留status_label、仅记录和不限条件，零结果仍有摘要及编辑入口。total等统计全量，listings/property_groups仅本页；需求或房源变化停止翻页，不自动查完。无排名比较。
| Argument | Type | Description |
|---|---|---|
| sort | string | 排序：match、newest、price_asc、price_desc。默认 match |
| cursor | string | 仅用户明确回复“下一个楼盘”时传本次pagination.next_cursor；沿用session_token、需求版本和排序，一次返回下一楼盘全部挂牌；条件变化后重查，不自动翻页 |
| demand_id | number | 需求 ID |
| version_no | number | 需求版本号，可选 |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"sort": {
"type": "string",
"description": "排序：match、newest、price_asc、price_desc。默认 match"
},
"cursor": {
"type": "string",
"description": "仅用户明确回复“下一个楼盘”时传本次pagination.next_cursor；沿用session_token、需求版本和排序，一次返回下一楼盘全部挂牌；条件变化后重查，不自动翻页"
},
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"version_no": {
"type": "number",
"description": "需求版本号，可选"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}按楼盘条件筛选当前 MCP 发布范围中的业务楼盘，而不是挂牌房源。filters 每项含 filter_code、operator、value；多个条件默认 AND。支持泳池、健身房、会所、地暖（eq，布尔值）、标准层高（gt/gte/lt/lte/eq，单位米）、交付日期（日期比较使用 YYYY-MM-DD；within_years 使用整数年数）、明确环线区域/沿线（property_ring.zone，必须使用目录值）和户型存在型条件：house_type.is_5plus_bedroom=true、house_type.is_300plus_sqm=true、house_type.bedroom_count（室数）、house_type.area（单值面积，㎡）及 house_type.elevator_per_household='1梯1户'。实体条件 property_entity.mall_within_m、property_entity.supermarket_within_m、property_entity.metro_within_m 只接受 lt/lte，value 为大于0且不超过50000的米数；距离是登记点间直线距离，非步行时间，未查到匹配计入未知而不是确认没有配套。不接受原始 ring 字段或“三环附近”等模糊值。户型条件必须由同一真实户型满足；面积区间、缺失或冲突不命中且可能计入未知；一梯一户不等同于私密或管理严格。字段与实时可用权限以 get_property_filter_catalog 为准。返回区→商圈→楼盘、匹配事实及命中户型摘要，不创建需求、不返回挂牌；为房源入口创建临时浏览会话。
| Argument | Type | Description |
|---|---|---|
| filters* | array | 楼盘条件数组；每项含 filter_code、operator、value。多个条件默认全部满足（AND）。先读取 get_property_filter_catalog，不要自行猜字段编码。 |
{
"type": "object",
"required": [
"filters"
],
"properties": {
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"filter_code",
"value"
],
"properties": {
"value": {},
"operator": {
"type": "string"
},
"filter_code": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "楼盘条件数组；每项含 filter_code、operator、value。多个条件默认全部满足（AND）。先读取 get_property_filter_catalog，不要自行猜字段编码。"
}
}
}用户独立选择菜单数字1后启动咨询，或已启动后明确重领空表时调用。每次返回 template_mode=blank_intake，只发 intake_template，不附定制页提示/链接/按钮，该响应不返回 demand_editor；重复和重试同样适用。已有需求再选1用 render_rental_demand_template。本工具只创建或续接原草稿，不清空、不搜索、不带入启动前输入。
| Argument | Type | Description |
|---|---|---|
| mutation_id | string | 本次启动幂等键；宿主重试同一次写入时必须复用 |
| source_agent | string | 已知客户端。 |
| session_token | string | 匿名会话令牌；同一宿主会话后续继续使用，首次可不提供 |
| source_channel | string | 已知宿主渠道。 |
| consultation_id | string | 沿用系统咨询 ID。 |
| source_campaign | string | 已知活动批次。 |
| host_instance_id | string | 已知宿主实例/租户范围。 |
| host_conversation_id | string | 真实宿主聊天 ID；未知省略。 |
{
"type": "object",
"required": [],
"properties": {
"mutation_id": {
"type": "string",
"description": "本次启动幂等键；宿主重试同一次写入时必须复用"
},
"source_agent": {
"type": "string",
"description": "已知客户端。"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌；同一宿主会话后续继续使用，首次可不提供"
},
"source_channel": {
"type": "string",
"description": "已知宿主渠道。"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
},
"source_campaign": {
"type": "string",
"description": "已知活动批次。"
},
"host_instance_id": {
"type": "string",
"description": "已知宿主实例/租户范围。"
},
"host_conversation_id": {
"type": "string",
"description": "真实宿主聊天 ID；未知省略。"
}
}
}按字段级 patch 更新当前租房需求并生成新版本。推荐只传 session_token；如传 demand_id，必须同时传同一需求的 session_token。先读取 basic_catalog，仅提交允许自然语言录入的字段，未知字段会拒绝。可先保存草稿，以返回的 search_ready 和缺失字段为准；默认必填为物业类型、租金预算、地段位置、居室。null 或 clear_fields 表示清空，复合字段局部修改用嵌套对象；整体替换时在 clear_fields 中列出该字段。
| Argument | Type | Description |
|---|---|---|
| patch | object | 字段级补丁，例如 location/budget/bedrooms/area/must_have/preferred/exclude/pending/weights/clear_fields |
| status | string | 状态：active、paused、archived |
| confirm | boolean | 是否将新版本同时设为已确认版本 |
| demand_id | number | 需求 ID |
| input_text | string | 用户原始修改说明，可选 |
| mutation_id | string | 本次更新幂等键；宿主重试同一次写入时必须复用 |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
{
"type": "object",
"required": [],
"properties": {
"patch": {
"type": "object",
"properties": {},
"description": "字段级补丁，例如 location/budget/bedrooms/area/must_have/preferred/exclude/pending/weights/clear_fields"
},
"status": {
"type": "string",
"description": "状态：active、paused、archived"
},
"confirm": {
"type": "boolean",
"description": "是否将新版本同时设为已确认版本"
},
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"input_text": {
"type": "string",
"description": "用户原始修改说明，可选"
},
"mutation_id": {
"type": "string",
"description": "本次更新幂等键；宿主重试同一次写入时必须复用"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
}
}
}直接保存租房需求的深度筛选条件并生成新版本。推荐只传 session_token；如传 demand_id，必须同时传同一需求的 session_token。用户可以通过网页填写，也可以由宿主把明确表达转换成受控 filter_code 后调用。filters 是整组替换；先读取当前条件并合并未删除项。可传 version_no 和 filter_catalog_revision 做并发校验。
| Argument | Type | Description |
|---|---|---|
| filters | array | 筛选条件数组；每项含 filter_code、requirement_level、operator、value、weight |
| demand_id | number | 需求 ID |
| input_text | string | 用户原始筛选表达，可选 |
| version_no | number | 读取目录时的当前需求版本号，可选；传入后服务端做并发校验 |
| mutation_id | string | 本次深筛保存幂等键；宿主重试同一次写入时必须复用 |
| session_token | string | 匿名会话令牌 |
| consultation_id | string | 沿用系统咨询 ID。 |
| filter_catalog_revision | string | 读取目录时的深度筛选目录 revision，可选；传入后服务端做并发校验 |
{
"type": "object",
"required": [],
"properties": {
"filters": {
"type": "array",
"items": {
"type": "object",
"required": [
"filter_code",
"value"
],
"properties": {
"scope": {
"type": "string"
},
"value": {},
"weight": {
"type": "integer"
},
"operator": {
"type": "string"
},
"filter_code": {
"type": "string"
},
"source_text": {
"type": "string"
},
"target_layer": {
"type": "string"
},
"target_scope": {
"type": "string"
},
"requirement_level": {
"type": "string"
}
}
},
"description": "筛选条件数组；每项含 filter_code、requirement_level、operator、value、weight"
},
"demand_id": {
"type": "number",
"description": "需求 ID"
},
"input_text": {
"type": "string",
"description": "用户原始筛选表达，可选"
},
"version_no": {
"type": "number",
"description": "读取目录时的当前需求版本号，可选；传入后服务端做并发校验"
},
"mutation_id": {
"type": "string",
"description": "本次深筛保存幂等键；宿主重试同一次写入时必须复用"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
},
"filter_catalog_revision": {
"type": "string",
"description": "读取目录时的深度筛选目录 revision，可选；传入后服务端做并发校验"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 15, 2026.
| contact_type |
| string |
| 联系方式类型：phone 或 wechat |
| requirements | object | 结构化需求快照，例如预算、区域、居室、面积和通勤条件 |
| source_agent | string | 具体 Agent 或客户端标识，例如 workbuddy、codex、self_agent |
| contact_value | string | 手机号或微信号 |
| session_token | string | 匿名会话令牌。用于同一宿主会话续接匿名咨询；传 demand_id 时必填且必须属于同一需求；未传 demand_id 时可自动生成 |
| preferred_time | string | 期望看房时间，例如：明天下午3点 |
| source_channel | string | 自报宿主或获客渠道，例如 dsh、cursor、workbuddy、it_seed_user；未知不猜。连接头优先于参数，仅用于分析，不用于权限或结算 |
| consultation_id | string | 沿用系统咨询 ID。 |
| conversation_id | string | 宿主当前对话 ID，用于把本次客资与原始对话关联 |
| source_campaign | string | 活动或试点批次，例如 beijing_luxury_pilot_2026_09 |
| host_instance_id | string | 已知宿主实例/租户范围。 |
| interested_listings | array | 感兴趣房源 ID 列表，可包含多个 |
| host_conversation_id | string | 真实宿主聊天 ID；未知省略。 |
{
"type": "object",
"required": [],
"properties": {
"note": {
"type": "string",
"description": "客户备注，例如预算、其他需求"
},
"source": {
"type": "string",
"description": "兼容来源字符串，例如 mcp、mcp:workbuddy、mcp:workbuddy:it_seed_user:pilot_2026_09。默认 mcp"
},
"lead_id": {
"type": "number",
"description": "已有客资 ID。若之前已创建待补充联系方式客资，再次提交时传入该 ID 进行续填"
},
"summary": {
"type": "string",
"description": "对话需求摘要，例如预算、区域、通勤、硬性要求和已关注房源"
},
"demand_id": {
"type": "number",
"description": "当前租房需求清单 ID。传入后自动把当前需求版本和快照附到客资，供房源经理人工核验"
},
"listing_id": {
"type": "number",
"description": "主房源 ID，可选"
},
"mutation_id": {
"type": "string",
"description": "本次写入幂等键；宿主重试同一次提交时必须复用同一值"
},
"source_tool": {
"type": "string",
"description": "触发客资的工具或入口，默认 request_viewing"
},
"contact_name": {
"type": "string",
"description": "联系人姓名或称呼"
},
"contact_type": {
"type": "string",
"description": "联系方式类型：phone 或 wechat"
},
"requirements": {
"type": "object",
"properties": {
"avoid": {
"type": "array",
"items": {
"type": "string"
},
"description": "排除条件"
},
"area_min": {
"type": "number",
"description": "最小面积"
},
"bedrooms": {
"type": "number",
"description": "居室数"
},
"district": {
"type": "string",
"description": "行政区或偏好区域"
},
"must_have": {
"type": "array",
"items": {
"type": "string"
},
"description": "必备条件"
},
"budget_max": {
"type": "number",
"description": "最高预算"
},
"move_in_time": {
"type": "string",
"description": "计划入住时间"
},
"commute_target": {
"type": "string",
"description": "通勤目标"
},
"max_commute_minutes": {
"type": "number",
"description": "最大通勤分钟数"
}
},
"description": "结构化需求快照，例如预算、区域、居室、面积和通勤条件"
},
"source_agent": {
"type": "string",
"description": "具体 Agent 或客户端标识，例如 workbuddy、codex、self_agent"
},
"contact_value": {
"type": "string",
"description": "手机号或微信号"
},
"session_token": {
"type": "string",
"description": "匿名会话令牌。用于同一宿主会话续接匿名咨询；传 demand_id 时必填且必须属于同一需求；未传 demand_id 时可自动生成"
},
"preferred_time": {
"type": "string",
"description": "期望看房时间，例如：明天下午3点"
},
"source_channel": {
"type": "string",
"description": "自报宿主或获客渠道，例如 dsh、cursor、workbuddy、it_seed_user；未知不猜。连接头优先于参数，仅用于分析，不用于权限或结算"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
},
"conversation_id": {
"type": "string",
"description": "宿主当前对话 ID，用于把本次客资与原始对话关联"
},
"source_campaign": {
"type": "string",
"description": "活动或试点批次，例如 beijing_luxury_pilot_2026_09"
},
"host_instance_id": {
"type": "string",
"description": "已知宿主实例/租户范围。"
},
"interested_listings": {
"type": "array",
"items": {
"type": "number"
},
"description": "感兴趣房源 ID 列表，可包含多个"
},
"host_conversation_id": {
"type": "string",
"description": "真实宿主聊天 ID；未知省略。"
}
}
}| has_pool | boolean | 是否有泳池；用于筛选确认有泳池或确认无泳池的楼盘，待确认项不命中 |
| max_area | number | 最大建筑面积，平方米 |
| min_area | number | 最小建筑面积，平方米 |
| max_price | number | 最高月租，元 |
| min_price | number | 最低月租，元 |
| pet_allowed | boolean | 是否明确允许养宠物；空值不命中 |
| has_elevator | boolean | 是否有电梯；用于筛选确认有电梯或确认无电梯的楼盘，待确认项不命中 |
| source_agent | string | 已知客户端。 |
| has_clubhouse | boolean | 是否有会所；用于筛选有会所或无会所的楼盘 |
| property_name | string | 具体楼盘直查：单个完整楼盘名称、别名或英文名，例如：东直门8号；仅匹配楼盘，不匹配房源标题或地址。无需需求模板，不要拼入多个楼盘；通常不同时传 keyword |
| property_type | string | 物业类型：住宅、别墅、行政公寓；也接受 1/2/3 |
| session_token | string | 当前匿名会话令牌；已有则沿用。property_name 直查未传时会返回新令牌，不必先创建需求。仅供宿主续接会话，不展示给客户 |
| commute_target | string | 通勤目标：guomao、wangjing、zhongguancun、jinrongjie |
| source_channel | string | 已知宿主渠道。 |
| consultation_id | string | 沿用系统咨询 ID。 |
| source_campaign | string | 已知活动批次。 |
| host_instance_id | string | 已知宿主实例/租户范围。 |
| max_floor_height | number | 楼盘层高上限，米 |
| min_floor_height | number | 楼盘层高下限，米 |
| max_commute_minutes | number | 到 commute_target 的最大楼盘通勤分钟数 |
| host_conversation_id | string | 真实宿主聊天 ID；未知省略。 |
{
"type": "object",
"required": [],
"properties": {
"city": {
"type": "string",
"description": "城市，枚举：beijing（当前有数据）、shanghai/guangzhou/shenzhen（预留）。默认 beijing"
},
"sort": {
"type": "string",
"description": "排序：match、newest、price_asc、price_desc。默认 match"
},
"cursor": {
"type": "string",
"description": "仅用户明确回复“下一个楼盘”时传上次pagination.next_cursor；沿用原筛选、排序和session_token，一次返回下一楼盘全部挂牌，不自动翻页"
},
"exclude": {
"type": "array",
"items": {
"type": "string"
},
"description": "用户明确不考虑的硬排除项，例如 [别墅, 服务式公寓, 合租]"
},
"has_gym": {
"type": "boolean",
"description": "是否有健身房；用于筛选确认有健身房或确认无健身房的楼盘，待确认项不命中"
},
"keyword": {
"type": "string",
"description": "楼盘、区域或地址关键词，例如：望京、太阳宫、中建宸园"
},
"bedrooms": {
"type": "number",
"description": "居室数量，例如 2"
},
"district": {
"type": "string",
"description": "行政区划代码，例如 110105（朝阳）、110108（海淀）"
},
"features": {
"type": "array",
"items": {
"type": "string"
},
"description": "受控特征标签，全部满足，例如 [bathtub, floor_heating, pet_friendly]"
},
"has_pool": {
"type": "boolean",
"description": "是否有泳池；用于筛选确认有泳池或确认无泳池的楼盘，待确认项不命中"
},
"max_area": {
"type": "number",
"description": "最大建筑面积，平方米"
},
"min_area": {
"type": "number",
"description": "最小建筑面积，平方米"
},
"max_price": {
"type": "number",
"description": "最高月租，元"
},
"min_price": {
"type": "number",
"description": "最低月租，元"
},
"pet_allowed": {
"type": "boolean",
"description": "是否明确允许养宠物；空值不命中"
},
"has_elevator": {
"type": "boolean",
"description": "是否有电梯；用于筛选确认有电梯或确认无电梯的楼盘，待确认项不命中"
},
"source_agent": {
"type": "string",
"description": "已知客户端。"
},
"has_clubhouse": {
"type": "boolean",
"description": "是否有会所；用于筛选有会所或无会所的楼盘"
},
"property_name": {
"type": "string",
"description": "具体楼盘直查：单个完整楼盘名称、别名或英文名，例如：东直门8号；仅匹配楼盘，不匹配房源标题或地址。无需需求模板，不要拼入多个楼盘；通常不同时传 keyword"
},
"property_type": {
"type": "string",
"description": "物业类型：住宅、别墅、行政公寓；也接受 1/2/3"
},
"session_token": {
"type": "string",
"description": "当前匿名会话令牌；已有则沿用。property_name 直查未传时会返回新令牌，不必先创建需求。仅供宿主续接会话，不展示给客户"
},
"commute_target": {
"type": "string",
"description": "通勤目标：guomao、wangjing、zhongguancun、jinrongjie"
},
"source_channel": {
"type": "string",
"description": "已知宿主渠道。"
},
"consultation_id": {
"type": "string",
"description": "沿用系统咨询 ID。"
},
"source_campaign": {
"type": "string",
"description": "已知活动批次。"
},
"host_instance_id": {
"type": "string",
"description": "已知宿主实例/租户范围。"
},
"max_floor_height": {
"type": "number",
"description": "楼盘层高上限，米"
},
"min_floor_height": {
"type": "number",
"description": "楼盘层高下限，米"
},
"max_commute_minutes": {
"type": "number",
"description": "到 commute_target 的最大楼盘通勤分钟数"
},
"host_conversation_id": {
"type": "string",
"description": "真实宿主聊天 ID；未知省略。"
}
}
}