Agent Skills
返回列表
巴娜房产

巴娜房产

行业专业 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请访问 https://skillhub.cn/install/skillhub.md，按照指南将 @user_6eb4c6c0/bana-realestate 安装到你的 AI 助手。

技能介绍

解决的数据获取痛点

在房产数据分析或助手开发中，直接对接 58 安居客等底层房产 API 往往面临参数繁琐、城市编码不统一以及凭证管理混乱的问题。开发者经常需要在多套接口文档中反复横跳，且难以控制查询成本与并发限制。

核心能力与执行流程

该技能通过封装 scripts/realestate_api.py 客户端，将复杂的安居客数据查询标准化。它内置了 12 种 method，覆盖小区、二手房、租房和新房的检索。执行时，Agent 会优先通过免费的 getCities 校验城市短码（如 gz、bj），随后选择最匹配的检索维度。对于收费接口（单次 0.4 元），技能会在调用前明确告知费用并直接执行，无需用户二次确认。凭证管理方面，支持在对话中直接传递 AppID 和 SecureKey 并默认持久化，省去了繁琐的环境变量配置。

边界与注意事项

使用此技能时需注意几个工程边界。首先，服务端为单线程处理，客户端默认等待 180 秒，严禁并发请求或因超时盲猜重试。其次，district 和 bizcircle 参数必须使用安居客 URL 中的拼音编码，若仅有中文名需先确认编码，避免误触收费接口。此外，针对 402（余额不足）和 500（计费异常）等错误，技能会停止重试以防止无效扣费。最后，输出结果仅基于接口返回的客观数据，缺失字段不会被推断为事实。

使用场景

  • 需要获取北京特定行政区的二手房房源列表，并提取关键信息。
  • 输入关键词搜索广州的租房信息，快速定位符合预算的小区房源。
  • 查询全国支持的城市列表及其短码，为后续批量数据抓取做准备。
  • 根据用户提供的商圈名称，筛选上海该商圈内的所有二手房数据。

适合人员

  • 房产中介数据分析师，需要定期抓取安居客房源数据以进行市场分析。
  • 独立开发者，希望集成可靠的房产数据查询接口来构建自己的租房助手。
  • 房产内容创作者，需要快速查询特定小区的二手房价格作为写作素材。
  • 量化研究员，需要获取结构化的城市房产基础数据用于构建量化模型。