지역 검색 (시도 → 시군구 → 읍면동 계층 탐색)

지역 코드를 단계적으로 탐색합니다.

• 기본값(0000000000): 전국 시도 목록

• 시도 코드: 시군구 목록

• 시군구 코드: 읍면동 목록

예시: "성남시 분당구 정자동"

1. search_regions() → 경기도 "4100000000"

2. search_regions("4100000000") → 성남시분당구 "4113500000"

3. search_regions("4113500000") → 정자동 "4113510300"

rate limit 시 내장 코드로 자동 fallback됩니다.

Args: cortar_no: 지역 코드 (10자리). 기본값은 전국.

지역 정보 + 좌표 조회 (m.land 기반, rate limit 강건)

cortarNo를 입력하면 해당 지역의 정확한 좌표, 지역명, 매물 클러스터 수를 반환합니다. search_regions가 rate limit에 걸릴 때 대안으로 사용하세요. 반환된 좌표는 search_listings에서 바로 사용 가능합니다.

Args: cortar_no: 지역 코드 (읍면동 10자리) real_estate_type: APT, OPST, VL 등 trade_type: A1(매매), B1(전세), B2(월세)

특정 동의 단지 목록 조회

rate limit 시 좌표 기반 매물 검색으로 자동 전환됩니다. 전환 시 search_listings 사용을 안내합니다.

Args: cortar_no: 읍면동 코드 (10자리) real_estate_type: APT, OPST, VL 등

좌표 기반 매물 검색 (가장 안정적인 방법)

단지 코드 없이 좌표만으로 해당 지역의 모든 매물을 검색합니다. get_region_info로 좌표를 먼저 확인하거나, 알고 있는 좌표를 직접 입력하세요.

거래 유형: A1(매매), B1(전세), B2(월세) — 여러 개는 콜론으로 구분 (A1:B1:B2) 부동산 타입: APT(아파트), OPST(오피스텔), VL(빌라) — 여러 개는 콜론으로 구분

Args: lat: 위도 (예: 37.3675) lon: 경도 (예: 127.1127) cortar_no: 지역 코드 (선택, 입력 시 더 정확한 결과) real_estate_type: 부동산 타입 (기본: APT) trade_type: 거래 유형 (기본: A1=매매) delta: 검색 반경 (기본: 0.015 ≈ 약 1.5km) max_pages: 최대 페이지 수 (기본: 3, 페이지당 20건)

단지별 매물 목록 (1페이지)

거래 유형: A1(매매), B1(전세), B2(월세) 정렬: prc_(가격순), spc_(면적순), date_(최신순)

Args: complex_no: 단지 코드 (get_complexes에서 확인) trade_type: 거래 유형 order: 정렬 page: 페이지 번호

단지별 매물 전체 (자동 페이징)

Args: complex_no: 단지 코드 trade_type: A1(매매), B1(전세), B2(월세) order: prc_(가격순), spc_(면적순), date_(최신순) max_pages: 최대 페이지 수

단지 상세 정보 (세대수, 면적, 입주년도, 건설사 등)

Args: complex_no: 단지 코드

시세/실거래가 추이

Args: complex_no: 단지 코드 area_no: 면적 번호 (get_complex_detail → pyeongNo) trade_type: A1(매매), B1(전세), B2(월세) year: 조회 기간 (기본 5년)

단지 주변 학군 (초/중/고)

Args: complex_no: 단지 코드