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 分