Korea Real Estate Data (실거래가·단지·청약)

io.github.hoftlab由 GitHub 账号 hoftlab 发布v0.2.0更新于 Oct 25, 2026

Korean apartment transactions, complex profiles and housing subscription data by region/complex name

已验证Streamable HTTP可网页运行金融数据与分析

概览

AI 生成的概览

一个远程 MCP 服务器,让助手查询韩国公寓实际成交价、小区档案、租赁数据和住房认购(청약)公告。

可以做什么
把韩国地区名称转换为法定洞代码,并按地区和小区名关键词查找公寓小区,附相似度分数以便在付费调用前确认准确小区。按小区和期间获取公寓买卖实际成交与全租/月租成交列表,金额以万韩元计并含每坪价格。按面积类型汇总买卖与租赁价格,包括件数、最低/最高/平均/中位、近期成交、月度走势和全租价格比。获取 K-apt 小区档案(户数、使用批准日、施工单位、供暖、停车、交通、设施)以及整合档案、买卖与租赁摘要和市郡区市场背景的一站式报告。查看市郡区市场快照(月度成交量、中位价、每坪价、热门小区排行)、预售权/入住权转卖成交,以及认购公告搜索和单个公告的竞争率与分양价详情。
适用场景
适合需要韩国住房市场事实的场景:查询特定公寓小区近期买卖或租赁价格、比较两到五个小区、了解某市郡区的市场情况,或查找认购公告及其竞争率。
运行要求
远程 streamable HTTP 端点;未声明任何软件包、账户、API 密钥或请求头。服务器自带的目录工具会说明每次调用价格和支付方式(x402、USDC)。
安装前请注意
多数数据工具标注为通常按次收费(当前为免费模式),价格和支付条款可能变化,使用前请先查看目录工具。工具返回公开的成交与认购数据(含公告链接),且服务器为第三方,数据应与官方来源核对。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Korea Real Estate Data (실거래가·단지·청약),将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.hoftlab%2Fkr-realestate-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "korea-real-estate-data": {
      "type": "http",
      "url": "https://kr-realestate-mcp.gamto.workers.dev/mcp"
    }
  }
}

工具

14

kr_pricing

요금·데이터 출처 안내

[무료] 이 서버의 도구 목록·건당 가격·결제 방식(x402, USDC)·데이터 출처와 갱신 주기·면책을 반환한다. Returns tool catalog, per-call prices and data sources.

无需输入参数。

kr_region_lookup

지역명 → 법정동코드

[무료] 지역명('분당', '서울 강남구', '역삼동', '수원')을 실거래가 API용 법정동코드 5자리(lawdCd)로 변환한다. 구가 있는 시는 구 코드 목록(lawdCds)으로 펼친다. Map a Korean region name to the 5-digit legal district code.

输入参数limitquery必填

kr_apt_trades

단지 매매 실거래 목록

[평소 $0.01/호출 — 현재 무료 모드] 단지명과 기간으로 아파트 매매 실거래 목록을 돌려준다(지역코드 변환·단지명 유사도 매칭·다개월 결합·금액/면적 정규화 포함). 금액 단위 만원, 평당가 포함. Apartment sale transactions for a complex over a period.

输入参数tofromlimitmonthsregion必填aptName必填areaMaxareaMinpropertyTypeincludeCancelled

kr_apt_price_summary

단지 매매 시세 요약

[평소 $0.02/호출 — 현재 무료 모드] 단지의 매매 실거래를 면적타입별로 집계한다: 건수·최저/최고/평균/중위·최근 거래·최고가·평당가·기간 전후반 변화율, 월별 추이. Price summary by area type for a complex.

输入参数tofrommonthsregion必填aptName必填areaMaxareaMinpropertyType

kr_apt_rents

단지 전월세 실거래 목록

[평소 $0.01/호출 — 현재 무료 모드] 단지명과 기간으로 아파트 전월세 실거래 목록을 돌려준다(전세/월세 구분, 보증금·월세 만원, 신규/갱신, 갱신요구권, 종전 계약 조건). Jeonse/monthly-rent transactions for a complex.

输入参数tofromlimitmonthsregion必填aptName必填areaMaxareaMinrentTypepropertyType

kr_apt_rent_summary

단지 전월세 요약 + 전세가율

[평소 $0.02/호출 — 현재 무료 모드] 단지의 전월세 실거래를 면적타입별로 집계하고(전세 중위 보증금, 월세 보증금/월세 중위, 갱신 비중) 같은 기간 매매 중위가 대비 전세가율(%)을 계산한다. Rent summary with jeonse-to-price ratio.

输入参数tofrommonthsregion必填aptName必填areaMaxareaMinpropertyType

kr_apt_profile

단지 기본정보

[평소 $0.01/호출 — 현재 무료 모드] 단지 기본정보: 세대수·동수·사용승인일·시공사·분양/임대·난방·복도형식·관리방식·면적 구성·주차·승강기·CCTV·지하철역/도보·버스·교육/편의/복지시설. kaptCode를 알면 region/aptName 대신 직접 지정. Complex profile from K-apt.

输入参数regionaptNamekaptCode

kr_apt_report

단지 종합 리포트

[평소 $0.05/호출 — 현재 무료 모드] 단지 종합 리포트 한 번에: 기본정보(K-apt) + 최근 N개월(기본 12) 매매 요약 + 전월세 요약 + 전세가율 + 최근 거래 10건 + 같은 시군구 시장 맥락(월별 거래량·평당가). 여러 공공 API를 결합한 상위 도구. All-in-one complex report.

输入参数monthsregion必填aptName必填

kr_region_market

시군구 시장 스냅샷

[평소 $0.03/호출 — 현재 무료 모드] 시군구 단위 매매 시장 스냅샷: 월별 거래량·해제 건수·직거래 비중·중위가·평당가, 법정동별 집계, 면적대 분포, 거래 많은 단지 Top N, 평당가 높은 단지 Top N. Market snapshot for a district.

输入参数topNmonthsregion必填

kr_presale_trades

분양권·입주권 전매 실거래

[평소 $0.02/호출 — 현재 무료 모드] 아파트 분양권·입주권 전매 실거래. 단지명을 주면 그 단지, 생략하면 시군구 전체(단지별 집계). 권리구분(분양권/입주권)·면적타입별 건수·중위가·평당가와 거래 목록. Presale/occupancy-right resale transactions.

输入参数tofromlimitmonthsregion必填aptNameareaMaxareaMinincludeCancelled

kr_apt_compare

단지 비교

[평소 $0.03/호출 — 현재 무료 모드] 2~5개 단지를 같은 기간으로 나란히 비교한다: 세대수·사용승인·면적타입별 매매 건수/중위가/평당가·전세 중위 보증금·전세가율, 그리고 두 단지 이상에 공통인 면적타입 교차표. 다른 시군구 단지끼리도 가능. Compare 2-5 complexes side by side.

输入参数items必填monthsareaMaxareaMinpropertyType

kr_subscription_competition

청약 경쟁률 상세

[평소 $0.02/호출 — 현재 무료 모드] 청약 공고 1건의 상세: 주택형별 공급세대·분양가(최고가, 만원)·순위/거주지역별 접수건수와 경쟁률·특별공급 신청현황·당첨가점(최저/최고/평균). houseManageNo를 모르면 name으로 검색해 단일 공고일 때만 진행. Competition rates and prices for one subscription notice.

输入参数nameregionpblancNohouseManageNo

版本历史

1
  1. v0.2.0最新Oct 14, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。