Korean Real Estate Transactions

io.github.goyo-studio由 GitHub 帳號 goyo-studio 發布v1.0.0更新於 Oct 31, 2026

Korean apartment and housing sale/rent records (MOLIT) by natural-language address. No key.

已驗證Streamable HTTP可網頁執行位置與生活金融

概覽

AI 產生的概覽

遠端 MCP 伺服器，可用自然語言韓文地址或公寓社區名稱查詢韓國國土交通部官方房產買賣與租賃成交紀錄。

可以做什麼
  • 用自然語言韓文地址或公寓社區名稱查詢韓國房產成交紀錄
  • 取得買賣、全租與月租紀錄及期間統計（韓元平均、最低、最高價，或押金與月租）
  • 依月份分組查看走勢，並依專用面積篩選
  • 地區不明確時以回傳的候選名稱重新查詢，並在結果中查看推論說明與缺漏月份
適用情境
適合助手需要查詢韓國特定社區或街區的公寓成交價、租金水準或每月價格走勢，又不想申請 API 金鑰時使用。
執行需求
一個遠端 Streamable HTTP 端點，不需驗證、API 金鑰或環境變數。無法新增遠端連接器的用戶端可透過 mcp-remote 這個 npm 套件接入，需要 Node.js。查詢文字應為韓文。
安裝前請注意
限速為每個 IP 每 10 秒 50 次請求，超過會回傳 HTTP 429 與 Retry-After。目前免費，但日後可能導入按次小額計費。資料來自 data.go.kr 的國土交通部公開資料，可能因申報更正或解除而變動；依現狀提供，與政府無關，也不構成投資、法律或稅務建議。伺服器由第三方營運，原始碼未公開。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Korean Real Estate Transactions，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.goyo-studio%2Fkorean-real-estate-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "korean-real-estate-transactions": {
      "type": "http",
      "url": "https://realestate-api.goyostudio.io/mcp"
    }
  }
}

README

Korean Real Estate Transactions MCP

[Korean Real Estate Transactions MCP on Glama]

한국어 · English

Remote MCP server: https://realestate-api.goyostudio.io/mcp (Streamable HTTP, no authentication)

This repository holds documentation and registry metadata only. The server is operated by goyostudio; its source code is not published here.

한국어

무엇을 하나요

한국 주소나 아파트 단지명을 자연어로 물으면 국토교통부 실거래가 공개 데이터(data.go.kr)를 돌려주는 원격 MCP 서버입니다. 매매·전세·월세, 기간 통계(평균·최저·최고), 월별 추이, 전용면적 조건을 지원합니다. API 키가 필요 없습니다.

엔드포인트

항목값
URLhttps://realestate-api.goyostudio.io/mcp
전송Streamable HTTP (무상태, POST만. GET은 405)
인증없음
도구get_korean_real_estate_transactions (1개)

예시 질문

  • "강남구 대치동 은마 아파트 매매"
  • "마포구 아파트 전세 월별 추이" → groupBy: "month"
  • "송파구 헬리오시티 전용 84" → areaMin: 84, areaMax: 86

도구 호출 예:

json
{  "name": "get_korean_real_estate_transactions",  "arguments": { "q": "강남구 대치동 은마 아파트 매매", "limit": 5 }}

지역이 모호하면 HTTP 422와 candidates[]가 오고, 그 후보로 다시 호출합니다. 추론한 내용은 resolved_note에, 빠진 달은 missing_months에 표시됩니다. 자세한 내용은 docs/usage.md.

클라이언트 설정

Cursor (~/.cursor/mcp.json 또는 프로젝트의 .cursor/mcp.json):

json
{  "mcpServers": {    "korean-real-estate": {      "url": "https://realestate-api.goyostudio.io/mcp"    }  }}

Claude Desktop: 설정 → 커넥터 → 사용자 지정 커넥터 추가에서 URL https://realestate-api.goyostudio.io/mcp 입력. 원격 커넥터를 쓸 수 없는 환경에서는 claude_desktop_config.json에 mcp-remote를 씁니다:

json
{  "mcpServers": {    "korean-real-estate": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://realestate-api.goyostudio.io/mcp"]    }  }}

Claude Code: claude mcp add --transport http korean-real-estate https://realestate-api.goyostudio.io/mcp

이용 제한

IP당 50요청 / 10초. 초과하면 HTTP 429와 Retry-After 헤더가 옵니다. 그 초만큼 기다린 뒤 다시 시도하세요. 현재 무료이며, 추후 x402 프로토콜 기반 소액 과금이 도입될 수 있습니다(현재 상태: /openapi.json의 x-pricing).

출처와 면책

  • 출처: 국토교통부 실거래가 공개시스템, data.go.kr OpenAPI. 모든 응답에 source 필드가 있습니다.
  • 정부 공식 서비스가 아니며 국토교통부와 관계가 없습니다.
  • 무보증(AS-IS). 신고 정정·해제로 수치가 바뀔 수 있습니다. 투자·법률·세무 자문이 아닙니다.
  • 약관: https://realestate-api.goyostudio.io/terms

English

What it does

A remote MCP server that answers natural-language questions about Korean addresses or apartment complexes with official real-estate transaction records from the Ministry of Land, Infrastructure and Transport (MOLIT, via data.go.kr). It covers sales, jeonse and monthly rent, period statistics (avg/min/max), monthly trends, and exclusive-area filters. No API key.

Endpoint

ItemValue
URLhttps://realestate-api.goyostudio.io/mcp
TransportStreamable HTTP (stateless, POST only; GET returns 405)
AuthNone
Toolget_korean_real_estate_transactions (one tool)

Example

json
{  "name": "get_korean_real_estate_transactions",  "arguments": { "q": "강남구 대치동 은마 아파트 매매", "limit": 5 }}

The query q is Korean. Ambiguous locations return HTTP 422 with candidates[]; call again with one of them. Inferences are disclosed in resolved_note, coverage gaps in missing_months. See docs/usage.md.

Client configuration

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

json
{  "mcpServers": {    "korean-real-estate": {      "url": "https://realestate-api.goyostudio.io/mcp"    }  }}

Claude Desktop: Settings → Connectors → Add custom connector, URL https://realestate-api.goyostudio.io/mcp. Where remote connectors are not available, use mcp-remote in claude_desktop_config.json:

json
{  "mcpServers": {    "korean-real-estate": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://realestate-api.goyostudio.io/mcp"]    }  }}

Claude Code: claude mcp add --transport http korean-real-estate https://realestate-api.goyostudio.io/mcp

Rate limit

50 requests / 10 seconds per IP. Over the limit you get HTTP 429 with a Retry-After header; wait that many seconds and retry. Currently free. Per-request micro-pricing via the x402 protocol may be introduced later (status: x-pricing in /openapi.json).

Data source and disclaimer

  • Source: 국토교통부 실거래가 공개시스템 (MOLIT) via the data.go.kr OpenAPI. Every response carries a source field.
  • Not affiliated with, operated by, or endorsed by MOLIT or any government body.
  • Provided AS IS, without warranty. Official reports may be corrected or cancelled after publication. Not investment, legal, or tax advice.
  • Terms: https://realestate-api.goyostudio.io/terms

License

Documentation in this repository: MIT. The data returned by the service is subject to the terms and the original data.go.kr terms.

來源：README.md，提交 c9c915f

工具

1

get_korean_real_estate_transactions

Query official Korean real-estate transaction records (국토교통부 실거래가, MOLIT via data.go.kr) with a natural-language Korean address or apartment-complex name, e.g. '강남구 대치동 은마 아파트 매매'. Returns flat JSON: period statistics (avg/min/max price in KRW, or deposit/monthly-rent stats for rentals) plus individual transactions, newest first. For trend questions ('월별 추이', 'how did prices move'), pass groupBy=month to get stats_by_month[]; for a size condition ('전용 84', '국평'), pass an areaMin/areaMax band — both aggregate over the full matching set, unlike the row list which is capped at limit. Hint words inside q (아파트/오피스텔…, 매매/전세/월세) are auto-inferred as type/tradeType/rentSubtype; explicit fields always win. Ambiguous locations return HTTP 422 with candidates[] — pick one and retry. Unresolvable locations return 404. All inferences are disclosed in resolved_note; coverage gaps in missing_months. Terms (as-is, no warranty): https://realestate-api.goyostudio.io/terms — data may be corrected or cancelled after initial publication; not investment advice. PRICING: currently free within edge or app rate limits (50 requests / 10 seconds per IP). HTTP 429 with error RATE_LIMITED and a Retry-After header — wait that many seconds, then retry. x402-ready: a fixed micro-price per request (indicative $0.001–$0.01, USDC on Base) may be enabled later, after which unpaid requests receive HTTP 402 Payment Required per the x402 protocol (https://x402.org); agents with x402 support handle this automatically. Current pricing status: GET https://realestate-api.goyostudio.io/openapi.json → x-pricing.

輸入參數q必填typelimitareaMaxareaMinendDategroupBystartDatetradeTyperentSubtype

版本歷史

1
  1. v1.0.0最新Oct 24, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分