청약 분양 공고
realty_presaleRead-onlyIdempotent
아파트 청약(분양) 공고를 조회한다 — 분양가·청약 접수 일정·당첨자 발표일·입주 예정·위치. "다음 달 청약 넣을 만한 데 있어?", "○○에 분양하는 아파트 있어?"류 질문용.
**"오늘/지금 접수 가능한 청약"은 status='접수중'이다.** upcoming=true는 접수 **시작 전**(오늘
시작분 포함)만 주므로 그 질문에 쓰면 이미 접수 중인 공고를 대부분 놓친다. 행마다 오늘 기준 판정
`apply_status`(접수중/접수예정/접수마감/일정미상)와 `apply_status_text`가 붙고, 그 기준일은
meta.today다 — **날짜를 직접 비교해 상태를 다시 판정하지 말고 이 값을 그대로 전하라.**
"넣을 만해?/적정가야?"까지 물으면 이어서 realty_presale_vs_market으로 분양가를
실거래 시세와 대조하라(응답의 house_manage_no가 그 도구의 입력이다).
price_min/price_max는 주택형별 분양 최고가의 최소·최대(만원)다 — 한 공고에 여러
주택형(house_type_count)이 있다. 청약 자격·순위 요건은 이 데이터에 없다(지어내지 말 것).
경쟁률·당첨 가점 커트라인은 realty_subscription_odds 도구에 있다. 행마다 `rank1_result`(1순위
해당지역 결과 요약 — status·undersubscribed_types/total_types·shortfall_households·verdict_text)가
붙는다: status가 published가 아니면 **미달 여부를 모른다**는 뜻이지 경쟁이 있었다는 뜻이 아니다.
무순위(줍줍)·취소재공급이 돈 공고에는 `unsold_history`(회차·세대)가 붙는다 — 접수
경쟁률이 높아도 무순위가 돌았다면 "당첨 후 계약이 안 된" 시장이다. 없다고 이력이
없던 건 아니다(meta.unsold_note의 연결 한계 참조). 무순위 공고 자체(지금 나온 것·몇 번
나왔나)는 notice_kind로 묻는다. 같은 지역 공고들의 분양가가
올라온 추이("기다림의 비용")는 realty_presale_price_trend.
규제지역 플래그: speculation_zone(투기과열지구)·adjustment_area(조정대상지역)·
price_cap_applied(분양가상한제), Y/N — **모집공고일(announced_on) 기준 스냅샷**이라
이후 지정·해제가 바뀔 수 있다. "현재 규제지역"으로 단정하지 말고 공고일과 함께 전하라.
전매제한·거주의무 기간은 이 데이터에 없다(플래그에서 유추 금지) —
realty_notice_facts가 공고 원문 값을 쪽 번호와 함께 준다.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 공고 수 — 주택형별 분양가·순위별 일정이 붙어 행이 무겁다. 요청분을 다 실으면 응답이 크기 상한을 넘는 경우 **실제 반환 수를 줄이고 meta.size_capped**에 총계·좁혀 부르는 법을 값으로 싣는다 — 조용히 자르지 않는다 (허용 범위 1~50) | |
| since | No | 이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에 | |
| region | No | 시도 (예: 서울, 경기, 세종, 부산) | |
| status | No | 오늘(KST) 기준 접수 상태로 거른다. **'오늘/지금 접수 가능한', '지금 넣을 수 있는' 질문은 '접수중'이다** — '접수예정'은 아직 못 넣는 것들이다. '다음 달 청약'처럼 앞으로를 묻는 질문만 '접수예정'. 기본 '전체'. | 전체 |
| keyword | No | 단지명·공급 주소 부분일치 (예: '우미린', '5-2생활권', '다솜동') — 생활권·동 단위 질의는 이걸로 | |
| sigungu | No | 시군구 정확한 이름 (예: 수원시, 강남구). ⚠️세종은 이 필드가 동·생활권·도로명으로 오염돼 있으니 쓰지 말고 keyword를 쓰라 | |
| question | No | (선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라 | |
| upcoming | No | ⚠️True면 접수 **시작 전**(시작일이 오늘 이후, 오늘 시작 포함) 공고만 — 어제 이전에 시작해 **접수 중인 공고는 여기 없다**. 오늘 넣을 수 있는 것을 찾는다면 status='접수중'을 써라. status와 함께 쓰지 말 것(status가 이것을 대체한다). | |
| notice_kind | No | 공고 종류. 기본 '본공고'. 무순위(줍줍)·재공급을 물으면 그 값 — status 기본은 접수중+접수예정이고, '접수마감'이면 목록 대신 단지별 회차 이력 집계(몇 번 나왔나). | 본공고 |