rental-assistant

租房搜索助手

跨平台租房搜索工具，覆盖中国、美国、英国、西欧（西班牙/意大利/葡萄牙）。通过 5 个 CLI 统一查询各大租房平台，返回结构化 JSON。

前置条件

kimi-webbridge daemon 必须运行：

~/.kimi-webbridge/bin/kimi-webbridge status

未运行则先调用 kimi-webbridge skill 启动。

CLI 一览

CLI	平台	覆盖范围	需要登录
58-cli	58同城	中国大陆	否
anjuke-cli	安居客	中国大陆	否
apartments-cli	Apartments.com	美国全境	否
rightmove-cli	Rightmove	英国全境	否
idealista-cli	Idealista	西班牙/意大利/葡萄牙	否

辅助工具: xiaohongshu-cli 可搜索租房攻略和避坑经验（非结构化房源）。通过 Homebrew 安装：

brew install xpzouying/agent-cli/xiaohongshu-cli

（一次性 tap：brew tap xpzouying/agent-cli。覆盖 macOS arm64/amd64 和 Linux amd64/arm64）

所有 CLI 输出统一格式：{"ok": true, "data": {...}} / {"ok": false, "error": {"code": "...", "message": "..."}}

按地区选择 CLI

用户说	用什么
中国任意城市租房	58-cli + anjuke-cli（两个都查，对比）
美国租房	apartments-cli
英国租房	rightmove-cli
西班牙/意大利/葡萄牙租房	idealista-cli
"看看大家怎么说" / 避坑	xiaohongshu-cli search "XX租房"

命令参考

58-cli

# 搜索
58-cli search --city sz --keyword 南山 --limit 10
58-cli search --city sh --keyword 浦东 --min-price 3000 --max-price 5000 --limit 10

# 详情
58-cli detail --url "https://sz.58.com/zufang/xxxxx.shtml"

参数	说明
--city	城市缩写（sz=深圳, sh=上海, bj=北京, gz=广州, cd=成都, hz=杭州, nj=南京, wh=武汉, cq=重庆, xa=西安, tj=天津, su=苏州）
--keyword	区域/商圈/小区名
--min-price / --max-price	月租范围
--limit	返回数量（默认 20）

anjuke-cli

# 搜索
anjuke-cli search --city sz --keyword 南山 --limit 10
anjuke-cli search --city sh --keyword 张江 --min-price 3000 --max-price 6000 --limit 10

# 详情
anjuke-cli detail --city sz --id 123456789

参数	说明
--city	城市两字母代码（sz=深圳, bj=北京, sh=上海, gz=广州, hz=杭州, cd=成都, tj=天津, nj=南京, wh=武汉, cs=长沙, cq=重庆, xa=西安）
--keyword	区域/商圈/小区名
--min-price / --max-price	月租范围
--limit	返回数量（默认 20）

apartments-cli（美国）

# 搜索
apartments-cli search --location new-york-ny --min-beds 2 --max-price 3000 --limit 10
apartments-cli search --location san-francisco-ca --min-beds 1 --max-beds 2 --min-price 1500 --max-price 2500 --limit 10
apartments-cli search --location chicago-il --page 2 --limit 10

# 详情
apartments-cli detail --url "https://www.apartments.com/xxx/yyy/"

参数	说明
--location	城市 slug（格式: city-name-state，如 new-york-ny, los-angeles-ca, seattle-wa）
--min-beds / --max-beds	卧室数
--min-price / --max-price	月租范围（美元）
--limit	返回数量（默认 20）
--page	翻页

常用 location slug: new-york-ny, los-angeles-ca, san-francisco-ca, chicago-il, seattle-wa, boston-ma, washington-dc, austin-tx, denver-co, miami-fl, san-diego-ca, portland-or

rightmove-cli（英国）

# 搜索
rightmove-cli search --location London --min-beds 2 --max-price 2000 --limit 10
rightmove-cli search --location Manchester --min-beds 1 --max-beds 2 --limit 10

# 详情
rightmove-cli detail --url "https://www.rightmove.co.uk/properties/xxxxx"

参数	说明
--location	城市名（London, Manchester, Birmingham, Edinburgh, Bristol, Leeds, Liverpool, Glasgow, Cambridge, Oxford）
--min-beds / --max-beds	卧室数
--min-price / --max-price	月租范围（英镑）
--limit	返回数量（默认 20）
--page	翻页

idealista-cli（西欧）

# 搜索
idealista-cli search --country spain --city madrid-madrid --limit 10
idealista-cli search --country italy --city roma --limit 10
idealista-cli search --country portugal --city lisboa --limit 10

# 详情
idealista-cli detail --country spain --url "https://www.idealista.com/inmueble/xxxxx/"

参数	说明
--country	spain / italy / portugal
--city	城市 slug（spain: madrid-madrid, barcelona-barcelona, valencia, sevilla; italy: roma, milano, firenze; portugal: lisboa, porto）
--limit	返回数量（默认 20）

价格/房间数过滤暂未实现（idealista 用 path-based 过滤，需要按 country 分别编码）。需要过滤先全量拉取后在调用方筛选。

xiaohongshu-cli（辅助）

xiaohongshu-cli search "上海租房避坑" --limit 10
xiaohongshu-cli search "纽约租房攻略" --limit 10
xiaohongshu-cli view <note_id> <xsec_token>

工作流

中国城市租房

# 1. 两个平台同时搜（对比房源和价格）
58-cli search --city sz --keyword 南山 --min-price 3000 --max-price 5000 --limit 10
anjuke-cli search --city sz --keyword 南山 --min-price 3000 --max-price 5000 --limit 10

# 2. 看中的房源查详情
58-cli detail --url "https://sz.58.com/zufang/xxxxx.shtml"
anjuke-cli detail --city sz --id 123456789

# 3. 搜避坑经验
xiaohongshu-cli search "深圳南山租房避坑" --limit 5

美国租房

# 1. 搜索房源
apartments-cli search --location new-york-ny --min-beds 1 --max-price 2500 --limit 10

# 2. 查详情（含户型定价表、设施、图片）
apartments-cli detail --url "https://www.apartments.com/xxx/yyy/"

# 3. 搜攻略
xiaohongshu-cli search "纽约租房经验" --limit 5

英国 / 欧洲租房

# 英国
rightmove-cli search --location London --min-beds 1 --max-price 1800 --limit 10
rightmove-cli detail --url "https://www.rightmove.co.uk/properties/xxxxx"

# 西班牙
idealista-cli search --country spain --city barcelona-barcelona --limit 10
idealista-cli detail --country spain --url "https://www.idealista.com/inmueble/xxxxx/"

选房注意事项

搜到房源后，帮用户从以下角度做分析和提醒：

通勤

• 问清用户上班/上学地点，估算通勤时间
• 地铁直达 ≤30min 是舒适区，超过 45min 或换乘 2 次以上要提醒用户权衡
• 美国看开车通勤，注意高峰堵车；英国/欧洲看公共交通

性价比

• 同区域多搜几套对比，感受当地租金水位
• 中国：58 和安居客的价格可能不同，以实际为准
• 美国：apartments.com 标价通常是 range，实际入住价看详情里的 unit pricing
• 价格明显低于同区域均价的要警惕是否虚假房源

房屋状况

• 详情页有图片的优先看，注意装修新旧、采光、家具配置
• 中国关注：朝向（南向优先）、楼层（避开一楼和顶楼）、是否有独立卫生间
• 英国关注：EPC 能效等级、是否含 council tax、bills included
• 美国关注：sqft 面积、是否含水电、停车位

安全与环境

• 中国：封闭小区 > 开放式，有物业管理 > 无，独门独户 > 合租混住
• 可以用 xiaohongshu-cli search "{小区名} 避坑" 搜真实反馈
• 美国：注意周边 neighborhood safety，可提醒用户查 crime map
• 英国：注意 council 区域，不同区域治安差异大

中介与合同

• 中国：房东直租 > 正规中介 > 二房东，信息矛盾的要警惕
• 注意押付方式：押一付一最灵活，押二付三 / 付半年要考虑风险
• 英国：注意 agency fees 和 deposit protection scheme
• 美国：注意 application fee、security deposit、lease break penalty
• 西欧：注意 fianza（押金）通常 1-2 个月

合同灵活性

• 起租期长短、能否提前退租、违约金多少
• 短租需求（<6个月）优先找明确支持短租的房源
• 留学生注意合同期限是否匹配签证/学期

信息真实性

• 价格过低、图片过度精修、多平台重复发布 → 可能是引流假房源
• 联系方式只留微信不留电话 → 可能是二房东
• 挂牌时间很长还没租出去 → 可能有隐藏问题，值得追问原因

CAPTCHA 与限频

平台	CAPTCHA 风险	处理方式
58同城	低	正常使用即可
安居客	低	正常使用即可
Apartments.com	低	偶尔触发，在 Chrome 完成验证后重试
Rightmove	低	正常使用即可
Idealista	低-中	高频访问可能触发，控制请求间隔

Tips

• 输出必须带链接: 整理房源清单时，每一条都必须附上原始 URL（搜索结果里的 url 字段），方便用户直接打开查看和联系
• 中国城市同时查两个平台: 58 和安居客房源不完全重叠，两个都搜能看到更多选项
• 先搜再看详情: search 拿到列表后，挑感兴趣的再 detail，避免浪费请求
• xiaohongshu 是好帮手: 搜 "{城市}租房避坑" 可以获取真实租客反馈，帮助判断
• 注意货币单位: 中国=人民币，美国=美元，英国=英镑，西欧=欧元
• 租房 CLI 不需要登录: 5 个租房 CLI 直接用，无需任何账号
• WebBridge 必须运行: 所有 CLI 依赖 kimi-webbridge daemon（端口 10086）