乐有家找房

乐有家找房：通过自然语言描述查找深圳二手房或租房，返回房源列表与推荐。二手房 type=esf、租房 type=zf。仅支持深圳，city 传「深圳」。需配置 API Key 后使用。

Security Scan

The skill appears to do what it claims (search Shenzhen housing) but has a small yet important inconsistency: the runtime docs expect an LYJ_API_URL env var to be injected while the manifest only declares LYJ_API_KEY — the mismatch should be resolved before trusting it.

Purpose & Capability

Name/description match the instructions: a Shenzhen二手房/租房 search that POSTS queries to an external API. Requiring curl and an API key is proportionate to this purpose.

Instruction Scope

SKILL.md is focused on extracting search parameters and calling an external POST API. It instructs the agent to use environment variables for the key and URL and to present structured results; it does not ask the agent to read unrelated files or credentials. The instructions explicitly forbid using other skills' keys (reasonable), but that restriction depends on correct environment injection.

Install Mechanism

Instruction-only skill with no install spec or code files — lowest install risk. It only requires curl to be present.

Credentials

The manifest declares LYJ_API_KEY as required/primary, which is expected. However, SKILL.md repeatedly refers to an injected LYJ_API_URL environment variable (and suggests the plugin will inject both LYJ_API_KEY and LYJ_API_URL). LYJ_API_URL is not declared in the registry metadata. This mismatch is an inconsistency that could break the skill or hide where requests go; it should be clarified. No other unrelated credentials are requested.

Persistence & Privilege

always is false and the skill is user-invocable; autonomous invocation is allowed by default (normal). The skill does not request persistent system-wide privileges or modify other skills' configs.

What to consider before installing

This skill otherwise looks coherent for searching Shenzhen housing, but check these before installing or entering secrets: - Confirm where the agent will send requests: SKILL.md assumes both LYJ_API_KEY and LYJ_API_URL will be provided, but the registry metadata only lists LYJ_API_KEY. Ask the publisher (or the plugin installer) to declare/provide LYJ_API_URL explicitly so you know the exact endpoint. - Only provide an API key obtained from the official site (https://shenzhen.leyoujia.com). Verify the plugin/publisher identity before entering the key. - Prefer installing the official plugin package referenced in the docs (@openclaw/lyj-house) from a trusted source; inspect its manifest to ensure it injects LYJ_API_URL and does not request other unrelated secrets. - Be aware that the skill will make network requests to the configured URL using your API key. If you are uncomfortable, do not supply the key or limit the key's scope on the provider side. If the publisher fixes the LYJ_API_URL declaration (or documents the exact endpoint in the registry metadata), this assessment would likely be upgraded to benign.

通过乐有家开放接口，根据用户描述的条件检索深圳二手房或深圳租房，返回结构化房源列表并推荐最合适的房源。仅支持深圳，请求时 city 参数传 "深圳"；二手房传 type: "esf"，租房传 type: "zf"。

如何使用

• 在对话里直接说找房需求即可，例如：「帮我找一套南山两房」「福田 100 平以内三房多少钱」「我想在南山买房，预算 500 万」「南山两房月租 5000 以内」「后海附近租房」。Agent 会自动选用本技能并调用找房接口（二手房 type=esf，租房 type=zf）。
• 首次使用前需配置 API Key：在 OpenClaw 配置中填写 skills.entries.lyj-house.apiKey，或安装插件 @openclaw/lyj-house 后在插件配置项中填写。获取方式：访问 https://shenzhen.leyoujia.com ，登录后点击「申请OpenClaw密钥」。配置后，插件会把 Key 和接口地址注入为环境变量 LYJ_API_KEY、LYJ_API_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。

第二步：调用结构化找房接口

API Key 与地址： 插件已从 skills.entries.lyj-house 将 API Key 和接口地址注入为环境变量 LYJ_API_KEY、LYJ_API_URL。调用时直接使用 curl 中的 "X-Api-Key: ${LYJ_API_KEY}" 和 ${LYJ_API_URL} 即可，不要从配置里另读、猜测或使用其他渠道的 key（例如 lyj-im 的 appKey）。只要已配置 skills.entries.lyj-house.apiKey 且插件已加载，执行 curl 时环境变量即已就绪。

请求约定： 仅支持 POST；API Key 通过请求头 X-Api-Key 传递，查询条件通过请求体 raw JSON 传递（不要用 GET 或 URL 查询参数）。

兼容 Windows/PowerShell： 在 PowerShell 或 CMD 下，-d 后的内联 JSON 可能因引号/转义被破坏导致 400。此时请先将 JSON 写入临时文件（如 body.json），再用 curl -d @body.json 传递请求体，确保服务端收到正确 JSON。

# 方式一：Bash/WSL 下可直接用 -d '...'
curl -s -X POST "${LYJ_API_URL}" \
  -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}" -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}" \
  -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. 房源外网地址（仅当接口返回该字段且非空时展示，没有则省略）

插件配置

1. 访问 https://shenzhen.leyoujia.com ，登录账号，点击导航栏「申请OpenClaw密钥」获取 API Key
2. 安装插件并填入 API Key：

openclaw plugins install @openclaw/lyj-house

安装后在配置项中填入获取的 API Key 即可。

注意事项

• 当前仅支持深圳，city 传 "深圳"；二手房 type=esf，租房 type=zf
• API Key 限流：每秒最多 3 次请求，超出时请稍后重试
• 若接口返回 "无效的 API Key"，请引导用户访问 https://shenzhen.leyoujia.com 重新获取