data-realestate

한국 부동산 실거래가 조회

국토교통부(MOLIT) 실거래가 신고 데이터를 기반으로 매매·전월세 실거래를 조회합니다. 사업·투자 분석, 입지 검토, 자산 평가에 활용합니다.

본 스킬은 tae0y/real-estate-mcp (MIT)를 NomaDamas k-skill-proxy 경유로 단순화한 가이드입니다.

When to use / When not to use

사용: 실거래가/전월세 조회, 단지별 시세 추이, 평형별 가격 분포, 지역별 시세 비교.

사용 금지: 해외 부동산, 호가/매물 비교(실거래 아님), 세금·등기·중개 법률 자문, 청약홈 분양/당첨 조회.

Inputs

• q: 지역명 (region-code endpoint, 예: "서울 강남구")
• lawd_cd: 5자리 법정동 코드 (transaction endpoint, 예: "11680")
• deal_ymd: 6자리 거래년월 YYYYMM (예: "202403")
• num_of_rows: 조회 건수 (기본 100, 최대 1000)

Prerequisites

사용자 측 필수 시크릿 없음. 인터넷 연결만 있으면 동작합니다.

• KSKILL_PROXY_BASE_URL (선택): self-host 프록시 사용 시. 비우면 기본 hosted https://k-skill-proxy.nomadamas.org 사용.
• 운영 측 DATA_GO_KR_API_KEY는 프록시 서버 환경에만 둡니다.

Supported endpoints

지역코드 조회

GET /v1/real-estate/region-code?q={지역명}

실거래가/전월세 조회

GET /v1/real-estate/:assetType/:dealType?lawd_cd={코드}&deal_ymd={년월}

assetType	dealType	설명
apartment	trade	아파트 매매
apartment	rent	아파트 전월세
officetel	trade	오피스텔 매매
officetel	rent	오피스텔 전월세
villa	trade	연립다세대 매매
villa	rent	연립다세대 전월세
single-house	trade	단독/다가구 매매
single-house	rent	단독/다가구 전월세
commercial	trade	상업업무용 매매

commercial/rent는 미지원.

Examples

# 지역코드 조회
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/region-code' \
  --data-urlencode 'q=강남구'

# 아파트 매매 실거래가
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/apartment/trade' \
  --data-urlencode 'lawd_cd=11680' \
  --data-urlencode 'deal_ymd=202403'

# 오피스텔 전월세
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/officetel/rent' \
  --data-urlencode 'lawd_cd=11680' \
  --data-urlencode 'deal_ymd=202403'

Response shape

매매:

{
  "items": [
    {
      "name": "래미안 퍼스티지",
      "district": "반포동",
      "area_m2": 84.99,
      "floor": 12,
      "price_10k": 245000,
      "deal_date": "2024-03-15",
      "build_year": 2009,
      "deal_type": "중개거래"
    }
  ],
  "summary": {
    "median_price_10k": 230000,
    "min_price_10k": 180000,
    "max_price_10k": 310000,
    "sample_count": 42
  }
}