Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Korea Realty is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Korean real estate: court auctions, 10M+ MOLIT records, subscription notice facts, loan/DSR rules
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http korea-realty-mcp 'https://realty.sallim.app/mcp?via=official'
# 2 — ask your agent for something these tools do
# search, fetch, realty_search_auctions and 53 more
Korea Realty costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http korea-realty-mcp 'https://realty.sallim.app/mcp?via=official'Reconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
56 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
법원경매 물건을 자연어 문장으로 검색한다(경매 전용 — 청약·시세는 다른 도구다). 법원경매 물건을 자연어로 검색한다. 경매 전용 — 청약·분양 공고는 realty_presale, 분양가 적정성은 realty_presale_vs_market, 시세 통계는 realty_region_price_stats. 지역·물건종류·유찰횟수·감정가를 질의에서 뽑아 필터링한다. 예: "서울 강남구 아파트", "유찰 2회 이상인 경기도 오피스텔", "서울 아파트 감정가 5억 이하". 이 파서는 최소 어댑터라 못 쓰는 축(면적·기일·층 등)이 있다. 못 쓴 조건은 응답의 unapplied_conditions에 적히므로, 그게 비어 있지 않으면 결과 범위를 좁게 오인하지
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | string | yes | 경매 물건을 찾는 자연어 한 줄. 예: '서울 강남구 아파트' · '유찰 2회 이상인 경기도 오피스텔' · '서울 아파트 감정가 5억 이하'. 이 파서가 읽는 축은 넷뿐이다 — 지역(시도는 '서울'·'서울특별시' 둘 다 되고, 시군구는 '강남구'·'평택시'처럼 원장 표기, 특례시는 '수원시 권선구'), 물건종류(아파트·오피스텔·다세대·연립주택·단독주 |
search가 돌려준 id로 경매 사건의 전체 내용을 가져온다. id 형식은 "법원명|사건번호" (예: "서울동부지방법원|2025타경51727"). 사건번호는 법원 간 중복되므로 법원명 없이 조회하면 후보 목록이 돌아올 수 있다. rights(매각물건명세서 요약)가 있으면 법원 공시의 전달로만 인용하고, 없으면(rights_note 참조) 권리관계를 지어내지 말 것 — 권리분석 판단은 이 도구의 데이터 밖이다. 이 축의 자리 — 사건 상세도 둘이고 입력과 응답 형태로 갈린다. 이 도구는 search가 준 "법원명|사건번호" 한 덩어리를 그대로 받아 문서형 텍스트를 돌려준다(ChatGPT 커넥터 규격). 사용자가 사건번호를 말로 불러
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | string | yes | search가 돌려준 id를 그대로 넣는다 — 법원명|사건번호 형식이다 (예: '서울동부지방법원|2025타경51727'). 파이프 앞은 정식 법원명이고 지원은 '진주지원'처럼 지원명만 오는 행도 있다. 파이프 뒤는 2026타경3571 꼴 (연도 4자리 + '타경' + 일련번호, 일련번호는 3~6자리). 법원명 없이 사건번호만 넣으면 사건번호가 |
법원경매 물건을 지역·종류·감정가·유찰횟수로 필터링해 조회한다. 이 축의 자리 — 조건을 값으로 아는 검색이 이 도구다. 사용자의 자연어 한 줄밖에 없으면 search가 먼저다(질의에서 조건을 뽑아 준다). 개별 사건의 상세는 여기가 아니라 realty_get_auction_case(사건번호+법원명)·fetch(search가 준 id)다. 이 도구는 법원경매(민사집행법·각급 법원)만 조회한다 — 공매는 여기가 아니다. 공매(국세징수법·국유재산법 등, 한국자산관리공사 온비드)는 이 서버에 따로 있다: 물건은 realty_search_onbid, 낙찰가율은 realty_onbid_sale_rate (2026-08
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sido | no | 시도. '서울'처럼 줄여 써도 되고 '서울특별시'도 된다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 한쪽으로 읽지 않고 거절한다(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라. | |
| sigungu | no | 시군구 (예: 강남구, 성남시) ⚠️ 시도 없이 시군구만 주면 합치지 않고 거절한다(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다. | |
| usage_name | no | 물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다. '토지'는 이 원장에 없는 이름이다 — 대지·임야·전답으로 나뉘어 있어 그대로 넣으면 서버가 사유와 유효값 목록을 들어 거절한다. 비우면 전 종류 | |
| min_price_10k | no | 최소 감정가, 만원 단위 (5억이면 50000) | |
| max_price_10k | no | 최대 감정가, 만원 단위 | |
| min_bid_count | no | 최소 유찰 횟수. 유찰이 쌓일수록 최저입찰가가 내려간다. (허용 범위 0~100) | |
| exclude_past | boolean | no | 매각기일이 이미 지난 행 제외 여부. 기본 False(전체 반환 — 지난 기일 행에는 past_auction_note 플래그가 붙는다). '지금 입찰 가능한 물건' 질문이면 True로 호출하라 — 오늘 이후 기일(기일 미정 포함)만 남는다. |
| sort | string | no | 정렬 기준 |
| limit | integer | no | 반환 개수 (최대 50) (허용 범위 1~50) |
| offset | integer | no | 페이지 오프셋. has_more가 true면 next_offset으로 다시 호출하라. |
| since | no | 이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에 |
사건번호로 경매 물건의 상세를 조회한다. 재매각 사건의 입찰보증금처럼 사건마다 다른 매각조건 질문도 사건을 특정하는 여기서 시작한다. 사건번호는 법원 간 유일하지 않다(전국 평균 2.8개 법원에서 중복). court_name을 생략하면 중복 시 오류와 함께 후보 법원 목록이 돌아오니, 그걸 보고 법원을 지정해 다시 호출하라. rights = 매각물건명세서 핵심(최선순위 설정·인수되는 권리 원문·위험 플래그·배당요구종기). 이것은 법원 공시의 전달이지 권리분석 판단이 아니다 — 답할 때 rights.disclaimer를 함께 전하고, 등기부·임차인 현황 전체가 아님을 밝혀라. rights가 null이면 명세서 미수집 상태(rights_note에
| Parameter | Type | Required | Notes |
|---|---|---|---|
| case_no | string | yes | 사건번호 — 2026타경3571 꼴이다(연도 4자리 + '타경' + 일련번호 3~6자리). 원장 전수가 '타경' 접두이고 '2024타경101026'처럼 6자리도 있다. '2026-3571'처럼 하이픈으로 써도 서버가 '타경'으로 펴고 무엇을 폈는지 응답에 적는다. 다만 '3571'처럼 연도가 없으면 못 편다(연도를 지어내면 다른 사건이 된다) — |
| court_name | no | 법원명 — '서울동부지방법원'·'인천지방법원'처럼 정식명으로 넣는다('진주지원'처럼 지원명만인 행도 있다). '의정부지법'처럼 줄여 넣어도 서버가 정식명으로 편다. 사건번호는 법원 간 유일하지 않아(전국 평균 2.8개 법원에서 중복) 생략하면 후보 목록이 돌아온다. 여기 넣은 법원에 그 사건이 없으면 서버가 법원 없이 한 번 더 찾아보고, 그래도 없 | |
| market_context | boolean | no | 기본 true — 같은 단지(빌라는 같은 동·면적대) 시세 대비 비율과 지역 낙찰가율을 market_context로 함께 싣는다(+2~4초). 사건 정보만 필요하면 false |
| question | string | no | (선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라 |
경매 물건의 최저입찰가를 같은 단지 실거래 시세와 대조해 할인율·표면수익률을 낸다. 기본은 오늘 이후 기일 물건만이다(지난 기일이 섞여 나오던 결함 수리, 2026-08-08). 주소·단지명 정규화 정확매칭으로 붙이며, 감정가가 기준선의 50~150% 범위인 건만 비교한다 (지분경매·특수물건을 배제하기 위함). 결과의 signal은 주의/관심/보통/낮음/판정보류다. 시세 기준선은 같은 단지의 같은 면적대(±10%) 실거래 평균이다(2026-08-16 수리 — 종전엔 단지 전 평형 혼합 평균이라 대형·소형이 섞인 단지에서 할인율이 통째로 어긋났다). 면적을 맞추지 못하면 discount_vs_market_pct는 null이고 signal
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sido | no | 시도 — '서울'처럼 줄여 써도 되고 '서울특별시'도 된다(서버가 정식명으로 편다). 원장 표기는 서울특별시·경기도·부산광역시·세종특별자치시·강원특별자치도 같은 정식명이다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 한쪽으로 읽지 않고 거절한다(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido= | |
| sigungu | no | 시군구 — 원장 표기 그대로 넣는다(예: '강남구', '평택시', '기장군'). 특례시·일반구는 '수원시 권선구'처럼 두 토막이다. 시도 이름을 여기 붙이지 마라('서울 강남구'는 안 맞는다) — 시도는 sido로 준다 ⚠️ 시도 없이 시군구만 주면 합치지 않고 거절한다(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 | |
| usage_name | string | no | 물건 종류 — 이 도구는 같은 단지 실거래와 붙이므로 '아파트'가 기본이다. 오피스텔·다세대·연립주택도 되지만 단지 매칭률이 떨어진다. 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·근린시설·상가 |
| case_no | no | 특정 사건 하나만 비교할 때 — 2026타경3571 꼴(연도 4자리 + '타경' + 일련번호). 주면 지역 조건 대신 이 사건만 보고, 기일 제한도 걸지 않는다. 사건번호는 법원 간 중복되니 court_name을 반드시 함께 주라 | |
| court_name | no | 법원명 — case_no와 함께 쓴다. 사건번호는 법원 간 유일하지 않아(평균 2.8배 중복) 이걸 빼면 다른 법원 물건이 섞이고 최저가 출처도 확정되지 않는다 | |
| include_past | boolean | no | 지난 기일 물건 포함 여부 — 기본은 오늘 이후 기일만(입찰 가능 후보). case_no 특정 조회는 이 값과 무관하게 기일 제한이 없다 |
| limit | integer | no | 비교할 물건 수 (최대 50) (허용 범위 1~50) |
"이 지역 이 물건은 보통 감정가의 몇 %에 낙찰되나"를 실제 매각결과로 답한다. 입찰가를 정할 때 쓰는 핵심 지표다. by_fail_count에 유찰 횟수별 분포가 들어 있어 "2회 유찰된 물건은 보통 몇 %에 낙찰되는가"를 바로 읽을 수 있다. 낙찰가율 = 낙찰가 / 감정가 × 100. 100%를 넘으면 감정가보다 비싸게 팔린 것이다. "감정가 12억에 최저가 7.68억이면 몇 번 유찰됐나"는 이 도구가 아니다 — 그건 낙찰 통계가 아니라 저감 산수다(최저가 = 감정가 × (1−저감률)^유찰횟수, 법원별 저감률 실측표와 예시는 realty_policy_rules(topic='auction_rights', section='minimum_price_r
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sido | no | 시도 — '서울'처럼 줄여 써도 되고 '서울특별시'도 된다(서버가 정식명으로 편다). 원장 표기는 서울특별시·경기도·부산광역시·세종특별자치시·강원특별자치도 같은 정식명이다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 한쪽으로 읽지 않고 거절한다(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido= | |
| sigungu | no | 시군구 — 원장 표기 그대로 넣는다(예: '강남구', '평택시', '기장군'). 특례시·일반구는 '수원시 권선구'처럼 두 토막이다. 시도 이름을 여기 붙이지 마라('서울 강남구'는 안 맞는다) — 시도는 sido로 준다 ⚠️ 시도 없이 시군구만 주면 합치지 않고 거절한다(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 | |
| usage_name | string | no | 물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. '빌라'는 표준 분류가 아니라 서버가 '다세대'로 매핑하고 그 사실을 응답에 공시한다. 비우면 전 종류 |
| bid_count_max | no | 유찰 횟수 상한(이하). 예: 2를 주면 유찰 0·1·2회 물건의 매각결과만 집계한다. 유찰이 쌓일수록 낙찰가율이 내려가므로 대상 물건의 유찰 횟수에 맞춰 좁혀라. 비우면 유찰 횟수 무관 전체(응답의 by_fail_count에 횟수별 분포가 그대로 온다) (허용 범위 0~100) | |
| area_band | no | 전용면적대로 좁힌다. 낙찰가율은 평형에 따라 갈린다 — 대상 물건의 평형을 알면 반드시 넣어라(응답의 by_area_band로도 확인된다) |
한국자산관리공사 온비드 공매 물건을 지역·용도·재산구분·감정가로 조회한다. 법원경매가 아니다. 공매는 국세징수법(압류재산)·국유재산법·공유재산법에 따른 처분이고 주관은 캠코다 — 아래 '이 축의 자리'와 응답의 not_court_auction을 반드시 함께 전하라. 이 축의 자리 — 공매 축은 도구가 둘뿐이다. 물건을 찾고 회차별 최저가 일정을 보는 것이 이 도구, "보통 감정가의 몇 %에 낙찰되나"는 realty_onbid_sale_rate다. 법원경매를 물었다면 여기가 아니라 realty_search_auctions이고, 사건번호에 '타경'이 들어 있으면 그쪽이다. 사용자가 그냥 "경매"라고만 했으면 어느 쪽인지 되물어라 —
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sido | no | 시도. '서울'처럼 줄여 써도 되고 '서울특별시'도 된다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 한쪽으로 읽지 않고 거절한다(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라. | |
| sigungu | no | 시군구 (예: 춘천시, 강남구). 부분일치다 — '고양시'는 '고양시 덕양구'도 잡는다. ⚠️ 시도 없이 시군구만 주면 합치지 않고 거절한다(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). | |
| usage_name | no | 용도 부분일치(대·중·소 3단을 한꺼번에 건다). 중분류 5종은 토지·주거용건물·상가용및업무용건물·용도복합용건물·산업용및기타특수용건물이고 소분류는 91종이다. '아파트'는 소분류라 중분류로는 안 걸린다 — 넓게 보려면 '주거용건물'. 원장 값 예: 주거용건물·아파트·다세대주택·대지·상가주택. 경매 어휘 '전답'은 여기 없다(전·답으로 갈렸다) — 없 | |
| property_type | no | 재산구분 — 공매에서 가장 중요한 축이다. 압류재산(체납처분·국세징수법)·국유재산·공유재산·기타일반재산·수탁재산·불용품. 성격이 완전히 다르다: 압류재산은 체납자 재산의 강제매각이고 나머지는 공공이 가진 재산의 처분·임대다. | |
| min_price_10k | no | 최소 감정가, 만원 단위 (5억이면 50000) | |
| max_price_10k | no | 최대 감정가, 만원 단위 | |
| open_only | boolean | no | 입찰 마감이 아직 안 지난 회차가 남은 물건만. 기본 True — 원장에는 이미 끝난 회차 행이 함께 들어 있어서(물건 25,669개 중 마감 전 회차가 남은 것은 10,327개), 끄면 지금 입찰할 수 없는 물건이 섞인다. cltr_mng_no로 특정 물건을 볼 때는 무시된다. |
| cltr_mng_no | no | 물건관리번호(예 '2026-0600-031235')로 한 물건만. 이것이 상세 조회다 — 이 원장은 행이 물건이 아니라 회차라, 한 물건의 상세는 곧 그 물건의 회차 전부이고 그때 rounds에 회차별 최저입찰가 일정이 실린다. 법원 사건번호(2025타경…)는 여기 넣지 마라. | |
| sort | string | no | deadline=마감 임박순 · price_asc/desc=감정가순 · discount=감정가 대비 최저가가 낮은 순(저감 많이 된 순) |
| limit | integer | no | 반환 물건 수 (최대 50) (허용 범위 1~50) |
| offset | integer | no | 페이지 오프셋. has_more면 next_offset으로 다시 호출하라. |
공매가 "보통 감정가의 몇 %에 낙찰되나"와 "얼마나 유찰되나"를 실제 개찰 결과로 답한다. 법원경매의 realty_auction_sale_rate와 같은 이름의 다른 지표다. 분모가 둘 다 감정가지만 평가 주체·저감 규칙·매물 성격이 달라 두 %를 한 문장에 섞으면 안 된다. "경매 낙찰가율"을 물었으면 어느 쪽인지 확인하라. 이 축의 자리 — 공매 축 2종 중 통계 쪽이다. 개별 물건과 회차별 최저가는 realty_search_onbid다. 낙찰가율은 재산구분별로 갈라 읽어라(by_property_type). ⚠️ 표본은 최근 3개월 개찰분이고, 그중 '낙찰' 건만 낙찰가율에 든다. 온비드 전체 입찰결과 688,264
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sido | no | 시도. 주의: 결과 원장에는 지역 컬럼이 없다 — 물건명 접두에서 되찾은 값으로 거른다(커버리지는 응답의 region_basis에 실린다). ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 한쪽으로 읽지 않고 거절한다(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu= | |
| sigungu | no | 시군구. 물건명에서 시도 다음 한 토막을 뽑은 것이라 '고양시 덕양구'는 '고양시'로만 잡힌다 — 자치구까지 좁히려면 이 원장으로는 안 된다. ⚠️ 시도 없이 시군구만 주면 합치지 않고 거절한다(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라( | |
| usage_name | no | 용도 부분일치(대·중·소 3단). 원장 값 예: 주거용건물·아파트·토지·근린생활시설. 표본이 입찰결과 원장이라 물건 목록과 어휘가 미세하게 갈린다 — 없는 이름은 거절하며 이 원장의 쓸 수 있는 값을 준다. | |
| property_type | no | 재산구분. 이 축을 빼고 하나의 낙찰가율을 말하면 거의 틀린다 — 실측 중앙값이 압류재산 31.6% vs 국유재산 106.3%로 3배 넘게 갈린다. |
유찰이 쌓여 최저입찰가가 크게 떨어진 경매 물건을 골라낸다. 유찰이 누적돼 최저입찰가가 크게 떨어진 물건을 찾는다. "○○에서 유찰 많은 물건"은 sido/sigungu로 좁혀라. 유찰이 많다는 건 싸다는 뜻이기도 하지만 권리관계·물건 하자 등 팔리지 않는 이유가 있다는 뜻이기도 하다. 결과를 추천으로 제시하지 말고 확인이 필요한 후보로 제시하라. 같은 축의 다른 문: realty_search_auctions(min_fail_count)로도 유찰 물건을 거를 수 있다 — 조건 필터·목록이 목적이면 그쪽, 저감 큰 후보 발굴(극단 할인 컷 포함)이면 이쪽. 둘을 합쳐 세지 마라(같은 물건이 양쪽에 나온다).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| min_bid_count | integer | no | 최소 유찰 횟수 (허용 범위 0~100) |
| min_discount_pct | integer | no | 감정가 대비 최소 할인율(%) (허용 범위 0~100) |
| max_discount_pct | integer | no | 감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라 (허용 범위 0~100) |
| sido | no | 시도 (예: 세종, 경기도) ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 한쪽으로 읽지 않고 거절한다(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라. | |
| sigungu | no | 시군구 (예: 강남구, 수원시) ⚠️ 시도 없이 시군구만 주면 합치지 않고 거절한다(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다. | |
| usage_name | no | 물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다(표기를 바꾸지 않는다 — '다세대'로 자동 매핑하는 것은 낙찰가율 통계 realty_auction_sale_rate 쪽이다). '토지'는 이 원장에 없는 이름이라 거절된다 — 대지 | |
| limit | integer | no | 반환 개수 (최대 50) (허용 범위 1~50) |
경매 사건 하나의 유찰 이력·가격 변동·물건 사진을 조회한다. 경매 사건의 유찰 이력(기일별 최저가 저감 시계열)·가격 변동 이벤트·물건 사진 URL을 조회한다. "몇 번 유찰됐어? 얼마나 떨어진 거야? 사진 있어?"류 질문의 담당 도구. 사진은 법원 원천에서 기일 후 소멸해 수집 시점 보존본만 존재한다(국내 공개 API에 드문 축). court_schedule에서 result='유찰'인 행이 유찰 이력, min_bid_10k의 저감이 가격 흐름이다. result가 null인 행은 미래 기일이거나 미해독 법원 코드(result_code 원문 병기)다 — 의미를 지어내지 말고 그대로 전하라. **최저가(min_bid_10k)가 없는 행에는 `kind_not
| Parameter | Type | Required | Notes |
|---|---|---|---|
| case_no | string | yes | 사건번호 — 2026타경3571 꼴이다(연도 4자리 + '타경' + 일련번호 3~6자리). 원장 전수가 '타경' 접두이고 '2024타경101026'처럼 6자리도 있다. '2026-3571'·'3571'처럼 접두 없이 넣지 마라 |
| court_name | no | 법원명 — '서울동부지방법원'·'인천지방법원'처럼 정식명으로 넣는다('진주지원'처럼 지원명만인 행도 있다). 사건번호는 법원 간 유일하지 않아(전국 평균 2.8개 법원에서 중복) 생략하면 후보 목록이 돌아온다 |
지역의 아파트 실거래 시세 추이(월별)를 조회한다. 경매가가 싼지 판단하는 기준선이 된다. 이 축의 자리(시세 도구 3종 중): 월별 흐름·방향이 필요할 때 이걸 쓴다. 지역의 가격 수준을 인용할 거면 realty_area_price_bands를 쓰라 — 이 축은 이상치(지분· 증여성 직거래)가 필터되지 않아 평균이 눌리며, 두 도구 값이 갈리면 bands 쪽이 정상 매매에 가깝다(세종 소형 실측 4,400만원 차). 단지가 특정된 질문("○○아파트 얼마야")은 realty_search_complexes가 기본이다 — 지역 평균은 단지 간 편차(같은 동 같은 평형에서 단지 평균 24% 차)를 뭉갠다. region은 시군구명(예
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | string | yes | 지역명 — 시군구까지(예: '강남구', '수원시 권선구') 또는 법정동까지(예: '강남구 대치동', '세종특별자치시 나성동'). 시도 약칭은 서버가 정식명으로 펴지만('서울 마포구' → '서울특별시 마포구'), 동명 지역이 여럿이면 시도를 앞에 붙여라 — 안 붙이면 고르지 않고 거절하며 이름이 정확히 같은 후보 목록을 준다('동구'는 '남동구 |
| metric | string | no | price=매매, rental=전월세. 평형 인자(pyeong_exclusive·pyeong_supply·area_m2_exclusive·area_m2_supply)는 price에서만 먹는다 — 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다(전체 평형 값이 오고 warning_pyeong_fall |
| months | integer | no | 조회 개월 수 (허용 범위 1~60) |
| pyeong_exclusive | no | 전용면적 기준 실평수(평) — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. 사용자가 ㎡로 말했으면 이 인자가 아니라 area_m2_exclusive를 쓰라 (㎡ 값을 여기 넣으면 60평 초과로 거절된다). 1평=3.3058㎡ 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다 — 주면 | |
| pyeong_supply | no | 분양평수(공급면적, 평) — 흔히 말하는 '34평'이 이것이다. 내부에서 ×0.745로 전용 실평수로 환산한다. ㎡로 말했으면 area_m2_supply를 쓰라 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다 — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 | |
| area_m2_exclusive | no | 전용면적을 ㎡ 그대로 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다 | |
| area_m2_supply | no | 공급(분양)면적을 ㎡ 그대로 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다 — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_comp | |
| top_n | no | 가격순 상위 거래 '목록'을 함께 받는다(1~20). '신고가 상위 5개', '제일 비싸게 팔린 아파트', '고가 거래 목록'처럼 개별 거래를 나열하는 질문이 이 인자다 — 안 주면 이 도구는 평균·중앙·최고 같은 집계만 답하고 목록은 못 준다. 행에 단지·전용면적·평형·금액·계약일·층이 실린다(top_transactions). met | |
| by_dong | boolean | no | metric='rental'에서 법정동 × 전용면적대(60㎡ 미만·60~85㎡·85㎡ 초과) 전세 보증금 중앙값을 함께 받는다(by_dong). '세종 어느 동이 전세 2.3억 이하야'처럼 한 시군구 안에서 동을 고르는 질문의 자리다 — 세종은 시군구가 하나라 이 인자 없이는 동별 전세를 못 가른다. 표본 3건 이상 칸만 나온다. 매매 동별은 rea |
지역 가격 추이를 양쪽 창에 모두 거래가 있는 동일 단지들로만 계산한다. 왜 필요한가: 구 월평균 추이는 '가격이 변한 것'과 '팔린 단지가 바뀐 것'을 구분하지 못한다. 표본이 얇으면 후자가 지배하는데, 그걸 시세 변동으로 읽으면 오답이다 (2026-08-14 실사고: 용산 33평 월 1~7건 표본으로 '전년 대비 −9.6%'를 만들었다). 이 도구는 naive(전체 평균 변화)와 basket(동일 단지 변화)을 나란히 주고 그 차이를 composition_effect로 보여준다 — 차이가 크면 그 지역 평균 추이는 구성 잡음이다. 단지별 값은 평당가라 단지 안의 평형 구성 변화도 흡수한다. 한계를 반드시 함께 전하라:
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | string | yes | 시군구명 (예: 용산구, 성동구). 여러 시도에 같은 이름이 있는 시군구(중구·동구·서구·남구·북구·강서구)는 시도를 함께 주라(예: '서울 중구') — 안 주면 합치지 않고 후보를 실토하며 거절한다 |
| window_months | integer | no | 비교 창 하나의 길이(개월). 최근 N개월 vs 그 직전 N개월을 비교한다 (허용 범위 1~12) |
| min_tx_per_complex | integer | no | 바스켓에 넣을 단지의 창당 최소 거래 건수 — 1이면 바스켓이 커지지만 단지별 값이 한 건에 좌우된다 (허용 범위 1~10) |
| pyeong_supply | no | 분양평(사용자가 말하는 '34평') 필터 — ±3평 창으로 거른다. 좁힐수록 바스켓이 얇아져 고정 바스켓의 이점이 사라지니 응답의 바스켓 단지 수를 반드시 확인하라 (허용 범위 1~200) | |
| pyeong_band | integer | no | pyeong_supply 기준 허용 폭(±평). 넓히면 바스켓이 커지고 평형 혼합이 늘어난다 (허용 범위 1~10) |
아파트 단지를 이름·지역으로 검색하고 평형별 실거래 시세를 함께 돌려준다. "○○아파트 34평 얼마야"류 단지 질문의 1차 도구다. query·region 중 하나는 필수. 이 축의 자리(시세 도구 3종 중): 단지가 특정되면 이게 기본이다. 지역 평균 도구들(realty_region_price_stats·realty_area_price_bands)은 단지 간 편차를 뭉개므로 단지 질문에 쓰지 마라 — 같은 동 같은 평형에서 단지 평균이 24% 벌어진 실측이 있다 (동 평균 3.96억으로 답했다가 대장 단지 호가와 1억 어긋난 사고). 반대로 지역 전체의 수준·추이 질문이면 저 둘로 가라. prices_by_area가 평형별 시세다
| Parameter | Type | Required | Notes |
|---|---|---|---|
| query | no | 단지명 일부 (예: 래미안, 마포래미안푸르지오) | |
| region | no | 시군구명 (예: 마포구, 서울특별시 마포구). 법정동까지 넣어도 된다(예: '강남구 대치동') — 백엔드는 동으로 거르고 나머지 토큰은 서버가 검증해 note에 적는다. 종전 설명이 시군구만 적어 이 도구가 못 하는 일로 읽혔고, 동 단위를 원한 모델이 비아파트 도구로 새던 자리다(2026-08-23 PlayMCP QA) | |
| min_households | no | 세대수 하한 — '500세대 이상', '대단지'를 여기에 넣는다(예: 500). 세대수가 원장에 없는 단지는 이 조건에서 제외되고 그 건수를 meta.households_scope로 실토한다(미상 ≠ 소규모) | |
| max_households | no | 세대수 상한 — '300세대 이하 소규모'처럼 위쪽을 자를 때. min_households와 함께 주면 구간이 된다 | |
| sort | string | no | name=이름순(거래량 많은 순), price=평균가 높은 순(전 평형 혼합 평균이라 큰 평형이 많은 단지가 앞에 온다), year=준공연도 최신순(내림차순 — 신축이 먼저), year_asc=준공연도 오래된 순(오름차순 — 구축이 먼저, 연도 미상은 맨 뒤) — '오래된 아파트'·'재건축 연한 단지'를 찾을 때는 이것이다, **uni |
| area_band_m2 | no | 평형을 고정해 단지끼리 견줄 때 넣는다(전용면적 ㎡ — 분양면적이 아니다). 예: '59㎡대로 맞춰서 비교' → 59. 전용 ±3.0㎡ 근사 매칭이고(원장 면적이 59.224·59.9처럼 단지마다 달라 정확 일치는 대부분 0건이다), 각 단지의 price_per_exclusive_m2가 그 밴드 안 평형 행만으로 다시 계산된다. ⚠️ 이 인자 | |
| construction_year_band | no | 연식을 맞춰 단지끼리 견줄 때 넣는 기준 준공연도. 예: 2018 → 2013~2023년 준공(±5년, 폭 10년)이 비교군이 된다. 연식은 ㎡단가를 가장 강하게 끄는 축이다 — 법정동 안에서 준공연도와 ㎡단가의 순위상관 ρ 중앙값이 +0.7298로 평형(+0.2245)·입지점수(+0.0707)보다 지배적이라, 연식이 섞인 비교는 사실상 '신 | |
| max_trade_price_10k | no | 거래가 상한(만원) — '3억 이하로 살 수 있는 단지'는 30000. 집계 창 안에 이 금액 이하 실거래가 1건 이상 있었던 단지만 남긴다(평균가가 아니다 — 소형 평형만 3억대인 단지도 잡힌다; 행의 min_trade_price가 그 최저 거래가). 이 인자는 검색을 거른다. 창 안 거래가 없는 단지는 판정 불가라 빠지고 그 건수를 | |
| max_construction_year | no | 준공연도 상한 — '오래된 아파트'·'30년 넘은 단지'를 거를 때(예: 준공 30년 이상 = 올해-30). 이 인자는 검색을 거른다(construction_year_band는 표시만 한다). 준공연도가 원장에 없는 단지는 판정 불가라 빠지고 그 건수를 meta.price_year_scope에 싣는다. 연한은 재건축 자격의 하나일 뿐 | |
| limit | integer | no | 단지 수 — 평형별 시세가 포함돼 응답이 무겁다. 최대 20이고 더 받으려면 limit을 올리지 말고 page를 넘겨 이어 받아라(응답의 total이 전체 건수다 — 다만 서버가 지역 토큰을 뒤에서 검증한 경로에서는 total이 null이고 meta.total_unavailable이 사유를 적는다. 그리고 **sort='unit_price'로 받은 |
| page | integer | no | 0부터 시작하는 페이지 번호 |
| period_months | no | 가격 집계 기간(개월). 비우면 2024-01 이후 전체 (허용 범위 1~24) |
특정 단지·특정 평형의 최근 6개월 매매 실거래를 건별(계약일·층·가격)로 조회한다. 평형별 시세 요약만 필요하면 realty_search_complexes의 prices_by_area로 충분하다. 응답에는 층 밴드별 시세 집계 price_by_floor_band(저층~초고층 밴드별 평균가·건수· 최저 밴드 대비 프리미엄 %)가 함께 온다 — "저층 사면 손해야?", "고층 프리미엄 얼마야?"류 층별 시세 질문은 이 도구가 담당이다(층 밴드 축은 다른 도구에 없다). transactions는 계약일 내림차순이고, average_price·median_price는 그 정렬 기준 최근 5건(summary_basis에 그 5건을 그대로
| Parameter | Type | Required | Notes |
|---|---|---|---|
| complex_name | no | 단지명 (예: 마포래미안푸르지오2단지). complex_key를 주면 생략해도 된다 | |
| pyeong_supply | no | 분양평수(공급면적, 평) — 사용자가 말하는 '34평'이 보통 이것이다. ㎡로 말했으면 여기가 아니라 area_m2_supply를 쓰라 (허용 범위 0 초과~400) | |
| pyeong_exclusive | no | 전용면적 기준 실평수(평) — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. 사용자가 ㎡로 말했으면 area_m2_exclusive를 쓰라 — ㎡ 값을 여기 넣으면 서버가 조용히 환산하지 않고 사유를 대고 거절한다(1평=3.3058㎡) (허용 범위 0 초과~400) | |
| area_m2_exclusive | no | 전용면적을 ㎡ 그대로 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 (허용 범위 0 초과~500) | |
| area_m2_supply | no | 공급(분양)면적을 ㎡ 그대로 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 (허용 범위 0 초과~800) | |
| region | no | 동명 단지 구분용 시군구명 (예: 마포구) | |
| quoted_price_10k | no | 사용자가 들은 가격(호가·중개사 제시가·매물 가격, 만원). 주면 실거래 분포와 대조해 quote_check로 돌려준다. 이 서버는 호가 데이터가 없다 — 실거래(MOLIT)뿐이라 '호가가 비싸다/싸다'를 판정하는 게 아니라 실거래 어디쯤인지 위치만 알려준다. 사용자가 가격을 말했는데 이 인자를 안 주면 모델이 그 값을 검증 없이 | |
| quoted_prices_10k | no | 사용자가 매물 목록에서 복사·다운로드해 온 호가 여러 개(만원 배열). 값이 2개 이상이면 단일 대조 대신 호가 분포 ↔ 실거래 분포를 비교한다(중위 대 중위, 두 구간이 겹치는지). 호가는 사용자가 가져온 것이라 서버는 출처·수집시점·중복 매물 여부를 모른다 — 그 한계도 함께 응답에 싣는다 | |
| limit | integer | no | 개별 거래 내역 수 (허용 범위 1~50) |
| complex_key | no | 정확한 단지 키 — realty_search_complexes·complex_ambiguous 후보가 돌려주는 complex_key. 주면 이름·지역보다 우선한다. 같은 동에 같은 이름의 다른 단지(키 끝 '(1995)' 등)는 이름으로는 못 가르므로 이 인자로만 부를 수 있다 | |
| compare | no | 단지 2~5개(complex_key·단지명 배열)를 같은 면적으로 나란히 — 면적 필수. 행마다 실제 면적 범위·거래 수가 다르니 함께 전하라. 단지 간 평균·순위는 없다. 단지 수만큼 한도를 쓴다 | |
| since | no | 이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에 | |
| question | string | no | (선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라 |
단지의 평형별 전세 보증금·월세 중앙값을 조회한다. 전세가율(전세÷매매) 계산의 전세 축이다. complex_key·complex_name 중 하나는 필수. 부분일치는 동명 단지가 섞일 수 있으니 가능하면 realty_search_complexes로 complex_key를 먼저 특정하라. 행 키 supply_pyeong은 분양평(전용㎡ ÷ 3.305 ÷ 0.745 반올림) 기준이다.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| complex_key | no | 정확한 단지 키 — realty_search_complexes가 돌려주는 complex_key | |
| complex_name | no | 키를 모를 때 단지명 부분일치 | |
| region | no | 동명 단지를 가르는 지역 — 시군구나 동까지(예: '강동구', '방화동'). complex_ambiguous가 돌아오면 이 인자로 좁혀 다시 부르라 | |
| compare_sale | boolean | no | 같은 12개월 창의 매매가를 함께 뽑아 전세가율·전월세 전환율·갭을 계산한다(기본 켬). 종전엔 note가 '매매를 period_months=12로 따로 불러 나눠라'라고만 지시해 호출자가 손으로 했고, 창을 안 맞추면 전세가율이 수 %p 왜곡됐다 — 그 계산을 서버가 진다 |
지역의 매매 시세를 평형대 4구간(소형/중소형/중형/대형, 전용면적 기준)으로 조회한다. "○○구에서 무슨 평수대가 얼마쯤 해?"류 질문용 — 특정 단지는 realty_search_complexes를 쓰라. 이 축의 자리(시세 도구 3종 중): 지역의 가격 수준 비교는 이게 기본값이다. 이상치 필터(계약해제 제외 + 직거래 중 같은 평형대 중개거래 중앙값의 50% 미만만 제외)가 적용돼 realty_region_price_stats의 미필터 평균과 값이 다르며, 수준이 갈리면 이쪽을 우선하라. 월별 추이가 필요하면 region_price_stats, 단지가 특정되면 search_complexes. 구간 라벨의 평수는 *
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | string | yes | 시군구명 (예: 마포구). 법정동까지 넣어도 된다(예: '마포구 아현동') — 구 하나로 뭉치면 신도심·구도심이 한 값이 된다 |
| period_months | integer | no | 집계 기간(개월) (허용 범위 1~24) |
| by_dong | boolean | no | 법정동 × 평형대 중앙값을 함께 낸다. '이 구에서 어디가 싼가'류 질문의 자리다 — 실측(마포구 6개월, 전용 60~84㎡): 서교동 6.8억 ~ 용강동 27.1억으로 한 구 안에서 4배 갈린다. 표본 3건 이상 칸만 나온다 |
빌라·오피스텔·단독주택·토지의 매매 실거래가를 조회한다(아파트는 이 도구가 아니다). 아파트는 이 도구가 아니다. 빌라(다세대·연립)·오피스텔·단독주택·토지 전용 실거래 매매가 조회다 — 응답 = 최근 거래(recent) + 집계(stats: 표본 수·가격·상위 구성). 질문에 '아파트'가 있으면 여기서 멈추고 아파트 축으로 가라 — 지역·법정동 월별 추이는 realty_region_price_stats, 단지·평형별 시세는 realty_search_complexes, 단지 평형의 건별 내역(계약일·층·가격)은 realty_complex_pyeong_price다. 셋 다 region에 '강남구 대치동'처럼 법정동을 그대로 받는다 —
| Parameter | Type | Required | Notes |
|---|---|---|---|
| property_type | string | yes | villa=다세대·연립(빌라), officetel=오피스텔, house=단독·다가구, land=토지. 이 네 값에 아파트는 없다 — 사용자가 아파트를 물었으면 아무 값이나 고르지 말고 이 도구를 부르지 마라(realty_search_complexes·realty_region_price_stats가 그 자리다). 2026-08-23 실측: '강남구 대 |
| region | string | yes | 지역명 부분일치 (예: 관악구, 서울특별시 강남구, 강남구 역삼동). 법정동까지 되는 것은 이 도구만이 아니다 — 아파트 축의 realty_region_price_stats·realty_search_complexes도 '강남구 대치동'을 그대로 받는다. 동 단위로 좁히려고 이 도구를 고르지 마라 |
| price_min | no | 최소 매매가(만원) | |
| price_max | no | 최대 매매가(만원) | |
| limit | integer | no | 최근 거래 행 수 (허용 범위 1~30) |
| area_band | no | 전용면적대로 좁힌다(빌라·오피스텔만 — 단독주택은 전용면적 개념이 없다). 비아파트는 같은 동네에서도 면적 편차가 커서 지역 평균 하나로는 답이 안 된다. 안 넣어도 stats.by_area_band로 밴드별 분포가 온다 |
단지 입지를 원시값으로 답한다 — "역세권이야? 학군 어때? 병원 가까워?" 담당. 답은 행마다 맨 앞의 location_facts로 하라: 최근접 지하철역 이름·노선·직선거리(m, 상한 없음 — 시골 단지는 30km도 그대로 나온다), 반경 500m·1km 안 역·버스 정류장 수, 1km 안 초·중·고 수와 최근접 초등학교 거리, 반경 안 병원(전 의료기관·병원급 분해)·마트 수. 전부 poi 원장에서 직접 센 값이라 재현할 수 있다. "역세권이야?"는 subway.nearest_distance_m와 walk_band로, "초품아야?"는 schools.nearest_elementary로 답하라. 같은 행의 transit_score·school_s
| Parameter | Type | Required | Notes |
|---|---|---|---|
| complex_key | no | 정확한 단지 키 — realty_search_complexes가 돌려주는 complex_key | |
| complex_name | no | 단지명 일부 (부분일치) | |
| region | no | 지역명 — 단독이면 지역 집계+상위 단지, complex_name과 함께면 검색 범위 |
아파트 청약(분양) 공고를 조회한다 — 분양가·청약 접수 일정·당첨자 발표일·입주 예정·위치. "다음 달 청약 넣을 만한 데 있어?", "○○에 분양하는 아파트 있어?"류 질문용. "오늘/지금 접수 가능한 청약"은 status='접수중'이다. upcoming=true는 접수 시작 전만 주므로 그 질문에 쓰면 정확히 오늘 못 넣는 공고들을 받는다. 행마다 오늘 기준 판정 apply_status(접수중/접수예정/접수마감/일정미상)와 apply_status_text가 붙고, 그 기준일은 meta.today다 — 날짜를 직접 비교해 상태를 다시 판정하지 말고 이 값을 그대로 전하라. "넣을 만해?/적정가야?"까지 물으면 이어서 real
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도 (예: 서울, 경기, 세종, 부산) | |
| sigungu | no | 시군구 정확한 이름 (예: 수원시, 강남구). ⚠️세종은 이 필드가 동·생활권·도로명으로 오염돼 있으니 쓰지 말고 keyword를 쓰라 | |
| keyword | no | 단지명·공급 주소 부분일치 (예: '우미린', '5-2생활권', '다솜동') — 생활권·동 단위 질의는 이걸로 | |
| status | string | no | 오늘(KST) 기준 접수 상태로 거른다. '오늘/지금 접수 가능한', '지금 넣을 수 있는' 질문은 '접수중'이다 — '접수예정'은 아직 못 넣는 것들이다. '다음 달 청약'처럼 앞으로를 묻는 질문만 '접수예정'. 기본 '전체'. |
| upcoming | boolean | no | ⚠️True면 접수 시작 전(시작일이 오늘 이후) 공고만 — 오늘 접수 가능한 공고는 여기 없다. 오늘 넣을 수 있는 것을 찾는다면 status='접수중'을 써라. status와 함께 쓰지 말 것(status가 이것을 대체한다). |
| notice_kind | string | no | 공고 종류. 기본 '본공고'. 무순위(줍줍)·재공급을 물으면 그 값 — status 기본은 접수중+접수예정이고, '접수마감'이면 목록 대신 단지별 회차 이력 집계(몇 번 나왔나). |
| limit | integer | no | 공고 수 — 주택형별 분양가·순위별 일정이 붙어 행이 무겁다. 요청분을 다 실으면 응답이 크기 상한을 넘는 경우 실제 반환 수를 줄이고 meta.size_capped에 총계·좁혀 부르는 법을 값으로 싣는다 — 조용히 자르지 않는다 (허용 범위 1~50) |
| since | no | 이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에 | |
| question | string | no | (선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라 |
같은 지역 분양 공고들의 연도별 평당 분양가 추이를 낸다. 같은 지역 분양 공고들의 연도별 평당 분양가 추이를 낸다 — "지금 넣을까, 기다릴까"에서 기다림의 비용(다음 공고가 얼마에 나올까)을 정량화하는 축이다. 재당첨 제한이 걸린 결정(분양가상한제 10년 등)에서 특히 판단을 가른다. 기준(답변에 그대로 전달): 공급면적(분양평) 평당 최고 분양가(만원/평), 발코니 확장·유상옵션 미포함. 연도별 주택형 믹스가 다르면 중앙값이 흔들린다 — announcements가 1~2건인 연도는 추이로 읽지 말고, 평형대를 고정하려면 exclusive_m2_min/max(국평=80~85)를 써라. 이 축의 자리: 개별 공고의 적정성(
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도 (예: 서울, 경기, 세종) | |
| sigungu | no | 시군구 정확한 이름 (예: 평택시). ⚠️세종은 오염돼 있으니 keyword를 쓰라 | |
| keyword | no | 단지명·공급 주소 부분일치 (예: '고덕', '동탄') — 동네·지구 단위 추이는 이걸로 | |
| exclusive_m2_min | no | 전용면적 하한(㎡) — 국평만 보려면 80 | |
| exclusive_m2_max | no | 전용면적 상한(㎡) — 국평만 보려면 85 |
청약(분양) 공고의 분양가가 주변 실거래 시세 대비 싼지/비싼지를 주택형별로 계산한다. "이 청약 넣을 만해?", "분양가 적정해?"류 질문의 정량 근거 — 웹검색으로는 못 하는 분양가×실거래 조인 계산이 이 도구의 존재 이유다. 공고 특정: house_manage_no가 없으면 region+keyword로 검색하고, 여러 건이면 후보 목록을 돌려주니 하나를 골라 다시 호출하라(추측해서 고르지 않는다). 기준선: 평형 행의 gap_pct는 gap_basis가 말하는 기준 대비다 — 인근 비교단지가 충분하면 공고 좌표 반경·준공 연도 조건·같은 평형대 비교군(nearby_baseline) 대비이고, 아니면 지역(공고 시군구, 없으면 시도) 실거래 평균
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도 (예: 서울, 경기, 세종) | |
| keyword | no | 단지명·주소 부분일치 (예: '우미린', '5-2생활권', '다솜동') | |
| house_manage_no | no | realty_presale 응답의 공고 관리번호 — 알면 이걸로 특정하는 게 정확 | |
| months | integer | no | 실거래 비교 창(개월) (허용 범위 3~24) |
| pyeong | no | 대조할 전용평(정수)을 직접 고른다 — 예: [26]이면 국민평형 84㎡만. 안 주면 세대수 많은 순 상위 5개 평형을 자동으로 고른다. comparison_truncated에 빠졌다고 적힌 평형은 이 인자로 되받아 부르면 된다(공시만 하고 길이 없으면 막다른 골목이다) |
입주자모집공고 원문에서 추출·검증한 팩트시트를 항목별로 준다. 입주자모집공고 원문에서 추출·검증한 팩트시트 — 전매제한·재당첨제한·거주의무· 거주요건, 청약 일정, 층별 분양가표(대지비·건축비·회차별 납부액), 특별공급 배정, 발코니 확장·유상옵션 가격, 중도금 회차 일정, 예비입주자 규칙. 전매제한 기간, 재당첨 제한, 거주의무, 특별공급 자격·배정, 층/타입별 분양가, 발코니 확장비·유상옵션 금액, 중도금 회차와 납부일 — 이 값들을 묻는 질문이 이 도구의 자리다(추정하거나 웹에서 찾을 필요 없이 공고 원문 값이 나온다). 모든 값에 공고 쪽 번호(p)가 붙으니 답변에 notice_version(공고 판본)과 쪽 번호를 함께 제시하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| house_manage_no | no | 공고 관리번호 (realty_presale 응답의 house_manage_no) | |
| keyword | no | 단지명 일부 (예: '우미린' — 공백 무관 매칭) | |
| section | no | 팩트시트의 한 절만 전문으로 받는다 (예: '분양가층별', '유상옵션', '전매재당첨', '공고개요' — 절 이름은 공고 판본마다 다르니 모르면 비우고 응답의 절 목록을 보라. '공급'은 한 절이 아니라 공고개요·분양가층별 등에 나뉘어 있다). 비우면 전체 — 다만 전체가 도구 결과 한계를 넘으면 큰 절부터 떼어 내고 뗀 절 이름을 meta.omitted_ |
입주자모집공고문 원문을 쪽 단위로 읽어 준다. 입주자모집공고문 원문을 쪽 단위로 읽는다 — 팩트시트에 없는 세부(특별공급 소득·자산 기준, 부적격 처리, 계약 유의사항, 옵션 품목 상세)는 이 도구로 원문을 직접 확인하라. 표가 있는 쪽은 pdftotext 특성상 정렬이 깨질 수 있다 — 열 해석이 애매하면 단정하지 말 것. 여러 낱말은 AND로 묶인다('가점제 추첨제'→둘 다 있는 쪽). 0쪽이면 막다르지 않고 낱말별 히트 쪽과 부분일치 상위 쪽을 함께 돌려주니 그걸로 좁혀라(match='any'로 넓힐 수도 있다). 쪽을 모를 땐 pages_only=true로 먼저 훑어라 — 전문은 한 번에 수만 자다. 전문 응답은 최대 6쪽이고, meta.m
| Parameter | Type | Required | Notes |
|---|---|---|---|
| house_manage_no | string | yes | 공고 관리번호 (realty_presale·realty_notice_facts로 특정) |
| query | no | 찾을 키워드. 공백으로 나눈 낱말을 모두 포함하는 쪽을 찾는다(AND, 공백 무관 매칭) — 예 '가점제 추첨제', '신혼부부 소득' | |
| pages | no | 쪽 범위 직접 지정 (예: '1-3', '44'). query와 택일이며 함께 주면 거절한다(error='query_and_pages_conflict') — 종전엔 query를 조용히 버렸다. pages와 함께 준 pages_only는 무의미하므로 무시하고 meta.pages_only_ignored로 실토한다 | |
| match | string | no | 여러 낱말 처리 — all=모두 포함(기본), any=하나라도 포함(넓게 훑을 때) |
| pages_only | boolean | no | 참이면 본문 없이 일치 쪽 번호+발췌만 준다 — 먼저 이걸로 쪽을 고르고 pages로 좁혀 재호출하면 왕복·토큰이 크게 준다 |
이 분양 공고를 같은 시군구·같은 평형의 다른 공고들과 5축으로 견준다. 이 분양 공고를 같은 시군구·같은 평형 공고들과 견줘 읽는다 — 청약홈 API에 없고 공고문 원문에만 있는 5축으로: ①대지비 비중(분양가에서 땅값이 얼마인가) ②유상옵션 (사실상 필수인 발코니확장 절대금액) ③중도금 무이자 여부와 회차 ④층 프리미엄(최저 층구간 대비 최상 층구간) ⑤㎡당 분양가(전용면적 기준). "이 분양가가 비싼가"는 실거래 대조만으로는 반쪽이다 — 같은 값이라도 대지비 비중이 70%인 공고와 25%인 공고는 다른 물건이고, 발코니확장 3천만원은 광고 분양가에 안 잡힌다. 공고를 지정하면 그 공고의 5축 값과 **분포에서의 위치(percentile
| Parameter | Type | Required | Notes |
|---|---|---|---|
| house_manage_no | no | 공고 관리번호 (realty_presale·realty_notice_facts 응답의 house_manage_no, 예 '2026000383') | |
| keyword | no | 단지명 일부 (예: '우미린' — 공백 무관 매칭). house_manage_no와 택일이며 여럿이면 후보 목록을 돌려준다 | |
| sigungu | no | 시군구를 원장 어휘 그대로 (예: '천안시 서북구', '평택시', '서울 동작구' — 특별·광역시는 '서울 동작구'처럼 시도 접두가 붙는다). 공고를 지정하지 않고 그 지역 분포만 볼 때 쓴다 | |
| region | no | 시도 (예: 경기, 서울, 경남). 시도 분포는 배경일 뿐 결론 근거가 아니다(D-2026W33-40) — 결론은 시군구·평형대 셀에서 읽어라 | |
| exclusive_m2_min | no | 전용면적 하한(㎡) — 국평만 보려면 80. 지정하면 모든 셀에 같은 필터가 걸린다 | |
| exclusive_m2_max | no | 전용면적 상한(㎡) — 국평만 보려면 85 |
이 아파트를 벽·배관 기준으로 고칠 수 있는지 판단할 재료를 준다. "이 아파트를 내가 원하는 대로 고칠 수 있나"에 답하는 자리 — 두 축이다: ①벽(내력벽을 헐어 방을 틀 수 있나) ②배관(층상/층하 — 욕실·주방을 옮길 수 있나). "벽식구조면 리모델링 못 하죠?"·"내력벽 철거 2016년에 허용되지 않았나요?"·"욕실 위치 바꿀 수 있나요?"·"인테리어 하는데 구청 가야 하나요?"가 이 도구의 질문이다. 모델이 학습 데이터로 자신 있게 틀리는 자리라 조문 원문을 값으로 준다 — 통설 둘("2016년 유예로 내력벽 철거 허용", "벽식=개인 리모델링 불가")이 둘 다 틀렸고, 이 도구가 그것을 조문으로 깬다.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| complex_name | no | 단지·공고명 일부 (공백 무관 매칭). 없어도 된다 — 비우면 법령 규범 층만 답한다(그것만으로도 통설 오답을 막는다) | |
| house_manage_no | no | 공고 관리번호 (realty_presale·realty_notice_facts 응답의 house_manage_no) | |
| axis | string | no | both=벽+배관(기본), wall=내력벽·평면 변경만, plumbing=상하수도·욕실 이동만 |
단지에 종속되지 않는 일반 규범(세율·규제·대출·임대차)을 근거 조문과 함께 준다. 근거 조문·확인일이 붙는다 — 취득세율표, 규제지역 현재 지정 현황, 주담대 규제 원표, 개인회생×대출, 주택임대차 갱신(갱신권· 5% 상한·매수인 실거주 거절), 양도세(세율·필요경비·중과·개편 계류), 청약통장·가점 배점표, 정비구역 요건·조합원 지위양도, 재개발 분양자격 갈림길(서울). "취득세 얼마야?", "갱신권 썼는데 집주인이 팔면?", "지금 팔면 중과야?"류 질문의 자리다. 특정 조건의 상한 계산은 realty_loan_limit, 가점 점수 계산은 realty_subscription_score, 비례율·분담금 계산은 realty_redevelo
| Parameter | Type | Required | Notes |
|---|---|---|---|
| topic | string | no | 어느 표를 볼지 고른다 — 사용자가 쓰는 말로 찾아라. axes=상품별 차이·6·27이 뭐에 걸리나·DSR 6축·수도권/규제지역 축 | 횡단 사실의 진실원(6·27 상품별 적용·DSR 6축·수도권/규제지역·세대/인별/물건 기준 충돌). '어느 상품이 뭐가 다른가'류는 여기부터 — 상품 토픽과 어긋나면 이 표가 맞다, acquisition_ta |
| section | no | 토픽의 하위 항목만 골라 받는다 — 미지정이면 종전과 같이 토픽 전체가 온다. 큰 토픽(auction_rights·unit_alteration_rules·loan_rules)에서 필요한 축만 집을 때 쓴다. 예: topic='auction_rights', section='assumed_regardless_of_rank' → 순위 무관 인수(유치권·법 | |
| query | no | 자유문으로 토픽을 찾는다 — 어느 topic인지 모를 때 사용자 말을 그대로 넣어라(예: '종부세 얼마부터 내요'→topic='comprehensive_real_estate_tax', '부모님이 보태주는 돈'→topic='gift_tax_and_funding_source', '전입은 빠른데 확정일자가 늦으면'→topic='auction_rights' |
소액임차인 최우선변제의 금액표를 고르는 도구다 — 판정기가 아니다. "전입은 근저당보다 빠르고 확정일자는 늦으면?"처럼 임차인 한 사람의 날짜들(전입· 확정일자·근저당)로 대항력·우선변제·최우선변제를 묻는 질문은 여기서 시작하라 — 근저당 날짜로 금액표를 고르고 not_a_conclusion이 남은 요건을 적는다. 두 권리의 요건 원문은 realty_policy_rules(topic=auction_rights)가 함께 준다. "최우선변제금 얼마까지 나와요?"에 현행표를 읊으면 틀린다. 적용되는 표는 최선순위 담보물권을 취득한 날이 속한 시행령 판이고(부칙 경과조치), 2008-08-21 이후 7개 판이 서로 다르다. 2015년 근
| Parameter | Type | Required | Notes |
|---|---|---|---|
| security_right_date | no | 최선순위 담보물권(근저당 등)의 설정일 YYYY-MM-DD. 금액표를 고르는 기준일이다 — '오늘'도 '임대차계약일'도 아니다(각 개정 시행령 부칙 경과조치: '이 영 시행 전에 임차주택에 대하여 담보물권을 취득한 자에 대해서는 종전의 규정에 따른다'). 등기부 을구에서 확인한다. 모르면 비워 두라 — 서버가 현행표를 답인 척 주지 않는다. | |
| security_right_year | no | 최선순위 담보물권 설정 '연도'만 알 때 쓴다(예: 2019). 사용자가 연도만 말했을 때 security_right_date에 임의의 날짜를 지어 넣는 대신 여기에 연도를 그대로 넣어라 — 그 해 전체가 한 시행령 판 안에 있으면 월·일 없이도 표가 정해지고(응답이 그 근거를 밝힌다), 판이 갈리는 해면 표를 고르지 않고 등기 접수일을 되묻는다 ( | |
| region | no | 물건 소재지. '서울', '경기도 부천시', '부산광역시 기장군'처럼 시도를 붙이면 확실하다. 비우면 그 판의 전 구간 표를 그대로 준다 | |
| deposit_10k | no | 임차보증금(만원). 주면 그 판의 '소액임차인 범위' 상한과 대조해 범위에 드는지의 산수만 한다 — 최우선변제를 받는다는 판정이 아니다 |
내 조건에서 쓸 수 있는 대출 상품을 상품별로 나란히 판정한다. "내 조건이면 어떤 대출을 쓸 수 있나"를 상품별로 나란히 낸다 — 사용자가 어느 규칙 토픽을 물어야 할지 몰라도 되게 하는 라우터다. 이 도구가 존재하는 이유: 대출 규칙이 상품별 토픽 7곳에 흩어져 있어서, 지금까지는 호출자가 어느 토픽을 물어야 할지 알아야 했다(2026-08-14). 용도·지역·주택수만 주면 쓸 수 있는 상품과 못 쓰는 이유를 함께 낸다. 경계: ① 주택 수·생애최초·신혼은 선언이다(서버가 사실판정하지 않는다) ② 한도 금액을 계산하는 건 구입 목적의 은행권뿐이고 그건 realty_loan_limit이 한다 — 이 도구는 **자격
| Parameter | Type | Required | Notes |
|---|---|---|---|
| purpose | string | yes | 자금 용도 — 같은 담보라도 용도가 규제를 가른다(구입=LTV·가액구간 한도, 생활안정=1억 한도·다주택 금지, 전세반환=세입자에게 보증금 돌려주는 목적(퇴거자금) — 원칙 1억이지만 6·27 이전 계약분 경과조치가 붙는 유일한 축, 전세=세입자로 들어갈 때 쓰는 전세자금대출, 중도금=집단대출). ⚠️ **'전세'와 '전세반환'을 섞지 마라* |
| region | no | 소재지(시군구까지, 예: '서울 마포구'·'세종특별자치시') — 수도권·규제지역 판정에 쓴다 | |
| homes_owned | no | 세대 기준 보유 주택 수(선언) — 0=무주택, 1, 2+=다주택. 명의가 갈려도 세대로 센다. 서버는 주택 수를 판정하지 않는다 (허용 범위 0~9) | |
| annual_income_10k | no | 부부합산 연소득(만원) — 정책상품 소득요건 대조에 쓴다 | |
| house_price_10k | no | 대상 주택 가격(만원) — 정책상품 가격요건 대조에 쓴다 | |
| is_first_time | no | 생애최초 해당 여부(선언 — 서버는 판정하지 않는다) | |
| is_newlywed | no | 신혼 해당 여부(선언) | |
| total_assets_10k | no | 순자산(만원, 자산−부채 — 부채가 더 많으면 음수) — 버팀목·디딤돌 자산 요건은 순자산가액 기준이다. 버팀목 전세는 자산 요건이 핵심 관문이라 전세 문의면 받아라 |
선언한 조건으로 주택담보대출 규제 상한을 결정론으로 계산한다. 선언된 조건(지역·시가·차주 유형·소득)에 대해 주담대 규제 상한을 결정론으로 계산한다 — LTV 상한액, 수도권·규제지역 가액구간 한도(6/4/2억), 만기 상한(30년), 스트레스 DSR 반영 최대 대출액과 어느 규제가 최종 상한인지(binding). "10억 집, 생애최초, 연소득 8천이면 얼마까지 나와?"류 질문의 자리다. 경계를 지켜라: ① 차주 유형은 선언이다 — 생애최초·주택 수 해당 여부는 사실판단이라 서버가 판정하지 않는다(응답 inputs_declared가 그 선언을 에코한다). ② 결과는 규제 상한이지 대출 승인·확약이 아니다 — 은행 심사(소득
| Parameter | Type | Required | Notes |
|---|---|---|---|
| house_price_10k | integer | yes | 주택 시가(만원 단위, 예: 100000=10억). 가액구간 한도가 '시가' 기준이라 분양가·공시가가 아닌 시세를 넣는다 |
| borrower | string | yes | 차주 유형 — 사용자 선언이다(서버는 생애최초·주택 수를 판정하지 않는다). 생애최초=본인·배우자 모두 주택 소유 이력 없음, 1주택_처분조건부=6개월 내 기존주택 처분 약정, 서민실수요=우대 요건 충족을 선언한 경우 |
| region | no | 주택 소재지(시군구까지, 예: '서울 마포구'·'성남시 분당구'·'부산 해운대구'). 규제지역·수도권 판정에 쓴다. 해석이 모호하면 후보를 돌려주니 is_regulated·is_metro로 직접 선언해도 된다 | |
| is_regulated | no | 규제지역(투기과열·조정대상) 여부 직접 선언 — region 대신/우선 적용 | |
| is_metro | no | 수도권(서울·경기·인천) 여부 직접 선언 — region 대신/우선 적용 | |
| annual_income_10k | no | 연소득(만원) — interest_rate_pct와 함께 주면 DSR 상한 대출액까지 계산 | |
| existing_annual_debt_payment_10k | integer | no | 기존 대출의 연간 원리금 상환액 합계(만원) — DSR 계산에서 차감 |
| loan_term_years | integer | no | 희망 만기(년). 수도권·규제지역은 30년 상한으로 조정되며 조정 사실을 응답에 싣는다 (허용 범위 1~50) |
| interest_rate_pct | no | 약정금리 가정(%, 예: 4.2) — DSR 계산에 필요. 없으면 DSR 금액 계산은 생략된다 (허용 범위 0 초과~20) | |
| lender | string | no | 업권 — DSR 한도가 은행 40% / 제2금융권 50%로 갈린다 |
| rate_type | string | no | 주담대 금리유형 — 스트레스 금리 적용비율이 갈리는 축이다(변동 100%, 혼합형·주기형은 고정기간 비중별 차등, 순수고정 미적용). 기본값 '변동'은 최악 가정이라 한도가 가장 작게 나온다. 사용자가 상품을 안 정했으면 응답의 by_rate_type 비교표를 함께 전하라. 혼합형=고정기간 후 변동, 주기형=N년 주기로 금리 재산정, 순수고정=만기까 |
| rate_fixed_years | no | 혼합형의 고정금리 기간 또는 주기형의 금리변동주기(년). 미지정이면 시중은행 통상인 5년으로 가정하고 가정 사실을 응답에 싣는다. 변동·순수고정에는 무의미 (허용 범위 0~50) | |
| credit_loan_10k | no | 신용대출 잔액 또는 받을 예정액(만원). 직접 연 원리금을 계산해 넣지 마라 — 산정만기 5년 강제·산식 두 갈래·스트레스 1억 문턱이 전부 함정이라 서버가 계산한다. existing_annual_debt_payment_10k와 함께 주면 둘 다 합산한다 | |
| credit_loan_rate_pct | no | 신용대출 약정금리(%) — credit_loan_10k를 줬으면 필수다(이자 없이는 원리금을 못 낸다) (허용 범위 0 초과~20) | |
| stress_stage | string | no | 스트레스 금리 단계 가정. 기본 '현행'. 지방(비수도권 비규제) 주담대만 갈린다 — 지방은 2026-12-31까지 한시 2단계(0.75%p)이고 이후 연장 여부는 미정이다. '3단계'를 주면 유예가 끝나 3단계(1.5%p×적용비율 3단계)가 그대로 적용되는 가정으로 계산한다. 수도권·규제지역은 이미 3단계라 값이 같다 |
| desired_loan_10k | no | 받으려는 주담대 금액(만원). 주면 '이만큼 되나'를 판정하고, DSR에 막히면 무엇을 얼마나 바꾸면 들어가는지(금리유형·만기·신용대출 축소·금리)를 함께 낸다. '4억 받으려는데 되나요'류 질문의 자리 — 최대치만 받아 모델이 역산하게 두지 마라. credit_loan_rate_pct를 함께 주면 **이 주담대를 먼저 받은 뒤 남는 신용대출 추가 |
민영주택 일반공급 청약 가점(만점 84)을 배점표로 계산한다. 민영주택 일반공급 가점제 점수(만점 84)를 선언된 값에 배점표를 적용해 계산한다 — 무주택기간 32 + 부양가족 35 + 통장 가입기간 17. "내 청약 가점 몇 점이야?"의 자리다. 경계를 지켜라: ① 세 입력 전부 선언이다 — 기산점·부양가족 인정은 등본·혼인관계 사실판단이라 서버가 판정하지 않고, 응답 traps(오기입=부적격 당첨 취소 사유)를 반드시 함께 전하라. ② 산출 점수는 realty_subscription_odds의 my_score로 넘겨 당첨 커트라인과 비교하는 것이 다음 수다. ③ 배점표 원문·기산 규칙은 realty_policy_rules(topic=su
| Parameter | Type | Required | Notes |
|---|---|---|---|
| no_house_years | number | yes | 무주택기간(년, 소수 허용 — 예: 7.5). 기산점(만 30세 vs 혼인신고일, 유주택 이력 재기산)은 사실판단이라 호출자가 확정해 선언한다 — 응답의 traps를 함께 전하라 (허용 범위 0~60) |
| dependents_count | integer | yes | 부양가족 수(본인 제외). 직계존속 3년 동거·30세 이상 미혼자녀 1년 동거 등 인정 요건은 사실판단 — 확정해 선언한다 (허용 범위 0~20) |
| account_years | number | yes | 청약통장 가입기간(년, 소수 허용 — 예: 0.4=약 5개월). 전환 통장은 종전 통장 최초 가입일 기준 (허용 범위 0~60) |
| is_homeowner | boolean | no | 현재 유주택 여부 — True면 무주택기간 점수가 0점이 된다(소형·저가주택 등 무주택 간주 예외 해당 여부는 사실판단이라 호출자가 반영해 선언) |
| under30_unmarried | boolean | no | 만 30세 미만 미혼 여부 — True면 무주택기간 점수가 0점이 된다(무주택기간 기산 전) |
재개발·재건축 조합원의 권리가액과 추가 분담금을 계산한다. 재개발·재건축 조합원의 권리가액과 추가 분담금(또는 환급금)을 결정론으로 계산한다 — 권리가액 = 종전자산 감정평가액 × 비례율, 분담금 = 조합원분양가 − 권리가액. "감정평가 3억에 비례율 98%면 얼마 더 내?"의 자리다. 경계를 지켜라: ① 입력 전부 선언이다 — 감정평가액·비례율은 조합 자료에서 가져와야 하고 서버는 검증하지 않는다. ② 이 산식은 법정 산식이 아니라 통용 실무 산식이며, 비례율은 관리처분인가 전엔 추정치라 준공까지 계속 변한다 — 응답의 sensitivity(비례율 ±10%p 스윙)와 disclosures를 반드시 함께 전하라. ③ 산식 출처·변동 함정의 원문은
| Parameter | Type | Required | Notes |
|---|---|---|---|
| prev_asset_value_10k | integer | yes | 조합원 종전자산 감정평가액(만원) — 감정평가 결과이지 시세가 아니다 |
| member_sale_price_10k | integer | yes | 받으려는 주택형의 조합원분양가(만원) |
| proportion_rate_pct | no | 비례율(%, 예: 102.5) — 조합 총회 자료·관리처분계획의 값을 선언. 없으면 아래 사업 전체 3종으로 계산한다 (허용 범위 0 초과~300) | |
| total_post_asset_10k | no | 종후자산 평가총액=분양수입 총액(만원) — 비례율을 직접 계산할 때 | |
| total_project_cost_10k | no | 총사업비(만원) — 비례율을 직접 계산할 때 | |
| total_prev_asset_10k | no | 종전자산 평가총액(만원) — 비례율을 직접 계산할 때 |
선언된 양도가·취득가·필요경비·보유기간에 양도소득세 세율표를 결정론으로 적용한다 — 기본·단기·분양권 세율, 장특공제 표1, 기본공제, 다주택 중과(선언), 지방소득세 10%. 두 번째 자산을 주면 같은 해 합산 vs 연도분산 vs 차손통산을 비교해 어느 쪽이 유리한지 산출한다. "지금 팔면 양도세 얼마?"·"두 채를 올해 같이 팔까 나눠 팔까?"의 자리다. 경계를 지켜라: ① 입력 전부 선언이다 — 보유기간 기산·주택 수·조정대상지역 해당은 사실판단이라 서버가 판정하지 않는다. ② 1세대1주택 비과세·12억 초과 고가주택 안분· 감면 특례는 계산하지 않는다(not_curated) — 이 결과는 양도 전액이 과세된다는 전제다.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| transfer_price_10k | integer | yes | 양도가액(만원, 예: 90000=9억). 예정이면 예상 매도가를 선언 |
| acquisition_price_10k | integer | yes | 취득가액(만원). 증여받은 자산은 이월과세(10년)로 증여자 원취득가가 될 수 있다 — 응답 traps 확인 |
| holding_years | number | yes | 보유기간(년, 소수 허용 — 예: 1.5). 취득일~양도일이며 상속·증여 기산 특례는 사실판단이라 호출자가 확정해 선언한다 (허용 범위 0~100) |
| transfer_year | integer | yes | 양도(예정) 연도. 2027 이후는 계류 중인 세제개편안이 결과를 뒤집을 수 있어 응답에 실토가 붙는다. 2025 이전 과거 양도는 당시 규칙(중과 유예 등)이라 다루지 않는다 (허용 범위 2026~2035) |
| necessary_expenses_10k | integer | no | 필요경비 합계(만원) — 취득·양도 부대비용과 자본적 지출만. 도배·싱크대 같은 수익적 지출은 불인정이다(경계·증빙 요건은 topic=capital_gains_tax 원문) |
| asset_type | string | no | 자산 종류 — 단기세율·장특공제가 갈린다. 분양권은 보유 2년이 넘어도 60%다. 비사업용토지=기본세율+10%p(제104조①8호). 부동산취득권리=분양권·입주권 외 권리(관리처분인가 전 예비조합원 지위 등) — 장특 없음 |
| multi_home_surcharge | string | no | 다주택 중과 선언 — 양도 시점에 그 주택이 조정대상지역 안이고(현재 지정 현황은 topic=regulated_area) 세대 주택 수가 2/3+인 경우. 주택 수 판정(분양권·입주권 가산, 지방 저가주택 제외)은 사실판단이라 서버가 하지 않는다. 중과 대상인데 그 기간 취득이면 마지막 값=기본세율·장특 배제(소득세법 부칙 제14조) |
| share_pct | number | no | 본인 지분율(%, 공동명의면 예: 50). 양도세는 인별 과세라 본인 지분만 계산하고 기본공제 250만원도 각자 받는다 — 배우자 몫은 배우자 지분으로 따로 호출하라. 두 자산 모두에 같은 지분을 적용한다 (허용 범위 0 초과~100) |
| asset2_transfer_price_10k | no | 두 번째 자산의 양도가액(만원) — 주면 '올해 같이 팔기 vs 내년으로 나누기' 시나리오를 비교한다. asset2_acquisition_price_10k·asset2_holding_years와 함께 줘야 한다 | |
| asset2_acquisition_price_10k | no | 두 번째 자산의 취득가액(만원) | |
| asset2_holding_years | no | 두 번째 자산의 보유기간(년) — transfer_year 기준이다. 연도분산 시나리오는 이 자산을 다음 해에 파는 가정이라 서버가 보유기간을 +1년으로 다시 계산한다(응답 scenarios.split_years.asset2_recomputed에 실토) (허용 범위 0~100) | |
| asset2_expenses_10k | integer | no | 두 번째 자산의 필요경비(만원) |
| asset2_asset_type | string | no | 두 번째 자산의 종류 |
| asset2_multi_home_surcharge | string | no | 두 번째 자산의 중과 선언 — 첫 자산 매도 후 주택 수가 줄어 지위가 달라질 수 있다. 시나리오별 지위 변화도 선언 그대로 쓴다(서버는 판정하지 않는다) |
| rights_pre_approval_gain_10k | no | 원조합원 조합원입주권만: 관리처분인가 전 양도차익(만원, 종전 평가액−취득가−경비, 시행령 제166조①). 주면 장특 표1을 이 차익에만 적용(제95조②). 승계취득이면 주지 마라 | |
| rights_pre_approval_years | no | 위 입주권의 기존건물 취득일~관리처분인가일 기간(년) — 장특 보유기간(시행령 제166조⑤1) (허용 범위 0~100) |
투기과열지구 정비사업 물건을 지금 사면 조합원 지위를 승계받는지 판정한다. 투기과열지구에서 재건축·재개발 물건을 지금 사면 조합원 지위를 승계받을 수 있는지를 도시정비법 39조 2항으로 결정론 판정한다 — 투기과열지구 여부(regulated_area) × 사업 유형 × 진행 단계(서울은 정보몽땅 목록에서 자동 결합). "한남3구역 지금 사도 입주권 나와?"의 자리다. 경계를 지켜라: ① 판정은 원칙 제한 여부까지다 — 예외(양도인의 근무·질병·상속·해외이주, 10년 소유+5년 거주 등)는 양도인 사정의 사실판단이라 갈림길로만 주고, 사업지연 예외 3종은 인가일·착공일 데이터가 없어 판정 불가를 실토한다. ② 재개발엔 부칙 함정(2018-01
| Parameter | Type | Required | Notes |
|---|---|---|---|
| project_type | string | yes | 사업 유형 — 제한 개시 시점이 갈린다(재건축=조합설립인가 후, 재개발=관리처분인가 후). 가로주택·소규모재건축 등 소규모정비사업은 별도 법제라 이 도구가 판정하지 않는다 |
| region | no | 사업장 소재지(시군구까지, 예: '서울 용산구'·'성남시 수정구') — 투기과열지구 판정과 (서울이면) 단계 자동 조회에 쓴다. 모호하면 후보를 돌려주니 is_speculation_zone을 직접 선언해도 된다 | |
| is_speculation_zone | no | 투기과열지구 여부 직접 선언 — region 대신/우선 적용 | |
| project_name | no | 사업장·구역 이름(예: '한남3구역') — 서울이면 정비사업 목록에서 진행 단계를 자동으로 잇는다(유일 매치만). 서울 밖은 목록이 없어 project_stage 선언이 필요하다 | |
| project_stage | no | 진행 단계 직접 선언 — project_name 조회 대신/우선 적용. 허용값은 서울 정비사업 목록(정보몽땅)의 실측 어휘 전량이라, 자동 조회가 돌려준 stage를 그대로 다시 넣으면 같은 판정이 재현된다(예: '철거'·'철거 및 착공'·'추진위구성') | |
| first_approval_application_after_20180125 | no | 재개발 부칙 선언 — 이 구역의 최초 사업시행계획인가 신청이 2018-01-25(법률 제14943호 시행일) 이후인가. 이전이면 관리처분인가 후에도 지위양도가 가능하다(서울 22개 구역 실재). 모르면 비워두라 — 서버가 미확인으로 실토한다 |
분양 한 건의 층별 총 소요자금(분양가·발코니·중도금이자·취득세)을 계산한다. 공고 원문(팩트시트) 기반 결정론 계산: 층별 분양가 + 발코니 확장비 + 회차별 중도금 이자(일할) + 취득세(표준세율) = 층별 총 소요자금. "이 분양 실제로 얼마 드나"의 자리다 — 클라이언트마다 손계산하면 입주일 가정 하나로 백만원대가 갈린다(실측 124만원). 경계(신고 #43의 선 그대로): 여기까지가 "공고+세법에서 결정론적으로 나오는 것"이다. 월 상환액·매수 vs 전세 손익분기는 개인 파라미터가 지배하므로 계산하지 않는다 — 전세 시세는 realty_complex_rent_by_pyeong으로 받아 클라이언트가 개인 가정을 얹어라. 자기자금·차주 조건을
| Parameter | Type | Required | Notes |
|---|---|---|---|
| house_manage_no | no | 공고 관리번호 (realty_presale의 house_manage_no) | |
| keyword | no | 단지명 일부 (공백 무관) | |
| house_ty | no | 주택형 (예: '59', '84B') — 생략 시 공고의 주택형 목록을 돌려준다 | |
| mid_rate_pct | number | no | 중도금 대출 연이율 %(기본 5.0 — 실제 금리는 공고·은행마다 다르다) (허용 범위 0 초과~20) |
| extra_options_krw | integer | no | 발코니 외 유상옵션 합계(원) — realty_notice_facts의 옵션가에서 골라 넣어라 |
| movein_ym | no | 입주 년월 YYYYMM 덮어쓰기 — 공고에 입주예정이 없거나 다른 가정을 쓸 때 |
분양 한 건이 내 자기자금과 대출로 닫히는지 시점별로 판정한다. 공고 하나에 대해 "내 자기자금으로 닫히는가"를 결정론으로 판정한다 — 시점별 (계약금→중도금 회차→잔금) 필요액, 잔금 시점의 필요 대출액, 그 대출이 규제 상한 (LTV·가액구간 한도·DSR — realty_loan_limit과 같은 엔진) 안에 드는지, 부족하면 얼마가 부족한지. "이 분양 당첨되면 진행 가능해?"류 질문의 자리다. 경계: ① 차주 유형·소득은 선언이다(서버는 판정하지 않는다). ② 판정은 현행 규제·현재 자기자금 기준이다 — 잔금 시점(수년 뒤)의 규제·금리·저축 증가는 반영하지 않으며 그 사실을 assumptions에 싣는다. ③ 승인·확약이 아
| Parameter | Type | Required | Notes |
|---|---|---|---|
| house_manage_no | string | yes | 공고 관리번호 (realty_presale의 house_manage_no) |
| own_funds_10k | integer | yes | 동원 가능한 자기자금(만원) — 계약금부터 잔금까지 전액 투입 가정으로 계산한다. 0도 유효하다(전액 대출 시나리오 — 계약금 게이트에서 정직하게 걸린다) |
| borrower | string | yes | 잔금대출 차주 유형(사용자 선언 — realty_loan_limit과 동일 계약). 계약자 명의 기준으로 선언하라 |
| house_ty | no | 주택형 (예: '59', '84B') | |
| floor_zone | no | 층 구분(예: '5~9층') — 생략하면 첫 밴드로 계산하고 나머지 밴드 총액을 병기한다 | |
| annual_income_10k | no | 차주 연소득(만원) — 주면 잔금대출의 DSR 상한까지 반영해 판정한다 | |
| existing_annual_debt_payment_10k | integer | no | 기존 대출 연간 원리금(만원) |
| interest_rate_pct | no | 잔금대출 약정금리 가정(%) (허용 범위 0 초과~20) | |
| loan_term_years | integer | no | 잔금대출 만기(년) (허용 범위 1~50) |
| lender | string | no | 업권 |
| rate_type | string | no | 잔금대출 금리유형 — realty_loan_limit과 동일 계약. 기본 '변동'은 스트레스 금리 전액 가산이라 가장 보수적이다(안 닫힌다는 판정이 유형 때문일 수 있다) |
| rate_fixed_years | no | 혼합형 고정기간 또는 주기형 변동주기(년) — 미지정 시 5년 가정 (허용 범위 0~50) | |
| credit_loan_10k | no | 신용대출 잔액·예정액(만원) — realty_loan_limit과 동일 계약(서버가 산정만기 5년 규제식으로 계산한다). 직접 연 원리금을 계산해 넣지 마라 | |
| credit_loan_rate_pct | no | 신용대출 약정금리(%) — credit_loan_10k를 줬으면 필수 (허용 범위 0 초과~20) | |
| mid_rate_pct | number | no | 중도금 대출 연이율 %(기본 5.0) (허용 범위 0 초과~20) |
| extra_options_krw | integer | no | 발코니 외 유상옵션 합계(원) |
| region | no | 규제 판정용 지역 덮어쓰기 — 생략하면 공고 소재지로 판정한다 | |
| is_regulated | no | 규제지역 여부 직접 선언 | |
| is_metro | no | 수도권 여부 직접 선언 | |
| expected_price_at_movein_10k | no | 입주(잔금) 시점 예상 시세 선언(만원) — 잔금대출 LTV는 실무상 입주시 시세·감정가 기준이라, 선언하면 그 값 기준 판정을 병렬로 준다. 서버는 미래 시세를 추정하지 않는다(선언 없으면 분양가 기준만) |
지역의 입주 예정 물량을 연월별로 집계한다. 지역의 입주 예정 물량을 연월별로 집계한다 — "○○ 입주장 리스크 있어?", "내년에 입주 물량 얼마나 쏟아져?"류 질문용. 입주 몰림은 전세가 하락·역전세 압력 신호다. region·sigungu를 둘 다 비우면 전국 호출이고 응답에 by_sido(시도별 세대·공고 수, 세대 내림차순, 시도 미상 공고는 sido=null로 따로)가 실린다 — 시도 비교에 시도마다 따로 부르지 마라. 기본 창은 오늘부터 앞이다 — from_ym을 안 주면 이번 달에서 시작하므로 months=12는 "앞으로 12개월"이지 "최근 12개월"이 아니다. 과거를 물었으면 from_ym을 과거로 줘라
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도만 (예: 서울, 경기, 세종, 부산). 시군구('강남구')는 sigungu에 넣어라 — region에 넣으면 서버가 sigungu로 옮겨 조회하고 그 사실을 meta.unapplied_conditions에 적는다(시군구 어휘에 없는 이름은 옮기지 못하고 역시 거기 적는다). realty_supply_pipeline의 region은 시군구·동도 | |
| sigungu | no | 시군구 정확한 이름 (예: 수원시, 강남구) | |
| from_ym | no | 조회 창의 시작 월, YYYYMM 6자리(예: 202508). 생략하면 이번 달이라 창이 전부 미래가 된다 — 이 도구의 기본 방향은 '입주 예정'이라서다. '최근 N개월'·'지난해'처럼 지나간 물량을 물었으면 여기를 과거로 줘라: 최근 12개월 = from_ym='202508' + months=12, 작년 한 해 = from_ | |
| to_ym | no | 조회 창의 끝 월, YYYYMM 6자리(기본 from_ym+36개월). months와 같은 축이라 둘 중 하나만 준다 | |
| months | no | from_ym부터 앞으로 몇 개월을 볼지 — to_ym 대신 쓰는 간편 인자(예: 24). 뒤로 세지 않는다 — months=12만 주면 from_ym이 이번 달이라 '앞으로 12개월'이 되고, '최근 12개월'을 원했다면 from_ym을 12개월 전으로 함께 줘야 한다. to_ym과 함께 주면 오류다(둘 중 하나만) (허용 범위 1~120) |
아직 공고가 안 난 예정 공급을 사업계획승인 기준으로 본다. 아직 분양 공고가 안 난 예정 공급을 사업계획승인 기준으로 본다 — "지금 넣을까, 다음 걸 기다릴까", "이 동네 앞으로 입주 폭탄 있나"류 질문의 자리. 청약홈(realty_presale·realty_move_in_supply)은 모집공고일에야 등록되므로 공고 전 물량이 구조적으로 안 보인다. 이 도구의 원천은 주택법 사업계획승인이라 공고 2~3년 전 단계가 잡힌다: 사업명·세대수·승인일·착공예정일·사용검사 예정일(=예상 입주). 재당첨 제한(분양가상한제 단지는 10년)·전매제한이 걸린 결정에서는 대안 정보가 없으면 "지금 아니면 끝"이라는 잘못된 압박이 생긴다
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 지역 — 시도·시군구·동 부분일치 (예: '세종', '세종특별자치시 합강동', '수원시'). ⚠️ 짝 도구 realty_move_in_supply의 region은 시도 전용이다 — 인자를 그대로 옮겨 부르지 마라 | |
| from_ym | no | YYYYMM (기본 이번 달) | |
| to_ym | no | YYYYMM (기본 from_ym+60개월) | |
| months | no | from_ym부터 몇 개월을 볼지 — to_ym 대신 쓰는 간편 인자(예: 24). to_ym과 함께 주면 오류다(realty_move_in_supply와 같은 계약) (허용 범위 1~120) | |
| limit | integer | no | 사업 목록 상한 (기본 30) (허용 범위 1~100) |
시군구마다 앞으로 들어올 아파트와 늘어나는 세대를 같은 창으로 나눠 수급을 판정한다. "○○ 공급 과잉이야?", "세종 대전 서울 경기 수급", "어디가 입주 대비 수요가 많아?"류 질문의 자리 — 입주(청약홈 공고, 향후 N개월)를 연 단위로 환산해 최근 12개월 세대 증가로 나눈 비율과 판정(과잉 >1.5 · 공급 우위 1~1.5 · 균형 0.5~1 · 부족 <0.5 · 세대 감소 중)을 주고, 같은 행에 교차검증 신호(순이동·매매 거래량 증감·전세/월세 증감과 월세 비중·1순위 경쟁률· 낙찰가율·미분양)를 싣는다. 판정과 신호가 엇갈리면 conflict에 적는다. 결론에 반드시 옮길 것: · 입주는 하한이다 — 정비사업 조합
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | string | yes | 시도(예: '경기', '서울', '세종') 또는 시군구(예: '평택시', '서울 강남구'). 시도를 주면 소속 시군구 표 + 시도 합계, 시군구를 주면 그 행 + 시도 합계. 동명 시군구('중구')는 시도를 붙여라 — 안 붙이면 후보를 돌려준다. '광주'는 광역시·경기 광주시가 갈려 '광주광역시' 또는 '광주시'로 줘라 |
| horizon_months | integer | no | 입주를 다음 달부터 몇 개월 볼지(기본 24). 비율은 이 창을 연 단위로 환산해 12개월 세대 증가와 나눈다. 30개월을 넘기면 뒤쪽은 아직 공고 전이라 과소로 나온다 (허용 범위 6~60) |
통계청 빈집(미거주주택) — 빈집 수·빈집 비율·전체 주택, 아파트/비아파트, 건축연도 구간, 원인 유형. "○○ 빈집 몇 채야", "빈집 왜 늘었어", "빈집률 높은 시", "과천 빈집", "지방 빈집"류 질문의 자리다. 시군구를 주면 연도 시계열(2015~)·아파트/비아파트 분리·건축연도 구간(최근 2년 준공·1980년대·1979 이전 등)· 재고 대 세대 증감 분해·준공후 미분양 몫·같은 유형(시·구·군) 안 백분위·원인 유형 라벨 (정비사업 이주형·공급·입주형·인구유출·노후형·관광·세컨드형(추정), 규칙과 근거 수치 동봉)을 준다. 결론에 반드시 옮길 것: · definition — 통계청 미거주주택은 조사 시점(11월 1일) 비어 있는
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | '전국'·시도('경기')·시군구('과천시', '서울 중구'). 동명 시군구는 시도를 붙여라 — 안 붙이면 후보를 돌려준다. 구가 있는 시(수원·성남 등)는 시 단위만 있다. rank_by로 순위를 볼 땐 비워 둔다 | |
| rank_by | no | region 없이 순위를 볼 때 — 같은 area_type 안에서만 정렬한다(빈집률·빈집 수·5년 빈집률 변화) | |
| area_type | no | 순위의 유형 — rank_by와 함께 필수. 시·구·군을 섞은 순위는 내지 않는다 | |
| limit | integer | no | 순위·하위 지역 행 수 (허용 범위 1~60) |
시공사·시행사별 분양 성적 — 공고 수·공급 세대·무순위(줍줍) 세대와 비율·청약 1순위 배수·미달 세대. "○○건설 분양 성적", "GS건설 현장 무순위 많이 나왔나", "대전 시공사별 분양", "이 시행사 다른 현장은"류 질문의 자리다. builder(또는 developer)를 주면 그 회사 행과 현장 목록(단지·지역·공고일·공급· 무순위·비율·시행사)을, 아무것도 안 주면 공급 상위 N개 회사 순위를, region(시도)을 주면 그 시도로 좁힌다. 행마다 같은 창의 전국 비율(baseline)이 비교 기준으로 붙는다. 결론에 반드시 옮길 것(meta.disclosures): · 무순위 세대는 최종 미분양이 아니다(당첨 후 계약
| Parameter | Type | Required | Notes |
|---|---|---|---|
| builder | no | 시공사명(부분일치, ㈜·주식회사 무시, '지에스건설'→GS건설 같은 별칭 흡수). 주면 그 회사 행 + 현장 목록 | |
| developer | no | 시행사(사업주체)명(부분일치). builder와 같이 주면 그 시행사와 한 현장만 남긴다 | |
| region | no | 시도로 좁힌다(예: '대전', '경기') — 시군구는 받지 않는다 | |
| since | string | no | 본공고 공고월 하한 YYYY-MM(기본 2024-07) |
| top_n | integer | no | 회사를 안 줬을 때 순위 모드의 행 수(공급 세대 내림차순) (허용 범위 1~50) |
| group | string | no | 순위 모드의 묶음 단위 |
| view | string | no | sites=무순위 청약 미달 단지 목록(최근 회차 △N, since는 최근 회차 월) |
| min_shortfall | integer | no | sites: 최근 회차 미달 세대 하한 (허용 범위 0~100000) |
| sort | string | no | sites 정렬 |
마감 전 공공임대 모집공고(접수 예정 포함) — LH 행복주택·국민임대·영구임대·통합공공임대·공공임대·매입임대·전세임대. "행복주택 모집 공고 있어?", "서울 청년 전세임대 지금 신청돼?", "경기 매입임대 모집", "LH 임대 공고"류 질문의 자리다. 공고마다 유형·지역·진행상태·마감일·남은 일수와 원문 공고 주소(source_url)를 준다. 마감 임박 순이고 총계(meta.total_matched)·잘림(meta.truncated)이 함께 나온다. 결론에 반드시 옮길 것: · 원천은 LH 공고(+마이홈의 LH 밖 공급기관 일부)다. SH·GH·iH 등 지방공사 자체 공고와 장기전세는 없다 — 0건이나 적은 건수를 '모집이 없다'로
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도(예: '서울', '경기', '전남'). 시군구·단지명은 keyword로 준다. '광주'는 광주광역시다(경기 광주시는 region='경기', keyword='광주'). 전국 단위 공고는 어느 시도에도 함께 실린다 | |
| rental_type | string | no | 임대 유형. 장기전세(SH 상품)는 이 원천에 없어 0건과 함께 그 사실을 돌려준다 |
| keyword | no | 공고명·지역 표기 부분일치(공백 무시) — '청년'·'신혼'·시군구 등. LH는 시군구 필드가 없어 공고명에 적힌 것만 잡힌다(meta.keyword_scope) | |
| limit | integer | no | 돌려줄 공고 수(마감 임박 순) (허용 범위 1~50) |
| offset | integer | no | 건너뛸 공고 수 — meta.next_offset을 그대로 넣는다 (허용 범위 0~5000) |
청약 경쟁률과 실제 당첨 가점 커트라인을 낸다 — "나 가점 52점인데 당첨될까?"의 정량 근거. 가점 자체를 모르는 사용자는 realty_subscription_score(무주택·부양가족·가입기간 선언 → 배점표 적용)로 먼저 점수를 만들어 my_score로 넘겨라. 비어 있으면 왜 비었는지부터 읽어라(2026-08-20 축 신설). 이 축의 원천은 주 1회 전량 수집 이라 "아직 공표가 안 됐다"와 "공표는 됐는데 우리가 아직 안 걷었다"가 똑같이 빈 배열로 보인다 — 실측(공고 2026000323)에서 청약홈엔 1순위 경쟁률 4.33·12.90·15.55가 이미 공표됐는데 우리 응답은 by_house_type=[]였다. `freshness_ve
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도 (예: 서울, 경기, 세종) | |
| sigungu | no | 시군구 정확한 이름 (예: 노원구, 수원시). 벤치마크를 좁힐 때 쓴다 — 표본이 0이면 시도 단위로 넓혀라 | |
| keyword | no | 단지명·주소 부분일치 (예: '월계 중흥') | |
| house_manage_no | no | realty_presale 응답의 공고 관리번호 — 알면 이걸로 특정하는 게 정확 | |
| my_score | no | 내 청약 가점(0~84점). 주면 실제 커트라인과 점수 차를 계산해 준다 (허용 범위 0~84) | |
| since_years | integer | no | 지역 벤치마크에 쓸 최근 기간(년). 커트라인은 시장 사이클을 타므로 기본 3년 (허용 범위 1~6) |
| area_band | no | 전용면적대로 좁힌다. 같은 구 안에서도 평형이 바뀌면 커트라인이 움직인다(실측: 노원 59㎡ 58.5점 vs 60~84㎡ 59점, 동작은 반대로 84㎡ 62점·59㎡ 64점) | |
| budget_max_10k | no | 예산 상한 — 분양 최고가(만원) 기준. 사용자가 '9억까지'라고 하면 90000. 가점만으로 답하면 살 수 없는 단지가 섞인다 | |
| budget_min_10k | no | 예산 하한(만원) | |
| breakdown | no | 분포를 쪼갤 축. 시도 하나로 답하지 마라 — 서울 은평 전용 59㎡ 커트라인 중앙 45점, 강남 59㎡ 74점으로 같은 시도 안에서 29점이 갈린다. '어디까지 되나'류 질문에는 sigungu, '언제가 쌌나'는 quarter·year를 쓴다 |
시군구 순위를 가격·상승률·전세가율 같은 축으로 조회한다. 지역(시군구) 순위를 조회한다 — "제일 비싼 동네 어디야?", "요즘 많이 오른 지역은?", "전세가율 높은 곳은?"류 질문용. price=거래량 가중 전용 평당가(최소 5건, 최신월은 집계 진행 중일 수 있음) · growth=전용 60-85㎡ 고정 YoY(평형 구성 왜곡 제거). 응답 methodology의 산식·단위를 답변에 반영하라. investment=전세가율(시군구×전용평 셀로 매매·전세를 같은 평형끼리 짝지어 산출, 전 행이 같은 기준월·짝지은 건수 공시). 같은 평형·단지 수준은 realty_rental_yield. transit·school도 보류다(2026-09-
| Parameter | Type | Required | Notes |
|---|---|---|---|
| metric | string | yes | price=전용 평당가 / growth=연간 상승률 / investment=전세가율·갭투자 / transit·school=보류(입지 점수가 미검증 참고값이라 순위를 내지 않는다 — 호출하면 대안 안내) |
| region | no | 시도명(예: 부산)이면 그 시도 안 순위, 시군구명이면 해당 지역 필터. 비우면 전국 | |
| order | string | no | desc=상위부터, asc=하위부터 |
| limit | integer | no | (허용 범위 1~50) |
한국 기준금리·KOSPI·M2, 미 연준금리·S&P500 등 거시 지표의 월별 시계열을 조회한다. "금리가 집값에 어떤 영향?"류 배경 분석용. ⚠️ 계열마다 신선도가 다르다 — meta.series_as_of가 계열별 실제 최신 시점이다(예: 미 연준금리·S&P·코인은 최신인데 한국 기준금리·KOSPI는 2024-12 정지, ECOS 재수집 대기). 밀린 계열을 "지금 금리"로 인용하지 말고 반드시 그 계열의 시점을 함께 밝혀라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| months | integer | no | 최근 몇 개월치 (허용 범위 1~240) |
| indicators | no | 쉼표 구분 지표명: bok_base_rate(한국 기준금리 %), kospi(월말 종가), korea_m2(M2 평잔·원계열, 조원), fed_rate(미 연준금리 월평균 %), us_m2(미 M2 계절조정 $B), sp500, btc_usd, eth_usd(월말 종가). 비우면 전체. 목록에 없는 이름은 거절한다(조용히 버리지 않는다) |
지역 인구·가구·고령화·순유입 통계를 조회한다. 지역 인구통계를 조회한다 — "인구 줄고 있어?", "1인 가구 비율은?", "고령화 심해?", "순유입 되는 동네야?"류 질문용. 응답 meta.data_as_of가 실제 최신 시점이다 — warning이 있으면 그대로 사용자에게 전달하고, 밀린 수치를 "지금 인구"로 단정하지 말 것. 연간 계열(households·age)은 기준연도를 밝혀라. households만 동명 시군구(중구·서구 등)를 거절한다(원천 단명 수집 결함) — 그 경우 population·migration(정식 명칭 수집)으로 대신 조회하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| metric | string | yes | population=월별 인구·세대수 / households=연별 가구원수별 가구(1인가구 등) / age=연령대(5세 구간) 분포·고령화 — 시도 단위만 / migration=월별 전입·전출·순이동 |
| region | string | yes | 시도(예: 서울)나 시군구(예: 강남구, 수원시). age는 시도 단위만 제공. age에 한해 '전국'도 가능 |
| months | integer | no | population·migration 시계열 창(개월) — 최대 60(5년)이고 더 긴 창은 이 도구로 못 받는다. 연간 계열엔 미적용 (허용 범위 1~60) |
[유료] 단지의 다음 달 평균 매매가를 평형대별로 예측한다 (XGBoost v4_clean). complex_name 또는 complex_key 중 하나는 필수. 동명 단지가 여러 지역에 있으면 먼저 realty_complex_report로 단지를 특정한 뒤 complex_key로 호출하라. 예측 지평은 1개월(익월) 고정 — 그 너머는 모델이 검증되지 않아 제공하지 않는다. 커버리지 밖은 정직하게 거절된다(지어내지 않음) — ①최근 3개월 내 월 거래 3건 미만이거나 ②과거 거래 이력이 없는 신축 첫 달(모델이 지역·평형 평균을 토해 2~4배 틀린다, 실측). 예측이 없을 뿐 시세 데이터는 있으니 그때는 실거래 도구로 답하라. 응답 predicti
| Parameter | Type | Required | Notes |
|---|---|---|---|
| complex_name | no | 단지명 (예: 반포자이) | |
| complex_key | no | 정확한 단지 키 — realty_complex_report가 돌려주는 complex_key | |
| months | integer | no | (구버전 호환) 예측 지평은 1개월 고정 — 이 값은 무시되고 응답이 그 사실을 실토한다 (허용 범위 1~12) |
[유료] 단지 하나의 시세·전세·기본정보를 통합 조회한다. 입지는 location.facts(원시값)로 답하라 — 최근접역 이름·직선거리, 반경 500m·1km 안 정류장·병원·마트 수와 1km 안 초·중·고 수를 poi 원장에서 직접 센 값이다. location.overall_score·scores는 미검증 참고값이라(location.score_demotion) 순위·비교·'입지 좋음' 판정에 쓰지 마라. 응답에 좌표(latitude/longitude)와 complex_key가 들어 있다 — 이어서 realty_poi_nearby(시설 목록)·realty_predict_price(예측)에 그대로 넣어 심층 분석하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | no | 단지명 (예: 반포자이) | |
| complex_key | no | 정확한 단지 키 |
[유료] 여러 지역의 매매·전세 시세와 추이를 나란히 비교한다. 갈아타기·투자처 비교용. "어디가 제일 ○○해?"류 순위·탐색 질문은 무료 realty_region_rankings로 먼저 좁혀라 — 이 도구는 비교 대상이 정해졌을 때 쓴다. ⚠️ 지역별 warning_baseline·warning_dispersion을 avg_price보다 먼저 읽어라 — 이 소스는 이상치 미필터·단지급 혼합이라 avg_price를 그대로 "그 지역 시세"로 인용하면 특정 단지와의 비교 결론이 뒤집힌다(realty_region_price_stats와 같은 공시다).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| regions | yes | 비교할 시군구 2개 이상 — 배열(['강남구','서초구']) 또는 쉼표 문자열('강남구,서초구') | |
| months | integer | no | 추이 개월 수 (허용 범위 1~60) |
[유료] 시군구별 월세 수익률·평균 매매가·평균 월세를 조회한다. 수익형 투자 스크리닝용. 기본 응답은 최신 완결월 1개월치를 수익률 내림차순으로 자른 것이다 — 전체 기간·전체 지역이 아니다(truncated 필드 확인). 특정 월은 year_month로 조회하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 시도(예: 서울특별시) 또는 시군구(예: 강남구). 세종은 시 단위로 나온다 | |
| pyeong_supply | no | 분양평수(예: 25·34) — 서버가 ×0.745로 전용평으로 환산해 전용평 구간(S·M·L·XL·XXL)을 고른다(분양 25평→S, 34평→M) | |
| year_month | no | YYYYMM (기본 최신 완결월) | |
| limit | integer | no | 반환 행 수 — 수익률 내림차순 상위 N (허용 범위 1~50) |
[유료] 좌표 주변의 지하철·학교·병원·마트 등 입지 요소를 거리순으로 조회한다. 단지 좌표는 realty_complex_report가 준다. "역세권인가", "초품아인가" 판단용. 최근접역 거리·반경 안 개수만 필요하면 무료 realty_location_scores의 location_facts로 충분하다 — 이 도구는 시설 목록(이름별 거리)이 필요할 때 쓴다.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| lat | number | yes | 위도 — realty_complex_report의 latitude를 쓰라 |
| lng | number | yes | 경도 |
| poi_type | no | subway | hospital | school — 쉼표로 조합 가능(예: 'subway,school'), 비우면 전체. 이 3종만 좌표 검색을 지원한다(마트·약국 등은 지역 통계 realty_poi_stats로) | |
| radius_m | integer | no | 반경(미터) (허용 범위 100~3000) |
[유료] 시군구별 병원·학교·지하철역 개수 통계를 조회한다. 지역 간 인프라 비교용. 지역 키는 '시도축약 시군구' 2토큰이다(예: '서울 마포구', 세종은 1토큰). 병원·지하철은 수집 범위가 수도권·광역시 중심이라 지방 시군구는 0으로 나올 수 있다 — 0을 "없다"로 단정하지 말고 수집 범위 밖일 수 있다고 말하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 지역명 — 시도는 정식명·축약 모두 받는다(예: 서울, 경상남도 고성군, 경남 고성군, 마포구). 토큰 정확일치라 '남구'에 강남구가 섞이지 않는다. 비우면 전국 전체 | |
| limit | integer | no | (허용 범위 1~50) |
[유료] 지역의 투자 위험도를 변동성·유동성·공급압력 축으로 점수화한다. 응답의 disclaimer(통계 요약이며 투자 권유 아님)를 사용자에게 반드시 함께 전달하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | string | yes | 시군구명 (예: 강남구) |
[유료] 미분양 추이와 시장심리지수를 한 번에 조회한다. 매수 타이밍 판단의 거시 신호. 준공후 미분양(unsold_completed, 지역 합계)도 같은 모양으로 싣는다. sigungu를 주면 시군구 미분양 추이(unsold_sigungu)를 별도 키로 덧붙인다. 기본 창은 6개월이다(방향 판단에 필요한 최소). 더 긴 추이가 필요하면 months를 올리되, 전국 조회에서 창을 넓히면 오래된 달부터 예산에 맞춰 떨어지고 그 사실이 meta.truncated·meta.truncated_note에 값으로 실린다 — region을 지정하면 전 창이 온다.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| region | no | 지역명 (예: 서울). 비우면 전국 | |
| months | integer | no | 시계열 개월 수 (기본 6). 전국(region 미지정)에서 창을 넓히면 시도 18곳×월 행이 곱으로 늘어 응답이 도구 결과 한계에 걸린다 — 긴 창이 필요하면 region으로 지역을 좁혀라 (허용 범위 1~36) |
| sigungu | no | 시군구명 (예: 창원시·수원시·중구). 주면 그 시군구의 미분양 추이를 unsold_sigungu에 따로 싣는다 — 시도 배열(unsold)과 합산하지 마라(이중계상). 같은 이름이 여러 시도에 있으면(중구·동구 등) region으로 시도를 함께 줘라. 심리지수·준공후 미분양은 시도 단위라 시군구로 안 좁혀진다 |
[유료] 건령·거래활성 기반 재건축 후보 스크리닝 상위 단지를 조회한다. 점수 = 건령(최대 70, 30년 연한 기준) + 최근 12개월 거래활성 전국 백분위(최대 30). 사업성(용적률·대지지분·안전진단·조합 단계)은 반영되지 않는다 — 후보 발굴용이지 투자 판단 근거가 아니며, 응답의 disclaimer를 사용자에게 그대로 전하라.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| district | no | 지역명 (예: 서울, 구로구). 비우면 전국 상위 | |
| limit | integer | no | (허용 범위 1~50) |
| region | no | 지역명 — 다른 도구와 같은 인자 이름. district와 같은 뜻이다(둘 중 하나만) |
[유료] 서울시 정비사업(재개발·재건축·가로주택) 사업장 목록을 조회한다. [유료] 서울시 정비사업(재개발·재건축·가로주택 등) 사업장 목록 — 사업명·유형· 진행 단계·위치. "○○구 재개발 어디까지 진행됐어?"·"면목동 재개발 어디 있어?"류 질문용. 구(region)·동(dong)·유형(project_type)·진행 단계(stage)로 거를 수 있다. 커버리지는 서울 한정(정보몽땅 원천) — 타 시도는 이 도구로 답할 수 없다고 밝혀라. 세대수·준공예정은 원천 목록이 제공하지 않아 null이다(지어내지 말 것). 원천이 진행 단계를 비워 둔 사업장이 있다(약 2%) — stage가 빈 행은 '단계 미상'이지 '진행 없음'이 아니다. 재건축 *
| Parameter | Type | Required | Notes |
|---|---|---|---|
| sigungu | no | 시군구 (예: 강남구). 비우면 서울 전체. region과 같은 뜻의 옛 이름(둘 중 하나만) | |
| project_type | no | reconstruction=재건축, housing_redevelopment=재개발(주택정비형), urban_redevelopment=재개발(도시정비형), street_housing=가로주택정비, small_reconstruction=소규모재건축, small_redevelopment=소규모재개발, regional_housing=지역주택, remodeling= | |
| limit | integer | no | (허용 범위 1~50) |
| offset | integer | no | 페이지네이션 오프셋 |
| region | no | 시군구 (예: 강남구) — 다른 도구와 같은 인자 이름. sigungu와 같은 뜻이다 | |
| dong | no | 법정동 (예: 면목동·신길동) — 사업장 주소로 거른다. 구를 함께 주면 빠르다 | |
| stage | no | 진행 단계 필터 — plan_establishment=정비계획 수립, zone_designation=정비구역지정, safety_assessment=안전진단, committee_approval=추진위원회승인, union_establishment=조합설립인가, project_approval=사업시행인가, disposal_approval=관리처분인가, sale= |
사용자가 답변 오류 제보나 개선 요청을 전해 달라고 했을 때만 운영자에게 보낸다. 쓰는 때: 사용자가 "이거 틀렸으니 신고해 줘", "운영자에게 알려 줘", "이런 데이터도 넣어 달라고 전해 줘"처럼 제보·요청을 부탁했을 때. 보내기 전에 무엇이 전달되는지 사용자에게 알린다. kind='결함'은 틀린 답 제보, kind='질문기록'은 개선 요청이다. 쓰지 않는 때: 사용자가 요청하지 않았는데 질문을 남기려고 부르지 않는다. 답하기 전에 먼저 부르지도 않는다 — 이 도구는 답변·정정을 대신하지 않는다. 전달 내용(인자)과 같은 사용자의 직전 호출 기록 요약이 운영자 검토용으로 저장된다 (개인정보처리방침 https://realty.sallim.app
| Parameter | Type | Required | Notes |
|---|---|---|---|
| problem | no | 사용자가 제보한 문제. 사용자가 지적한 말을 그대로 옮겨도 된다. kind='결함'이면 필수, kind='질문기록'이면 비워도 된다. | |
| question | no | 사용자가 제보·개선 요청과 함께 전해 달라고 한 질문(kind='질문기록'이면 필수). ⚠️ 개인 식별 조합은 일반형으로 바꿔서 넣는다 — 소득·보유자산·보유단지·거주지 중 둘 이상이 겹치면 그대로 적지 말 것(예: '○○아파트 33평 보유 + 주식 10억 + 잠실 거주' → '1주택 보유(대출 없음), 인근 재건축 단지로 갈아타기'). 무인증 공개 | |
| kind | string | no | '결함'=사용자가 답이 틀렸다고 제보해 달라고 한 경우(기본). '질문기록'=사용자가 '이런 질문에도 답하게 해 달라'·'이 데이터도 넣어 달라'처럼 개선 요청을 전해 달라고 한 경우 — 그 질문과 무엇이 없었는지를 넘긴다(응답에 그 질문이 어느 도구 축에 해당하는지가 routing으로 함께 온다). 사용자가 요청하지 않은 질문을 기록용으로 넘기 |
| answered_fully | no | kind='질문기록' 전용 — 이 서버 도구만으로 그 질문에 완결된 답을 했는가. false면 missing_axis에 무엇이 없었는지 적는다 | |
| missing_axis | no | answered_fully=false일 때 없어서 못 답한 것(예: '단지별 구조형식(벽식/라멘) 라벨 없음', '경기 정비사업 단계 조회 불가 — 서울 한정') | |
| tool_used | no | 문제가 된 답을 만든 도구 이름 | |
| wrong_value | no | 틀린 수치·문장 | |
| expected | no | 사용자가 맞다고 본 값이 있으면 |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Korea Realty or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 0.111.23.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Korea Realty can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.