用途:基于韩国国土交通部(MOLIT)实价申报数据查询买卖与全月租实价,用于商业投资分析、选址审查与资产估值。本技能是 tae0y/real-estate-mcp(MIT)经 NomaDamas k-skill-proxy 简化的指南。
适用与不适用:适用于实价/全月租查询、按小区行情走势、按面积价格分布、按地区行情比较;不适用于海外房产、挂牌报价比较(非实价)、税务登记中介法律咨询、청약홈 申购中签查询。
输入:q 地区名(用于 region-code);lawd_cd 5位法定洞代码(如 "11680");deal_ymd 6位交易年月 YYYYMM(如 "202403");num_of_rows 查询条数(默认100,最大1000)。
前提:用户侧无需密钥,联网即可。KSKILL_PROXY_BASE_URL 可选,留空则用托管 https://k-skill-proxy.nomadamas.org;DATA_GO_KR_API_KEY 仅置于代理服务器。
端点:地区代码 GET /v1/real-estate/region-code?q={地区名};实价 GET /v1/real-estate/:assetType/:dealType?lawd_cd={代码}&deal_ymd={年月}。assetType 支持 apartment、officetel、villa、single-house、commercial;dealType 支持 trade、rent(commercial/rent 不支持)。
示例:curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/region-code' --data-urlencode 'q=강남구';将路径替换为 /v1/real-estate/apartment/trade 或 /v1/real-estate/officetel/rent 并传 lawd_cd=11680、deal_ymd=202403。
响应:买卖返回 items(名称、区、面积、楼层、价格、交易日期、建成年、交易类型)与 summary(中位/最小/最大价格、样本数);全月租结构相同,另有保证金、月租、合同类型。价格单位为万韩元。
失败模式:lawd_cd 或 deal_ymd 格式错误返回 400;代理缺 DATA_GO_KR_API_KEY 返回 503;上游 MOLIT 错误返回 502 + molit_api_XXX;无数据返回空 items。
回答规则:先用 region-code 确认行政区代码再按资产类型查询;信息不足先补地区、小区名、基准月;不混谈实价与挂牌报价;末尾注明来源(国土交通部实价申报)。