Korean Real Estate Transactions
Korean apartment and housing sale/rent records (MOLIT) by natural-language address. No key.
我该使用它吗
质量与安全性
发现（3）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 get_korean_real_estate_transactions 中
- LOWTool 'get_korean_real_estate_transactions' name length outside 3-30 range在 get_korean_real_estate_transactions 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"korean-real-estate-mcp": {
"url": "https://realestate-api.goyostudio.io/mcp"
}
}
}远程端点
https://realestate-api.goyostudio.io/mcpstreamable-http它能做什么
工具清单
工具（1）
🟢get_korean_real_estate_transactions(q, type, tradeType, rentSubtype, startDate, ...)
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.
输入模式
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Natural-language Korean address and/or complex name. Max ~30 Korean characters (90 UTF-8 bytes), max 8 whitespace-separated tokens. Do not include period words ('최근 3개월' is ignored — use startDate/endDate)."
},
"type": {
"type": "string",
"enum": [
"apartment",
"officetel",
"rowhouse",
"detached",
"presale",
"land",
"commercial",
"industrial"
],
"description": "Property type. Default apartment unless inferred from q. rent is available only for apartment/officetel/rowhouse/detached; presale/land/commercial/industrial are sale-only."
},
"tradeType": {
"type": "string",
"enum": [
"sale",
"rent"
],
"description": "sale = 매매 (default), rent = 전월세 (jeonse + wolse combined unless rentSubtype filters)."
},
"rentSubtype": {
"type": "string",
"enum": [
"jeonse",
"wolse"
],
"description": "Only with tradeType=rent. jeonse (전세) = deposit-only; wolse (월세) = has monthly rent."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "YYYY-MM inclusive. Default: 11 months before endDate (12-month window). Max range 24 months."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
"description": "YYYY-MM inclusive. Default: current month."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"description": "Max transaction rows returned (default 100). Statistics always cover the full matching set regardless of limit."
},
"areaMin": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Minimum EXCLUSIVE area (전용면적) in ㎡, inclusive. Not supply area (공급면적). A '84 type' apartment is usually 84.0-85.9㎡, so pin it with areaMin=84 & areaMax=86."
},
"areaMax": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Maximum EXCLUSIVE area (전용면적) in ㎡, inclusive."
},
"groupBy": {
"type": "string",
"enum": [
"month"
],
"description": "Set to 'month' for stats_by_month[] — per-month aggregates over the full matching set. Required for trend/추이 questions: the transaction rows are capped at limit, so a trend cannot be rebuilt from them."
}
},
"required": [
"q"
]
}社区
证据