real-estate-search

# 한국 부동산 실거래가 조회 국토교통부(MOLIT) 실거래가 신고 데이터를 기반으로 매매·전월세 실거래를 조회합니다. 사업·투자 분석, 입지 검토, 자산 평가에 활용합니다. > 본 스킬은 [`tae0y/real-estate-mcp`](https://github.com/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 ```bash # 지역코드 조회 curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/real-estate/region-code' \ -...