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 domainget_korean_real_estate_transactions에서
- LOWTool 'get_korean_real_estate_transactions' name length outside 3-30 rangeget_korean_real_estate_transactions에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
]
}커뮤니티
증거