核心用法
molit-real-estate 是韩国国土交通部(MOLIT)公开数据的API封装技能,主要提供以下功能:
1. 区域交易查询:通过5位行政区划代码(如강남구 11680)查询指定月份公寓买卖实价数据
2. 价格分析:自动计算평당가격(每坪价格,1坪≈3.3058㎡),支持同比分析
3. 多区域对比:可对比多个行政区价格水平(如강남vs서초)
4. 法律联动:通过~~law连接器关联《住宅租赁保护法》《不动产交易申报法》等法规
使用流程
用户输入自然语言(如"강남 아파트 실거래가")→ 识别区域代码 → 调用real_estate.sh脚本 → 解析XML数据 → 输出结构化Markdown报告。
显著优点
- 官方数据源:直接对接data.go.kr(韩国政府公开数据门户),数据权威性极高
- 实时性强:交易发生后1-2个月内即可查询,远快于传统公示渠道
- 标准化输出:自动统一面积单位、格式化价格、生成对比表格
- 生态整合:预留
~~realestate/~~law/~~search/~~notify四向连接器,可扩展至法务咨询、市场趋势、价格预警等场景
潜在缺点与局限性
| 限制项 | 说明 |
|--------|------|
| 地域范围 | 仅覆盖韩国境内,首尔主要区域代码硬编码,其他地区需手动查询 |
| 数据粒度 | 仅公寓(아파트),不包含연립/다세대/단독주택等类型 |
| 时滞性 | 1-2个月延迟,无法反映即时市场价格 |
| 认证门槛 | 需注册data.go.kr并申请API密钥(虽为自动审批) |
| 货币单位 | 仅支持韩元(만원),无自动汇率转换 |
适合人群
- 购房者:核实意向区域真实成交价,避免中介信息差
- 房产投资者:追踪价格趋势,进行区域比较分析
- 法律顾问:结合交易数据处理租赁/买卖纠纷
- 数据分析师:获取结构化房产交易数据集
常规风险
1. 数据解读风险:"实价"为申报价格,可能与实际成交价存在差异(阴阳合同)
2. 时效性误判:1-2个月延迟在波动市场中可能导致决策偏差
3. API稳定性:政府公开API偶有服务中断或限速
4. 法律适用边界:连接器提供的法律检索为参考性质,不构成正式法律意见
5. 隐私合规:交易数据虽为公开信息,但批量爬取需遵守data.go.kr利用条款