SkillHub

lyj-house

v1.0.5

乐有家找房：自然语言查深圳二手房与租房

Sourced from ClawHub, Authored by xianshen tan

Installation

Please help me install the skill `lyj-house` from SkillHub official store. npx skills add tandangfei/lyj-house

乐有家找房

根据用户自然语言条件检索深圳二手房（type=esf）或深圳租房（type=zf），返回房源列表并推荐。仅支持深圳，city 固定传 "深圳"。

如何使用

  • 直接说需求：如「帮我找一套南山两房」「福田 100 平三房」「南山两房月租 5000 以内」，Agent 会选用本技能并调用接口。
  • 只需配置 API Key：在 OpenClaw 配置中填写 skills.entries.lyj-house.apiKey，或安装乐有家找房插件后在插件配置中填写。Key 获取：https://shenzhen.leyoujia.com → 登录 → 「申请OpenClaw密钥」。接口地址固定为 https://wap.leyoujia.com/wap/openclaw/ai/house/search，无需配置。
  • 调用方式：安装插件后会自动注入 LYJ_API_KEY 与 LYJ_API_URL；仅安装本 Skill 时请手动设置环境变量 LYJ_API_KEY，curl 中 URL 使用上述固定地址。不要使用其它技能/插件的 key。

使用时机

✅ 以下情况启用此技能：

  • "帮我找一套南山两房"（二手房，type=esf）
  • "福田 100 平以内三房多少钱"（二手房，type=esf）
  • "我想在南山买房，预算 500 万"（二手房，type=esf）
  • "南山两房月租 5000 以内"（租房，type=zf）
  • "后海附近租房"（租房，type=zf）
  • 任何涉及深圳二手房、买房、租房的请求

❌ 以下情况不使用此技能：

  • 房产政策、贷款计算等咨询类问题（直接回答）
  • 新房/楼盘咨询（引导用户访问 https://www.leyoujia.com）
  • 非深圳城市（告知用户当前仅支持深圳）

工作流程

第一步：提取找房条件

从用户消息中识别以下条件（有即填，无则不传）。城市 city 固定传 "深圳"（仅支持深圳）；交易类型 type：用户要买房/二手房传 esf，要租房传 zf。除 type/city、keyword/priceMin/priceMax/areaMin/areaMax 传字符串或数值外，其余参数传对应的 数字 code。

基础参数

参数 说明 值
type 交易类型 esf=二手房，zf=租房
city 城市 固定为 "深圳"（仅支持深圳）
keyword 关键词搜索房源标题 如 南山学区
priceMin 总价下限（万元整数） 如 200
priceMax 总价上限（万元整数） 如 600

户型参数

参数 说明 code 映射
room 居室 1=一房 2=两房/二房 3=三房 4=四房 5=五房 6=五房以上
toilet 卫生间 1=一卫 2=两卫/二卫 3=三卫 4=四卫 5=五卫 6=五卫以上
balcony 阳台 1=一阳 2=二阳 3=二阳以上
areaMin 面积下限（㎡整数） 如 80
areaMax 面积上限（㎡整数） 如 120
orientation 朝向 69=东 70=南 71=西 72=北 73=东南 74=东北 75=西南 76=西北 77=南北 78=全南
hxFeature 户型特色（多值用 _ 分隔） 1=户型方正 2=通透 3=客厅开阔 4=视野开阔 5=厅带阳台 6=卧室阳台 7=浴室阳台 8=卧室带卫 9=带衣帽间 10=可放浴缸 11=开放厨房 12=入户花园 13=安静 14=大阳台 15=高赠送 16=带露台 17=卧室朝南 18=飘窗 19=落地窗
jgFeature 景观特色（多值用 _ 分隔） 1=海景 2=山景 3=湖景 4=城市景观 5=高尔夫景观

更多筛选

参数 说明 code 映射
tags 房源特色（多值用 _ 分隔） 1=新上 3=满五唯一 4=满两年 5=红本在手 6=随时可看 7=急售 8=有电梯 9=近地铁 10=非地下室 11=有视频 12=VR看房 18=学区房 22=满五年 27=实地核验 28=必卖好房 37=最近降价 38=有露台 39=高租售比 40=无电梯
propertyType 物业类型 1=住宅 2=公寓 3=别墅 4=商铺 5=车位/车库 6=写字楼 7=其他
elevator 电梯 1=有电梯 2=无电梯
buildingAge 楼龄 1=2年以内 2=5年以内 3=10年以内 4=15年以内 5=20年以内 6=20年以上
fitment 装修 46=毛坯 47=普装 48=精装 49=豪装

区域参数

参数 说明 示例
areaCode 城区 code 000003=福田 000021=罗湖 000035=南山 000045=盐田 000048=宝安 000060=龙岗 002806=龙华 002811=光明 002812=坪山 002813=大鹏
placeCode 片区 code（比 areaCode 更精确，优先使用） 见下方片区表

常用片区 code（深圳）： 福田：000004=八卦岭 000007=莲花 000011=景田 000012=香蜜湖 000013=上梅林 000015=车公庙 079655=华强北 089445=福田中心 罗湖：000022=洪湖 000024=黄贝岭 000026=布心 000027=翠竹 000030=东门 000032=蔡屋围 南山：000036=华侨城 000037=科技北 000038=西丽 000039=南头 000040=南油 000041=前海南 000042=后海 000044=蛇口 082284=华润城 089394=深圳湾 089395=红树湾 宝安：000051=宝安中心 000052=新安 000053=西乡 000055=沙井 000056=福永 龙岗：000061=坂田 000064=横岗 088480=大运 龙华：002807=龙华中心 002808=大浪 002809=民治 002810=观澜 079660=梅林关

直接根据已有信息构造参数，不必追问所有字段。若用户提到具体地名（如"南山"、"后海"、"蛇口"），优先使用 placeCode；若只提到区（如"南山区"），使用 areaCode。

第二步：调用找房接口

  • URL：https://wap.leyoujia.com/wap/openclaw/ai/house/search（固定，无需配置）。
  • 鉴权：请求头 X-Api-Key: ${LYJ_API_KEY}。
  • 方式：仅支持 POST，请求体为 raw JSON，勿用 GET 或 URL 参数。
  • Windows/PowerShell：内联 JSON 易被转义破坏，建议将 body 写入 body.json 后使用 curl -d @body.json。
# 方式一：Bash/WSL 下可直接用 -d '...'（URL 未设置时使用固定地址）
curl -s -X POST "${LYJ_API_URL:-https://wap.leyoujia.com/wap/openclaw/ai/house/search}" 
  -H "X-Api-Key: ${LYJ_API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{"type":"esf","city":"深圳","areaCode":"000035","room":"2","priceMax":600}'

# 方式二：Windows/PowerShell 下建议用文件传 body，避免转义问题
echo '{"type":"esf","city":"深圳","areaCode":"000035","room":"2","priceMax":600}' > body.json
curl -s -X POST "${LYJ_API_URL:-https://wap.leyoujia.com/wap/openclaw/ai/house/search}" -H "X-Api-Key: ${LYJ_API_KEY}" -H "Content-Type: application/json" -d "@body.json"

第三步：解析结果并推荐

接口返回 JSON 格式，包含 total（总量）和 list（最多 30 套）。从列表中选出 3～5 套最符合用户需求的房源，按下方「展示字段规范」逐条展示；若接口未返回某字段则省略该行，房源外网地址没有则不展示。

完整示例

用户说： "帮我在南山后海找一套两房，总价 600 万以内，最好靠近地铁，精装"

构造请求：（PowerShell 下若遇 400，改用 echo '...' > body.json 再 curl -d @body.json）

curl -s -X POST "${LYJ_API_URL:-https://wap.leyoujia.com/wap/openclaw/ai/house/search}" 
  -H "X-Api-Key: ${LYJ_API_KEY}" 
  -H "Content-Type: application/json" 
  -d '{"type":"esf","city":"深圳","placeCode":"000042","room":"2","priceMax":600,"fitment":"48","tags":"9"}'

按「展示字段规范」展示前 3～5 套最符合条件的房源；有房源外网地址时附上，没有则不展示。

展示字段规范

向用户展示每套房源时，按以下顺序包含下列内容（接口有则展示，无则省略；房源外网地址没有则不展示）：

  1. 房源标题
  2. 居室、卫生间、面积、朝向、小区
  3. 房源标签
  4. 总价、均价
  5. 用途、装修、产权、建成、电梯
  6. 位置：小区的地址
  7. 周边：交通、学校
  8. 小区名称、小区开发商、小区物业公司
  9. 小区物业费、小区停车费
  10. 房源亮点：生成的亮点
  11. 房源外网地址（仅当接口返回该字段且非空时展示，没有则省略）

注意事项

  • 仅支持深圳：city 传 "深圳"；二手房 type=esf，租房 type=zf。
  • 限流：每秒最多 3 次请求；若返回「无效的 API Key」，引导用户至 https://shenzhen.leyoujia.com 重新申请。