xiaolu-house CLI
fanggeek/xiaolu-house
CLI para busca imobiliária integrada com IA no terminal
Ver no GitHubFerramenta de linha de comando para consultar imóveis no Xiaolu Xuanfang (plataforma chinesa de busca imobiliária). Integra-se com APIs e permite que agentes de IA e usuários humanos façam buscas, filtrem por critérios complexos e acessem dados de vendas, aluguéis e comunidades diretamente do terminal.
Instalação
npx convez-ai fanggeek/xiaolu-house1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes de IA consultarem dados imobiliários em tempo real durante análises
- Automação de buscas de imóveis com múltiplos filtros via CLI
- Integração com workflows de chatbot para responder consultas sobre imóveis
Veredito

Skill bem estruturada para integração imobiliária específica do mercado chinês. A abordagem CLI é funcional para agentes, mas o escopo geográfico restrito limita sua aplicabilidade geral—ideal para projetos com foco em Xiaolu ou mercado imobiliário asiático.
README
A tradução para o português deste README ainda está na fila.
xiaolu-house
小鹿选房命令行工具 — 让人类和 AI Agent 都能在终端中操作小鹿选房。
CLI
安装
npx -y xiaolu-house
配置
# 查看当前支持的城市列表
npx -y xiaolu-house cities
# 设置 API Key(访问 https://www.xiaoluxuanfang.com/claw 根据页面内容操作)
npx -y xiaolu-house config --set-api-key <your-api-key>
# 设置默认城市
npx -y xiaolu-house config --set-city <your-city>
# 查看当前配置及用户信息
npx -y xiaolu-house config --show
配置文件:~/.xiaolu-house/config
命令列表
config — 配置管理
xiaolu-house config --show # 查看当前配置及用户信息
xiaolu-house config --set-api-key <key> # 设置 API Key
xiaolu-house config --set-city <your-city> # 设置默认城市
xiaolu-house config --clear # 清除所有配置
cities — 查看当前支持的城市列表
xiaolu-house cities
areas — 查看当前城市的区域 areaId 映射表
xiaolu-house areas
需先通过
config --set-city设置默认城市。输出可用于--area-id/--area-ids参数。
houses — 查询二手房/租房房源列表
xiaolu-house houses
| 参数 | 说明 | 必填 | 默认值 |
|---|---|---|---|
--type | 需求类型:sell=售、rent=租 | 是 | sell |
--name | 小区或学校或地铁站的名称,如澳城花园、百花小学、翻身站 | 否 | — |
--reason | 调用这个命令的理由 | 是 | — |
--rooms | 室数:1=1室、2=2室、3=3室、4=4室、5=4室以上,多个逗号分隔,如2,3 | 否 | — |
--toilets | 卫数:1=1卫、2=2卫、3=3卫、4=4卫、5=4卫以上,多个逗号分隔,如1,2 | 否 | — |
--min-sell-price | 最低售价(总价万元) | 否 | — |
--max-sell-price | 最高售价(总价万元) | 否 | — |
--min-rent-price | 最低月租(元) | 否 | — |
--max-rent-price | 最高月租(元) | 否 | — |
--min-area | 最小面积(㎡) | 否 | — |
--max-area | 最大面积(㎡) | 否 | — |
--elevator | 电梯情况:1=无电梯、2=有电梯、3=电梯入户 | 否 | — |
--direction | 朝向:东、南、西、北、东南、东北、西南、西北 | 否 | — |
--area-ids | 区域 ID 数组,逗号分隔,如: 440305|前海,440306|翻身 | 否 | — |
communities — 查询小区列表
xiaolu-house communities
| 参数 | 说明 | 必填 |
|---|---|---|
--name | 小区名称,如澳城花园 | 否 |
--reason | 调用这个命令的理由 | 是 |
--area-id | 区域ID,如: 440305|前海 | 否 |
deals — 查询二手房成交列表
xiaolu-house deals
| 参数 | 说明 | 必填 |
|---|---|---|
--name | 小区或学校的名称,如澳城花园、百花小学 | 否 |
--reason | 调用这个命令的理由 | 是 |
--area-id | 区域ID,如: 440305|前海 | 否 |
schools — 查询学校列表
xiaolu-house schools
| 参数 | 说明 | 必填 |
|---|---|---|
--name | 学校名称,如百花小学 | 否 |
--reason | 调用这个命令的理由 | 是 |
--type | 学校类型:pri=小学、mid=中学 | 否 |
--nature | 学校性质:1=公办、2=私立 | 否 |
--tiers | 梯队:1=第一梯队、2=第二梯队、3=第三梯队、4=第四梯队、999=无梯队,多个逗号分隔,如1,2 | 否 |
--area-ids | 区域 ID 数组,逗号分隔,如: 440305|前海,440306|翻身 | 否 |
new-communities — 查询新房列表
xiaolu-house new-communities
| 参数 | 说明 | 必填 |
|---|---|---|
--name | 新房名称,如开云府 | 否 |
--reason | 调用这个命令的理由 | 是 |
--rooms | 室数:1=1室、2=2室、3=3室、4=4室、5=4室以上,多个逗号分隔,如2,3 | 否 |
--property-types | 物业类型:1=住宅、2=商铺、3=写字楼 | 否 |
--sell-status | 销售状态:hot=热门、onsell=在售、wait=待售 | 否 |
--min-price | 最低价格(万元) | 否 |
--max-price | 最高价格(万元) | 否 |
--price-type | 价格类型:totalPrice=总价、averagePrice=均价 | 否 |
--decoration | 装修类型:1=精装、2=简装、3=毛坯 | 否 |
--min-construction-area | 最小建筑面积(㎡) | 否 |
--max-construction-area | 最大建筑面积(㎡) | 否 |
--area-id | 区域ID,如: 440306|翻身 | 否 |
SKILL 仓库
已上架
待上架
开发命令
| 命令 | 作用 |
|---|---|
npm start | 运行源码入口 src/index.js,用于本地调试 CLI。 |
npm test | 执行 tests/*.test.js 下的 Node.js 测试。 |
npm run build | 执行构建脚本,生成发布用的 dist/xiaolu-house 和 dist/xiaolu-house.cjs。 |
npm run skill | 根据 scripts/generate-skill/city-meta.json 和模板重新生成主 SKILL 与城市 SKILL。 |
npm run release | 执行发布脚本,升级版本并推送 commit/tag。 |
npm run prepublishOnly | npm 发布前自动执行构建,通常不需要手动调用。 |
发布流程
通过 GitHub Actions 自动发布。发布脚本会创建版本 commit 和 tag,push tag 后触发构建并发布到 npm。
发布前检查
# 如果改过 SKILL 模板或城市元数据,先重新生成 SKILL 并提交生成结果
npm run skill
# 发布前验证
npm test
npm run build
发布前 Git 工作区必须干净,否则 npm run release 会报错退出。若 npm run skill 生成了 skills/ 变更,需要先提交后再发布。
执行发布
npm run release # patch 版本 (1.0.0 -> 1.0.1)
npm run release -- minor # minor 版本 (1.0.0 -> 1.1.0)
npm run release -- major # major 版本 (1.0.0 -> 2.0.0)
发布脚本执行流程:
- 检查 Git 工作区是否干净
npm version升级版本号并创建 commit + tag- 推送 commit 和 tag 到 GitHub
- GitHub Actions 执行
npm ci、npm run build、npm publish --provenance --access public
License
MIT