real-estate-search

기본적으로 로 요청해서 한국 부동산 실거래가/전월세 데이터를 조회한다. 국토교통부(MOLIT) 실거래가 신고 데이터를 기반으로 한다. 없음. 사용자는 별도 API key를 준비할 필요가 없다. upstream key는 proxy 서버에서만 주입한다. 추가 client API 레이어는 불필요하다. 그냥 프록시 서버에 HTTP 요청만 넣으면 된다. KSKILL_PROXY_BASE_URL 환경변수가 있으면 그 값을 사용하고, 없으면 기본 경로 를 사용한다. commercial/rent 는 지원하지 않는다. 지역코드 조회: 아파트 매매 실거래가 조회: 오피스텔 전월세 조회: 매매와 동일 구조이나 아이템에 deposit_10k , monthly_rent_10k , contract_type 이 포함되고, summary에 median_deposit_10k , monthly_rent_avg_10k 등이 들어간다. - "잠실 리센츠 2024년 매매 실거래가 찾아줘" - "마포구 아파트 전세 실거래가 보여줘" - "성수동 오피스텔 월세 실거래 데이터 볼래" - "강남구 연립다세대 매매 실거래가" - "용산구 상업업무용 건물 거래 내역" - 해외 부동산 시세/거래 조회 - 실거래가가 아닌 민간 호가/매물 비교만 필요한 경우 - 세금/등기/중개 법률자문처럼 판단이 필요한 경우 - 청약홈 분양/당첨 조회 (아직 미지원) - q : 지역명 (region-code endpoint, 예: "서울 강남구" , "마포구" ) - lawd_cd : 5자리 법정동 코드 (transaction endpoint, 예: "11680" ) - deal_ymd : 6자리 거래년월 YYYYMM (예: "202403" ) - num_of_rows : 조회 건수 (기본 100, 최대 1000) - 실거래가/전월세 요청이면 region-code endpoint로 행정구역 코드를 먼저 확인한 뒤 자산 타입별 endpoint로 조회한다. - 아파트 매매는 apartment/trade , 아파트 전월세는 apartment/rent 를 우선 사용한다. - 오피스텔/빌라/단독주택/상업업무용은 자산 타입에 맞는 endpoint로 라우팅한다. - 사용자가 동/건물명/연월을 덜 줬으면 지역, 단지명, 기준 월을 먼저 보강한다. - 실거래가와 호가를 섞어 말하지 않는다. 이 스킬은 국토교통부 기반 실거래/전월세 신고 데이터를 다룬다. - 지역명 + 자산 타입 + 거래년월 - 거래 건수 (summary.sample_count) - 가격 요약: 중위값, 최소, 최대 - 상위 3-5건 대표 거래 (이름, 면적, 층, 가격, 날짜) - 전월세면 보증금 + 월세 요약도 포함 - lawd_cd 또는 deal_ymd 형식이 잘못되면 400 응답 - 프록시 서버에 DATA_GO_KR_API_KEY 가 없으면 503 응답 - upstream...