@jjs-wlkj/lyj-house 2026.3.12

package/PUBLISH-AND-INTEGRATE.md

@@ -0,0 +1,155 @@
+# 乐有家找房：发布到市场与官网集成说明
+
+本文档包含：**一、上传到各市场的方式**；**二、官网可引用的「集成与使用」说明**（可直接放到乐有家官网）。
+
+---
+
+## 一、上传到主流市场的方式
+
+乐有家找房包含两部分，发布方式不同：
+
+| 类型 | 说明 | 发布入口 |
+|------|------|----------|
+| **Skill（技能）** | 仅含 `SKILL.md` 的文件夹，供 OpenClaw Agent 调用找房能力 | ClawHub（OpenClaw 官方技能市场） |
+| **Plugin（插件）** | 含配置项、API Key 注入等，用户安装后自动配置环境变量 | npm（可选，与 ClawHub 互补） |
+
+### 1. ClawHub（OpenClaw 技能市场，推荐）
+
+- **站点**：https://clawhub.ai（或 https://clawhub.com）
+- **发布对象**：skill 文件夹（含 `SKILL.md` 的目录），例如仓库中的 `skills/lyj-house`。
+
+**步骤：**
+
+1. 确保已把 `extensions/lyj-house/skills/lyj-house/SKILL.md` 同步到 `skills/lyj-house/SKILL.md`。
+2. 安装 ClawHub CLI：
+   ```bash
+   npm i -g clawhub
+   ```
+   或：`pnpm add -g clawhub`
+3. 登录（需 GitHub 账号，且账号至少注册满一周）：
+   ```bash
+   clawhub login
+   ```
+4. 发布技能（在仓库根目录执行）：
+   ```bash
+   clawhub publish ./skills/lyj-house --slug lyj-house --name "乐有家找房" --version 1.0.0 --changelog "支持深圳二手房与租房" --tags latest
+   ```
+5. 后续更新版本时，可改用 `--version 1.1.0` 并写清 `--changelog`，或使用：
+   ```bash
+   clawhub sync --root ./skills --all --bump patch --changelog "更新说明"
+   ```
+
+用户可在 ClawHub 搜索「乐有家找房」或 `lyj-house`，通过 `clawhub install lyj-house` 安装到本地。
+
+### 2. npm（插件包，可选）
+
+若希望用户通过一条命令安装「插件 + 配置项」，可把插件发布到 npm。
+
+- **发布对象**：`extensions/lyj-house` 整个包（含 `openclaw.plugin.json`、`index.ts`、`skills/` 等）。
+- **包名示例**：`@openclaw/lyj-house` 或 `openclaw-lyj-house`（scope 包需 `--access public`）。
+
+**步骤：**
+
+1. 在 `extensions/lyj-house` 下确认 `package.json` 的 `name`、`version`、`description`。
+2. 登录 npm 并发布：
+   ```bash
+   cd extensions/lyj-house
+   npm login
+   npm publish --access public
+   ```
+
+用户安装方式：`openclaw plugins install @openclaw/lyj-house`（或你发布的包名）。
+
+### 3. 其他说明
+
+- **仅 ClawHub**：只发布 skill 时，用户需自行把技能目录放到工作区 `skills/lyj-house/`，并在配置里填写 `skills.entries.lyj-house.apiKey`；若同时安装了你发布的**插件**，则插件会注入 `LYJ_API_KEY`、`LYJ_API_URL`，无需再改环境变量。
+- **ClawHub + npm**：用户可先在 ClawHub 安装技能 `lyj-house`，再 `openclaw plugins install @openclaw/lyj-house` 并配置 API Key，体验最完整。
+
+---
+
+## 二、官网集成说明（可直接放到乐有家官网）
+
+以下内容可直接或稍作修改后放在乐有家官网的「OpenClaw 集成」或「智能体找房」说明页。
+
+---
+
+### 乐有家找房 · OpenClaw 集成指南
+
+乐有家找房技能已上架 **OpenClaw 技能市场（ClawHub）**，支持在 OpenClaw 智能体里用自然语言查**深圳二手房**和**深圳租房**。
+
+#### 前置条件
+
+- 已安装 [OpenClaw](https://docs.openclaw.ai)（CLI 或带 Gateway 的客户端）。
+- 已拥有乐有家找房 API Key（在 [深圳乐有家](https://shenzhen.leyoujia.com) 登录后，点击「申请OpenClaw密钥」获取）。
+
+---
+
+#### 方式一：从 ClawHub 安装技能（推荐）
+
+1. 安装 ClawHub CLI：
+   ```bash
+   npm i -g clawhub
+   ```
+2. 安装「乐有家找房」技能：
+   ```bash
+   clawhub install lyj-house
+   ```
+3. 配置 API Key：编辑 OpenClaw 配置文件（一般为 `~/.openclaw/openclaw.json`），在 `skills.entries.lyj-house` 下填写 `apiKey`，可选填写 `config.apiBase`（不填则使用默认接口地址）：
+   ```json
+   {
+     "skills": {
+       "entries": {
+         "lyj-house": {
+           "apiKey": "您在乐有家申请的API密钥",
+           "config": {
+             "apiBase": "https://wap.leyoujia.com"
+           }
+         }
+       }
+     }
+   }
+   ```
+4. 若使用 Gateway（如 Mac 菜单栏或 Web）：重启 Gateway 或重新打开会话，使配置生效。
+
+---
+
+#### 方式二：安装乐有家找房插件（可选，自动注入配置）
+
+若技能已通过 npm 发布为插件，用户可安装插件后再配置 API Key，由插件自动注入环境变量：
+
+1. 安装插件：
+   ```bash
+   openclaw plugins install @openclaw/lyj-house
+   ```
+2. 在 OpenClaw 配置中填写 `skills.entries.lyj-house.apiKey`（同上），可选填写 `config.apiBase`。
+3. 重启 Gateway 或重新打开会话。
+
+---
+
+#### 使用方式
+
+在已启用该技能/插件的 OpenClaw 对话中，直接说出找房或租房需求即可，例如：
+
+- **二手房**：「帮我找一套南山两房」「福田 100 平以内三房，总价 600 万」
+- **租房**：「南山两房月租 5000 以内」「后海附近租房」
+
+智能体会自动调用乐有家找房接口并返回房源列表与推荐。当前仅支持**深圳**区域。
+
+---
+
+#### 接口与密钥说明
+
+- 找房接口由乐有家提供，请求需携带 API Key（通过 OpenClaw 配置中的 `skills.entries.lyj-house.apiKey` 传入）。
+- 密钥申请与使用条款以乐有家官网为准；如有疑问，请咨询乐有家客服或开放平台支持。
+
+---
+
+#### 相关链接
+
+- OpenClaw 文档：https://docs.openclaw.ai  
+- ClawHub 技能市场：https://clawhub.ai  
+- 乐有家深圳站（申请 API Key）：https://shenzhen.leyoujia.com  
+
+---
+
+以上「二、官网集成说明」可直接复制到官网；若你们有单独的「开发者/开放平台」页面，也可只保留「方式一 + 使用方式 + 相关链接」，并注明「如需一键配置可安装乐有家找房插件（见 ClawHub 或 npm）」。

package/README.md

@@ -0,0 +1,132 @@
+# 乐有家 AI 找房插件
+
+通过自然语言描述查找深圳二手房。插件在加载时从 `skills.entries.lyj-house` 读取 API Key 和接口地址并注入环境变量，供内嵌 skill 的 curl 命令使用。
+
+## 开发时本地测试
+
+### 1. 用链接方式安装插件（改代码即生效，无需重复安装）
+
+在仓库根目录执行：
+
+```bash
+pnpm openclaw plugins install -l ./extensions/lyj-house
+```
+
+或使用绝对路径：
+
+```bash
+pnpm openclaw plugins install -l E:\工作\e2e\openclaw-fork\extensions\lyj-house
+```
+
+`-l`（`--link`）会把插件路径写入 `plugins.load.paths`，不拷贝文件，适合边改边测。
+
+### 2. 启用插件并配置
+
+在 `~/.openclaw/openclaw.json` 中确保：
+
+- `plugins.entries.lyj-house.enabled` 为 `true`（若存在）
+- `skills.entries.lyj-house` 已配置：
+  - `apiKey`：必填
+  - `config.apiBase`：选填，不填则用默认 `https://shenzhen.leyoujia.com`
+
+示例：
+
+```json
+"skills": {
+  "entries": {
+    "lyj-house": {
+      "apiKey": "你的API密钥",
+      "config": {
+        "apiBase": "https://shenzhen.leyoujia.com"
+      }
+    }
+  }
+}
+```
+
+若插件被禁用，可在配置里把 `plugins.entries.lyj-house.enabled` 设为 `true`。
+
+### 3. 重启 Gateway / 重新打开 TUI
+
+配置或插件代码变更后需要重新加载：
+
+- 若用 **Gateway**：重启网关（例如重启 Mac 菜单栏应用或重新执行 `openclaw gateway run`）
+- 若用 **TUI**：关闭后重新执行 `pnpm openclaw tui`
+
+### 4. 触发 skill 做联调
+
+- **TUI**：在对话里输入例如「帮我找一套南山两房」「福田 100 平以内三房」等，Agent 会选用 lyj-house skill 并调用你的接口。
+- **其他渠道**：通过 Telegram、Web 等已接入的 channel 发同样类型的找房消息即可。
+
+### 5. 可选：从本地目录拷贝安装
+
+若不想用 link，可以每次从本地目录安装（会拷贝到 `~/.openclaw/extensions/lyj-house`）：
+
+```bash
+pnpm openclaw plugins install ./extensions/lyj-house
+```
+
+修改代码后需重新执行上述命令才会生效。
+
+---
+
+## 保持两份 SKILL.md 一致
+
+- **主本**：`extensions/lyj-house/skills/lyj-house/SKILL.md`（开发时只改这一份）
+- **副本**：`skills/lyj-house/SKILL.md`（仓库 bundled skill，发布到 skill 市场时用）
+
+开发完成后、或准备发版前，把主本覆盖到副本，保证两份一致。例如在仓库根目录：
+
+**Windows (PowerShell):**
+
+```powershell
+Copy-Item -Path "extensions\lyj-house\skills\lyj-house\SKILL.md" -Destination "skills\lyj-house\SKILL.md" -Force
+```
+
+**Linux / macOS:**
+
+```bash
+cp extensions/lyj-house/skills/lyj-house/SKILL.md skills/lyj-house/SKILL.md
+```
+
+---
+
+## 发布到 Skill 市场（ClawHub）
+
+OpenClaw 的公开 skill 市场是 [ClawHub](https://clawhub.ai)。发布的是 **skill 文件夹**（含 `SKILL.md` 的目录），不是 npm 包。
+
+1. 安装 ClawHub CLI：
+   ```bash
+   npm i -g clawhub
+   ```
+
+2. 登录并发布（以仓库内 bundled 的 skill 目录为例）：
+   ```bash
+   clawhub login
+   clawhub publish ./skills/lyj-house --slug lyj-house --name "乐有家找房" --version 1.0.0 --changelog "首次发布"
+   ```
+
+3. 发布前请确认已按上文把 `extensions/lyj-house/skills/lyj-house/SKILL.md` 同步到 `skills/lyj-house/SKILL.md`。
+
+用户可在 ClawHub 搜索并安装该 skill（会下载到其工作区的 `skills/` 目录）；若他们同时安装本插件，则会由插件注入 API Key 和接口地址。
+
+---
+
+## 发布插件到 npm（可选）
+
+若希望用户通过 `openclaw plugins install @openclaw/lyj-house` 安装完整插件（含配置 schema 与环境变量注入）：
+
+1. 在 `extensions/lyj-house` 目录确认 `package.json` 的 `version`、`name` 等。
+2. 执行：
+   ```bash
+   cd extensions/lyj-house
+   npm publish --access public
+   ```
+3. 若包名为 scope 包（如 `@openclaw/lyj-house`），必须加 `--access public`。
+
+发布后用户可：
+
+- 安装插件：`openclaw plugins install @openclaw/lyj-house`
+- 在配置中填写 `skills.entries.lyj-house.apiKey` 和（可选）`config.apiBase`
+
+文档参考：仓库内 `docs/tools/plugin.md`、`docs/tools/clawhub.md`（或中文版 `docs/zh-CN/tools/plugin.md`、`docs/zh-CN/tools/clawhub.md`）。

package/index.ts

@@ -0,0 +1,39 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+
+const DEFAULT_API_BASE = "https://shenzhen.leyoujia.com";
+
+const plugin = {
+  id: "lyj-house",
+  name: "乐有家找房",
+  description: "通过自然语言描述查找深圳二手房。",
+  configSchema: {
+    type: "object",
+    additionalProperties: false,
+    properties: {
+      apiKey: {
+        type: "string",
+        title: "API Key",
+        description: "在 https://shenzhen.leyoujia.com 申请；也可在 skills.entries.lyj-house.apiKey 中配置。",
+        minLength: 32,
+      },
+      apiBase: {
+        type: "string",
+        title: "接口地址",
+        description: "找房接口的 Base URL，默认为 https://shenzhen.leyoujia.com，测试环境可改为内网地址。",
+      },
+    },
+  },
+  register(api: OpenClawPluginApi) {
+    // 从 skills.entries.lyj-house 读取：apiKey 在顶层，apiBase 在 config 下（符合 openclaw 配置 schema）
+    const root = (api as { config?: { skills?: { entries?: Record<string, { apiKey?: string; config?: { apiBase?: string }; apiBase?: string }> } } })
+      .config;
+    const entry = root?.skills?.entries?.["lyj-house"];
+    const apiKey = entry?.apiKey;
+    const apiBaseRaw = entry?.config?.apiBase ?? entry?.apiBase;
+    const apiBase = (typeof apiBaseRaw === "string" ? apiBaseRaw.replace(/\/$/, "") : "") || DEFAULT_API_BASE;
+    process.env.LYJ_API_KEY = apiKey;
+    process.env.LYJ_API_URL = `${apiBase}/wap/openclaw/ai/house/search`;
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,35 @@
+{
+  "id": "lyj-house",
+  "name": "乐有家找房",
+  "description": "通过自然语言描述查找深圳二手房。",
+  "skills": ["./skills"],
+  "uiHints": {
+    "apiKey": {
+      "label": "API Key",
+      "placeholder": "请输入密钥",
+      "help": "获取方式：访问 https://shenzhen.leyoujia.com ，登录账号，点击导航栏『申请OpenClaw密钥』即可获取。",
+      "secret": true
+    },
+    "apiBase": {
+      "label": "接口地址",
+      "placeholder": "https://shenzhen.leyoujia.com"
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "type": "string",
+        "title": "API Key",
+        "description": "访问 https://shenzhen.leyoujia.com ，登录账号，点击『申请OpenClaw密钥』获取。也可在 skills.entries.lyj-house.apiKey 中配置。",
+        "minLength": 32
+      },
+      "apiBase": {
+        "type": "string",
+        "title": "接口地址",
+        "description": "找房接口的 Base URL，默认为 https://shenzhen.leyoujia.com，测试环境可改为内网地址。"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@jjs-wlkj/lyj-house",
+  "version": "2026.3.12",
+  "description": "乐有家找房插件 — 通过自然语言描述查找深圳房源",
+  "type": "module",
+  "author": "lyj-wljk",
+  "license": "MIT",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "房产",
+    "深圳",
+    "二手房",
+    "乐有家",
+    "找房"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ]
+  }
+}

package/skills/lyj-house/SKILL.md

@@ -0,0 +1,171 @@
+---
+name: 乐有家找房
+description: "乐有家找房：通过自然语言描述查找深圳二手房或租房，返回房源列表与推荐。二手房 type=esf、租房 type=zf。仅支持深圳，city 传「深圳」。需配置 API Key 后使用。"
+homepage: https://www.leyoujia.com
+metadata:
+  {
+    "openclaw":
+      {
+        "skillKey": "lyj-house",
+        "emoji": "🏠",
+        "requires": { "bins": ["curl"], "env": ["LYJ_API_KEY"] },
+        "primaryEnv": "LYJ_API_KEY",
+      },
+  }
+---
+
+# 乐有家找房
+
+通过乐有家开放接口，根据用户描述的条件检索**深圳二手房**或**深圳租房**，返回结构化房源列表并推荐最合适的房源。**仅支持深圳**，请求时 `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
+# 方式一：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}'
+```
+
+```bash
+# 方式二：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`）
+
+```bash
+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：
+
+```bash
+openclaw plugins install @openclaw/lyj-house
+```
+
+安装后在配置项中填入获取的 API Key 即可。
+
+## 注意事项
+
+- 当前仅支持**深圳**，`city` 传 `"深圳"`；二手房 `type=esf`，租房 `type=zf`
+- API Key 限流：每秒最多 3 次请求，超出时请稍后重试
+- 若接口返回 "无效的 API Key"，请引导用户访问 https://shenzhen.leyoujia.com 重新获取