Korean apartment data: official transaction prices, jeonse ratios, AI forecasts. 45,000+ complexes.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
검색에 쓸 수 있는 모든 축과 **단위**, 값의 분포(최소·중위·최대)와 시도별 단지 수를 준다. ★조건 검색 전에 한 번 부르는 것을 권한다 — 단위를 모르고 범위를 넣으면 100배 틀린 조건이 된다 (예: 전세가율은 값 그대로 %, 세대당 대지지분은 10으로 나눠야 ㎡).
field=gu일 때 특정 시도로 좁힌다
이 축의 실제 값 목록을 받는다(sido·gu·dong·brand·builder 등 문자 축)
검색에 쓸 수 있는 모든 축과 **단위**, 값의 분포(최소·중위·최대)와 시도별 단지 수를 준다. ★조건 검색 전에 한 번 부르는 것을 권한다 — 단위를 모르고 범위를 넣으면 100배 틀린 조건이 된다 (예: 전세가율은 값 그대로 %, 세대당 대지지분은 10으로 나눠야 ㎡).
| Argument | Type | Description |
|---|---|---|
| sido | string | field=gu일 때 특정 시도로 좁힌다 |
| field | string | 이 축의 실제 값 목록을 받는다(sido·gu·dong·brand·builder 등 문자 축) |
{
"type": "object",
"properties": {
"sido": {
"type": "string",
"description": "field=gu일 때 특정 시도로 좁힌다"
},
"field": {
"type": "string",
"description": "이 축의 실제 값 목록을 받는다(sido·gu·dong·brand·builder 등 문자 축)"
}
}
}단지 하나의 전 축을 뜻이 통하는 묶음(기본·가격·전세월세·거래·등락·AI예측·입지·건물)으로 준다. search_apartments로 고른 뒤 그 cid로 부른다. 특정 단지를 판단해야 할 때 쓴다.
| Argument | Type | Description |
|---|---|---|
| cid* | string | 단지 식별자. 예: '11290|길음뉴타운1단지(래미안길음1차)|길음동|1279' |
{
"type": "object",
"required": [
"cid"
],
"properties": {
"cid": {
"type": "string",
"description": "단지 식별자. 예: '11290|길음뉴타운1단지(래미안길음1차)|길음동|1279'"
}
}
}주택담보대출의 **현행 규제 수치**를 준다 — LTV·DSR·스트레스 가산금리·규제지역·가격대별 상한. "5억 아파트 사려면 대출 얼마 나오나", "연봉 5천에 현금 1억이면 살 수 있나"에 이 도구를 먼저 부른다. ★★리블은 **계산하지 않는다.** 이 값을 받아서 **네가** 계산하라 — 규제는 자주 바뀌는데 계산기를 우리가 들고 있으면 바뀐 날부터 조용히 틀린 답이 나간다. 우리는 사실과 기준일을 주고, 산수는 네가 하는 편이 정확하다. ★응답의 as_of 이후 개정은 반영돼 있지 않다 — 답할 때 그 날짜를 함께 말할 것. ★how_to_calculate에 순서가 적혀 있다. LTV 한도와 DSR 한도 중 **작은 쪽**이 실제 한도다. ★취득세·중개보수는 이 표에 **없다**(가격·주택수·지역에 따라 갈린다). 모르면 모른다고 하라.
No arguments.
{
"type": "object",
"properties": {}
}한 단지(또는 법정동)의 **개별 거래**를 최신순으로 준다 — 날짜·금액·면적·층까지. 다른 도구는 "최근 1년 102건"처럼 **집계**만 줘서 "가장 최근 거래가 언제 얼마"에 답할 수 없었다. "이 단지 최근 거래", "같은 평형 최근 10건", "직전 거래 대비 얼마나 올랐나"에 이 도구를 쓴다. ★아파트와 유형 **전부** 지원한다(kind 생략 시 아파트). ★전월세는 금액이 **보증금·월세 둘**이다 — price 하나로 뭉치지 말 것. 월세 0이면 순수 전세다. ★해제(취소)된 신고도 그대로 준다(canceled=true). 지우면 취소된 신고가를 확인할 방법이 없어서다 — 시세로 인용할 때는 반드시 빼고 말할 것. ★cid는 search_apartments·search_properties 응답에 들어 있다. 손으로 조립하지 말 것.
| Argument | Type | Description |
|---|---|---|
| cid* | string | 단지 식별자. 검색 응답의 cid를 그대로 쓴다 |
| deal | string | 아파트만 해당. 기본 sale. rent면 전월세 실거래를 준다 |
| kind | string | 기본 apt(아파트). ★_rent는 전월세라 응답 형식이 다르다 |
| limit | number | 1~200, 기본 30 |
| area_m2 | number | 전용면적(㎡)으로 거른다. ±1.5㎡ 안을 같은 평형으로 본다 |
{
"type": "object",
"required": [
"cid"
],
"properties": {
"cid": {
"type": "string",
"description": "단지 식별자. 검색 응답의 cid를 그대로 쓴다"
},
"deal": {
"enum": [
"sale",
"rent"
],
"type": "string",
"description": "아파트만 해당. 기본 sale. rent면 전월세 실거래를 준다"
},
"kind": {
"enum": [
"apt",
"villa",
"officetel",
"detached",
"land",
"commercial",
"presale",
"villa_rent",
"officetel_rent",
"detached_rent"
],
"type": "string",
"description": "기본 apt(아파트). ★_rent는 전월세라 응답 형식이 다르다"
},
"limit": {
"type": "number",
"description": "1~200, 기본 30"
},
"area_m2": {
"type": "number",
"description": "전용면적(㎡)으로 거른다. ±1.5㎡ 안을 같은 평형으로 본다"
}
}
}리블이 발행한 부동산 브리핑 목록(제목·요약·발행일·링크). 정책 보도자료 정리와 실거래 데이터 분석을 거의 매일 낸다. 최근 시장 상황이나 정책 흐름을 물을 때 근거로 쓴다.
| Argument | Type | Description |
|---|---|---|
| limit | number | 1~30, 기본 10 |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "1~30, 기본 10"
}
}
}전국 아파트 45,000여 개를 조건으로 거른다. "강남구 20억 이하 대단지", "전세가율 높은 곳", "AI 1년 예측이 높은 단지"처럼 조건이 있는 질문에 쓴다. 지역·브랜드·시공사는 완전일치이고, 수치 축은 <축>_min·<축>_max로 범위를 준다. 응답에 units(단위 설명)와 total이 함께 온다 — 단위를 지어내지 말고 units를 그대로 읽을 것. 기본 20건이며 total로 전체 규모를 알 수 있다. ★비교·순위·집계처럼 여러 건을 봐야 하는 질문이면 **한 번에 limit=100으로 받아 직접 추려라.** 20건씩 나눠 여러 번 부르는 것보다 그쪽이 훨씬 싸다(호출 비용은 건수와 거의 무관하다). 수천 건을 훑어야 하면 offset으로 넘기지 말고 describe_fields의 분포를 먼저 보고 조건을 좁혀라.
| Argument | Type | Description |
|---|---|---|
| q | string | 단지명 부분 일치 검색어 |
| gu | string | 시군구. 예: 강남구, 수원시 장안구. ★구를 둔 시는 '수원시'처럼 **시 단위로도** 받는다(하위 구 전체가 잡히고 normalized에 그 사실이 온다) |
| dong | string | 읍면동. 예: 대치동 |
| sido | string | 시도. 예: 서울, 경기, 부산. (광주는 전남광주로 정규화된다) |
| sort | string | 정렬 축(수치 축 이름). 예: price, fc12, hh, jr |
| brand | string | 브랜드. 예: 자이, 래미안, 힐스테이트 |
| limit | number | 1~100, 기본 20 |
| order | string | 기본 desc |
| fields | string |
빌라(연립·다세대)·오피스텔·단독다가구·토지·상가/사무실·아파트 분양권의 실거래를 지역별로 준다. "송파구 빌라 시세", "제주 토지 평당가", "강남 상가 얼마"처럼 **아파트가 아닌** 질문에 쓴다. ★아파트는 이 도구가 아니라 search_apartments를 쓸 것 — 둘은 데이터가 완전히 분리돼 있다. ★지역(sido+gu)이 **반드시** 필요하다. 전국 단위 목록은 주지 않는다 — 빌라만 24만 곳이라 한 번에 줄 수 없고, 준다 해도 읽을 수 없다. ★집계 단위가 유형마다 다르다: 빌라·오피스텔·분양권은 **단지**, 단독·토지·상가는 **법정동**이다 (응답의 unit이 알려준다). 단독·토지·상가에서 name은 건물 이름이 아니라 동 이름이다. ★AI 예측(fc)은 없다. 빌라는 단지당 20년에 10건꼴이라 예측이 성립하지 않는다 — 있는 척하지 말고 "실거래 통계"로만 답할 것.
| Argument | Type | Description |
|---|---|---|
| gu* | string | 시군구. 예: 송파구, 제주시 |
| kind* | string | villa=연립다세대 · officetel=오피스텔 · detached=단독다가구 · land=토지 · commercial=상가/사무실/건물 · presale=아파트 분양권 · ★_rent가 붙으면 **전월세**다(villa_rent·officetel_rent·detached_rent) — rep_price 대신 jtot(전세 대표가)·wolse_med(중위 월세)를 본다 · subscription=청약(분양 공고, 실거래 없음) · rental=공공임대(LH·마이홈 공급정보, 실거래 없음) · auction=공매(온비드, 금액은 감정가이며 실거래가 아님) |
| sido | string | 시도. 예: 서울, 제주. (광주는 전남광주로 정규화된다) |
| sort | string | 정렬 축. 기본 n_total(거래 많은 순). ★유형에 없는 축으로 정렬하면 순서가 무의미해진다 — 전월세는 jtot·wolse_med, 공매는 min_low, 청약은 sub_end를 쓴다 |
| limit | number | 1~100, 기본 20 |
{
"type": "object",
"required": [
"kind",
"gu"
],
"properties": {
"gu": {
"type": "string",
"description": "시군구. 예: 송파구, 제주시"
},
"kind": {
"enum": [
"villa",
"officetel",
"detached",
"land",
"commercial",
"presale",
"villa_rent",
"officetel_rent",
"detached_rent",
"subscription",
"rental",
"auction"
],
"type": "string",
"description": "villa=연립다세대 · officetel=오피스텔 · detached=단독다가구 · land=토지 · commercial=상가/사무실/건물 · presale=아파트 분양권 · ★_rent가 붙으면 **전월세**다(villa_rent·officetel_rent·detached_rent) — rep_price 대신 jtot(전세 대표가)·wolse_med(중위 월세)를 본다 · subscription=청약(분양 공고, 실거래 없음) · rental=공공임대(LH·마이홈 공급정보, 실거래 없음) · auction=공매(온비드, 금액은 감정가이며 실거래가 아님)"
},
"sido": {
"type": "string",
"description": "시도. 예: 서울, 제주. (광주는 전남광주로 정규화된다)"
},
"sort": {
"enum": [
"n_total",
"ppm",
"rep_price",
"jtot",
"wolse_med",
"min_low",
"sub_end"
],
"type": "string",
"description": "정렬 축. 기본 n_total(거래 많은 순). ★유형에 없는 축으로 정렬하면 순서가 무의미해진다 — 전월세는 jtot·wolse_med, 공매는 min_low, 청약은 sub_end를 쓴다"
},
"limit": {
"type": "number",
"description": "1~100, 기본 20"
}
}
}| 쉼표로 구분한 축 목록, 또는 'all'. 기본은 14축(토큰 절약) |
| hh_min | number | 세대수 하한 |
| jr_min | number | 전세가율 하한(%). 값 그대로 — 60이면 60% |
| offset | number | 건너뛸 건수(페이지네이션) |
| status | string | 단지 상태로 좁힌다. existing=기존 단지 · upcoming=분양 예정(price가 분양가) · unranked=무순위 청약. ★예측(fc*)으로 정렬·필터하면 자동으로 existing만 남는다 — 분양 예정을 보려면 여기서 명시할 것 |
| age_max | number | 준공 후 경과 연수 상한 |
| builder | string | 시공사. 예: 현대건설 |
| fc12_min | number | 리블 AI 1년 예측 하한(%). 값 그대로 |
| price_max | number | 매매 대표가 상한(만원) |
| price_min | number | 매매 대표가 하한(만원) |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "단지명 부분 일치 검색어"
},
"gu": {
"type": "string",
"description": "시군구. 예: 강남구, 수원시 장안구. ★구를 둔 시는 '수원시'처럼 **시 단위로도** 받는다(하위 구 전체가 잡히고 normalized에 그 사실이 온다)"
},
"dong": {
"type": "string",
"description": "읍면동. 예: 대치동"
},
"sido": {
"type": "string",
"description": "시도. 예: 서울, 경기, 부산. (광주는 전남광주로 정규화된다)"
},
"sort": {
"type": "string",
"description": "정렬 축(수치 축 이름). 예: price, fc12, hh, jr"
},
"brand": {
"type": "string",
"description": "브랜드. 예: 자이, 래미안, 힐스테이트"
},
"limit": {
"type": "number",
"description": "1~100, 기본 20"
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "기본 desc"
},
"fields": {
"type": "string",
"description": "쉼표로 구분한 축 목록, 또는 'all'. 기본은 14축(토큰 절약)"
},
"hh_min": {
"type": "number",
"description": "세대수 하한"
},
"jr_min": {
"type": "number",
"description": "전세가율 하한(%). 값 그대로 — 60이면 60%"
},
"offset": {
"type": "number",
"description": "건너뛸 건수(페이지네이션)"
},
"status": {
"enum": [
"existing",
"upcoming",
"unranked"
],
"type": "string",
"description": "단지 상태로 좁힌다. existing=기존 단지 · upcoming=분양 예정(price가 분양가) · unranked=무순위 청약. ★예측(fc*)으로 정렬·필터하면 자동으로 existing만 남는다 — 분양 예정을 보려면 여기서 명시할 것"
},
"age_max": {
"type": "number",
"description": "준공 후 경과 연수 상한"
},
"builder": {
"type": "string",
"description": "시공사. 예: 현대건설"
},
"fc12_min": {
"type": "number",
"description": "리블 AI 1년 예측 하한(%). 값 그대로"
},
"price_max": {
"type": "number",
"description": "매매 대표가 상한(만원)"
},
"price_min": {
"type": "number",
"description": "매매 대표가 하한(만원)"
}
}
}