Korea Realty

{
  "type": "object",
  "title": "realty_auction_alertsArguments",
  "properties": {
    "sido": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sido",
      "default": null,
      "description": "시도 (예: 세종, 경기도) ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "반환 개수 (최대 50) (허용 범위 1~50)"
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 (예: 강남구, 수원시) ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
    },
    "usage_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Usage Name",
      "default": null,
      "description": "물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다(**표기를 바꾸지 않는다** — '다세대'로 자동 매핑하는 것은 낙찰가율 통계 realty_auction_sale_rate 쪽이다). '토지'는 이 원장에 없는 이름이라 거절된다 — 대지·임야·전답으로 나뉘어 있다. 비우면 전 종류"
    },
    "min_bid_count": {
      "type": "integer",
      "title": "Min Bid Count",
      "default": 3,
      "maximum": 100,
      "minimum": 0,
      "description": "최소 유찰 횟수 (허용 범위 0~100)"
    },
    "max_discount_pct": {
      "type": "integer",
      "title": "Max Discount Pct",
      "default": 100,
      "maximum": 100,
      "minimum": 0,
      "description": "감정가 대비 최대 할인율(%) — 80%+ 극단 할인은 지분매각·대지권 없음 등 특수물건이 대부분이라, 실수요 후보를 찾을 땐 79 이하로 걸러라 (허용 범위 0~100)"
    },
    "min_discount_pct": {
      "type": "integer",
      "title": "Min Discount Pct",
      "default": 30,
      "maximum": 100,
      "minimum": 0,
      "description": "감정가 대비 최소 할인율(%) (허용 범위 0~100)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_auction_rights_analysisArguments",
  "required": [
    "case_no"
  ],
  "properties": {
    "case_no": {
      "type": "string",
      "title": "Case No",
      "description": "사건번호 — `2026타경3571` 꼴(realty_get_auction_case와 같은 규칙·정규화)"
    },
    "tenants": {
      "anyOf": [
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "null"
        }
      ],
      "title": "Tenants",
      "default": null,
      "description": "임차인 목록(현황조사서·전입세대열람·사용자 진술): {move_in_date:'YYYY-MM-DD'(전입일), fixed_date:확정일자, deposit_won:보증금(원), monthly_rent_won, dividend_requested:배당요구 여부(true/false/모르면 생략), has_lease_registration:임차권등기 여부}. 이름 칸은 없다. 법원 명세서에 적힌 임차인과 다르면 법원 값을 따르고 충돌을 공시한다"
    },
    "court_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Court Name",
      "default": null,
      "description": "법원명 — 사건번호는 법원 간 중복이 흔하다. 모르면 비워 두면 후보 법원이 돌아온다"
    },
    "expected_bid_won": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Expected Bid Won",
      "default": null,
      "description": "예상 낙찰가(원). 주면 배당을 흘려 대항력 임차인의 미변제 보증금(=낙찰자 인수액)을 **범위로** 낸다 — 집행비용·당해세·임금채권은 못 보므로 단일 숫자로 단정하지 않는다"
    },
    "registry_entries": {
      "anyOf": [
        {
          "type": "array",
          "items": {}
        },
        {
          "type": "null"
        }
      ],
      "title": "Registry Entries",
      "default": null,
      "description": "**사용자가 첨부한 등기부등본(갑구·을구)을 읽어** 권리마다 한 항목씩 넣는다: {section:'갑'|'을', order:순위번호, receipt_date:'YYYY-MM-DD'(접수일), receipt_no:접수번호(같은 날 선후를 가른다), kind:'근저당권설정'·'가압류'·'전세권설정' 등 등기목적 그대로, amount_won:채권최고액·전세금(원), note:비고('배당요구함'·'건물 전부' 등)}. **권리자 이름·주민번호는 넣지 마라** — 받을 칸이 없고, 넣으면 버리고 버린 키 이름만 ignored_fields로 알린다. 없으면 비워 둔다(법원 명세서의 최선순위로만 판정)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_auction_sale_rateArguments",
  "properties": {
    "sido": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sido",
      "default": null,
      "description": "시도 — '서울'처럼 줄여 써도 되고 '서울특별시'도 된다(서버가 정식명으로 편다). 원장 표기는 서울특별시·경기도·부산광역시·세종특별자치시·강원특별자치도 같은 정식명이다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 — 원장 표기 그대로 넣는다(예: '강남구', '평택시', '기장군'). 특례시·일반구는 '수원시 권선구'처럼 두 토막이다. 시도 이름을 여기 붙이지 마라('서울 강남구'는 안 맞는다) — 시도는 sido로 준다 ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
    },
    "area_band": {
      "anyOf": [
        {
          "enum": [
            "59㎡이하",
            "60~84㎡",
            "85㎡초과"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Area Band",
      "default": null,
      "description": "전용면적대로 좁힌다. 낙찰가율은 평형에 따라 갈린다 — 대상 물건의 평형을 알면 반드시 넣어라(응답의 by_area_band로도 확인된다)"
    },
    "usage_name": {
      "type": "string",
      "title": "Usage Name",
      "default": "아파트",
      "description": "물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. '빌라'는 표준 분류가 아니라 서버가 '다세대'로 매핑하고 그 사실을 응답에 공시한다. 비우면 전 종류"
    },
    "bid_count_max": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 100,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Bid Count Max",
      "default": null,
      "description": "유찰 횟수 **상한**(이하). 예: 2를 주면 유찰 0·1·2회 물건의 매각결과만 집계한다. 유찰이 쌓일수록 낙찰가율이 내려가므로 대상 물건의 유찰 횟수에 맞춰 좁혀라. 비우면 유찰 횟수 무관 전체(응답의 by_fail_count에 횟수별 분포가 그대로 온다) (허용 범위 0~100)"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_builder_presale_recordArguments",
  "properties": {
    "sort": {
      "enum": [
        "shortfall",
        "ratio",
        "recent"
      ],
      "type": "string",
      "title": "Sort",
      "default": "shortfall",
      "description": "sites 정렬"
    },
    "view": {
      "enum": [
        "companies",
        "sites"
      ],
      "type": "string",
      "title": "View",
      "default": "companies",
      "description": "sites=무순위 청약 미달 단지 목록(최근 회차 △N, since는 최근 회차 월)"
    },
    "group": {
      "enum": [
        "시공사",
        "시행사"
      ],
      "type": "string",
      "title": "Group",
      "default": "시공사",
      "description": "순위 모드의 묶음 단위"
    },
    "since": {
      "type": "string",
      "title": "Since",
      "default": "2024-07",
      "pattern": "^20\\d{2}-(0[1-9]|1[0-2])$",
      "description": "본공고 공고월 하한 YYYY-MM(기본 2024-07)"
    },
    "top_n": {
      "type": "integer",
      "title": "Top N",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "회사를 안 줬을 때 순위 모드의 행 수(공급 세대 내림차순) (허용 범위 1~50)"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "시도로 좁힌다(예: '대전', '경기') — 시군구는 받지 않는다"
    },
    "builder": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Builder",
      "default": null,
      "description": "시공사명(부분일치, ㈜·주식회사 무시, '지에스건설'→GS건설 같은 별칭 흡수). 주면 그 회사 행 + 현장 목록"
    },
    "developer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Developer",
      "default": null,
      "description": "시행사(사업주체)명(부분일치). builder와 같이 주면 그 시행사와 한 현장만 남긴다"
    },
    "min_shortfall": {
      "type": "integer",
      "title": "Min Shortfall",
      "default": 1,
      "maximum": 100000,
      "minimum": 0,
      "description": "sites: 최근 회차 미달 세대 하한 (허용 범위 0~100000)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_capital_gains_taxArguments",
  "required": [
    "transfer_price_10k",
    "acquisition_price_10k",
    "holding_years",
    "transfer_year"
  ],
  "properties": {
    "share_pct": {
      "type": "number",
      "title": "Share Pct",
      "default": 100,
      "maximum": 100,
      "description": "본인 지분율(%, 공동명의면 예: 50). 양도세는 인별 과세라 본인 지분만 계산하고 기본공제 250만원도 각자 받는다 — 배우자 몫은 배우자 지분으로 따로 호출하라. 두 자산 모두에 같은 지분을 적용한다 (허용 범위 0 초과~100)",
      "exclusiveMinimum": 0
    },
    "asset_type": {
      "enum": [
        "주택",
        "조합원입주권",
        "분양권",
        "주택외부동산",
        "비사업용토지",
        "부동산취득권리"
      ],
      "type": "string",
      "title": "Asset Type",
      "default": "주택",
      "description": "자산 종류 — 단기세율·장특공제가 갈린다. 분양권은 보유 2년이 넘어도 60%다. 비사업용토지=기본세율+10%p(제104조①8호). 부동산취득권리=분양권·입주권 외 권리(관리처분인가 전 예비조합원 지위 등) — 장특 없음"
    },
    "holding_years": {
      "type": "number",
      "title": "Holding Years",
      "maximum": 100,
      "minimum": 0,
      "description": "보유기간(년, 소수 허용 — 예: 1.5). 취득일~양도일이며 상속·증여 기산 특례는 사실판단이라 호출자가 확정해 선언한다 (허용 범위 0~100)"
    },
    "transfer_year": {
      "type": "integer",
      "title": "Transfer Year",
      "maximum": 2035,
      "minimum": 2026,
      "description": "양도(예정) 연도. 2027 이후는 계류 중인 세제개편안이 결과를 뒤집을 수 있어 응답에 실토가 붙는다. 2025 이전 과거 양도는 당시 규칙(중과 유예 등)이라 다루지 않는다 (허용 범위 2026~2035)"
    },
    "asset2_asset_type": {
      "enum": [
        "주택",
        "조합원입주권",
        "분양권",
        "주택외부동산",
        "비사업용토지",
        "부동산취득권리"
      ],
      "type": "string",
      "title": "Asset2 Asset Type",
      "default": "주택",
      "description": "두 번째 자산의 종류"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    },
    "transfer_price_10k": {
      "type": "integer",
      "title": "Transfer Price 10K",
      "description": "양도가액(만원, 예: 90000=9억). 예정이면 예상 매도가를 선언",
      "exclusiveMinimum": 0
    },
    "asset2_expenses_10k": {
      "type": "integer",
      "title": "Asset2 Expenses 10K",
      "default": 0,
      "minimum": 0,
      "description": "두 번째 자산의 필요경비(만원)"
    },
    "asset2_holding_years": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Asset2 Holding Years",
      "default": null,
      "description": "두 번째 자산의 보유기간(년) — **transfer_year 기준**이다. 연도분산 시나리오는 이 자산을 다음 해에 파는 가정이라 서버가 보유기간을 +1년으로 다시 계산한다(응답 scenarios.split_years.asset2_recomputed에 실토) (허용 범위 0~100)"
    },
    "multi_home_surcharge": {
      "enum": [
        "없음",
        "2주택_조정대상지역",
        "3주택이상_조정대상지역",
        "중과대상_2009.3.16~2012.12.31취득"
      ],
      "type": "string",
      "title": "Multi Home Surcharge",
      "default": "없음",
      "description": "다주택 중과 **선언** — 양도 시점에 그 주택이 조정대상지역 안이고(현재 지정 현황은 topic=regulated_area) 세대 주택 수가 2/3+인 경우. 주택 수 판정(분양권·입주권 가산, 지방 저가주택 제외)은 사실판단이라 서버가 하지 않는다. 중과 대상인데 그 기간 취득이면 마지막 값=기본세율·장특 배제(소득세법 부칙 제14조)"
    },
    "acquisition_price_10k": {
      "type": "integer",
      "title": "Acquisition Price 10K",
      "description": "취득가액(만원). 증여받은 자산은 이월과세(10년)로 증여자 원취득가가 될 수 있다 — 응답 traps 확인",
      "exclusiveMinimum": 0
    },
    "necessary_expenses_10k": {
      "type": "integer",
      "title": "Necessary Expenses 10K",
      "default": 0,
      "minimum": 0,
      "description": "필요경비 합계(만원) — 취득·양도 부대비용과 자본적 지출만. 도배·싱크대 같은 수익적 지출은 불인정이다(경계·증빙 요건은 topic=capital_gains_tax 원문)"
    },
    "asset2_transfer_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Asset2 Transfer Price 10K",
      "default": null,
      "description": "두 번째 자산의 양도가액(만원) — 주면 '올해 같이 팔기 vs 내년으로 나누기' 시나리오를 비교한다. asset2_acquisition_price_10k·asset2_holding_years와 함께 줘야 한다"
    },
    "rights_pre_approval_years": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 100,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rights Pre Approval Years",
      "default": null,
      "description": "위 입주권의 기존건물 취득일~관리처분인가일 기간(년) — 장특 보유기간(시행령 제166조⑤1) (허용 범위 0~100)"
    },
    "asset2_multi_home_surcharge": {
      "enum": [
        "없음",
        "2주택_조정대상지역",
        "3주택이상_조정대상지역",
        "중과대상_2009.3.16~2012.12.31취득"
      ],
      "type": "string",
      "title": "Asset2 Multi Home Surcharge",
      "default": "없음",
      "description": "두 번째 자산의 중과 선언 — 첫 자산 매도 후 주택 수가 줄어 지위가 달라질 수 있다. 시나리오별 지위 변화도 선언 그대로 쓴다(서버는 판정하지 않는다)"
    },
    "asset2_acquisition_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Asset2 Acquisition Price 10K",
      "default": null,
      "description": "두 번째 자산의 취득가액(만원)"
    },
    "rights_pre_approval_gain_10k": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Rights Pre Approval Gain 10K",
      "default": null,
      "description": "원조합원 조합원입주권만: 관리처분인가 전 양도차익(만원, 종전 평가액−취득가−경비, 시행령 제166조①). 주면 장특 표1을 이 차익에만 적용(제95조②). 승계취득이면 주지 마라"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_compare_auction_vs_marketArguments",
  "properties": {
    "sido": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sido",
      "default": null,
      "description": "시도 — '서울'처럼 줄여 써도 되고 '서울특별시'도 된다(서버가 정식명으로 편다). 원장 표기는 서울특별시·경기도·부산광역시·세종특별자치시·강원특별자치도 같은 정식명이다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "비교할 물건 수 (최대 50) (허용 범위 1~50)"
    },
    "case_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Case No",
      "default": null,
      "description": "특정 사건 하나만 비교할 때 — `2026타경3571` 꼴(연도 4자리 + '타경' + 일련번호). 주면 지역 조건 대신 이 사건만 보고, 기일 제한도 걸지 않는다. 사건번호는 법원 간 중복되니 court_name을 반드시 함께 주라"
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 — 원장 표기 그대로 넣는다(예: '강남구', '평택시', '기장군'). 특례시·일반구는 '수원시 권선구'처럼 두 토막이다. 시도 이름을 여기 붙이지 마라('서울 강남구'는 안 맞는다) — 시도는 sido로 준다 ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
    },
    "court_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Court Name",
      "default": null,
      "description": "법원명 — case_no와 함께 쓴다. 사건번호는 법원 간 유일하지 않아(평균 2.8배 중복) 이걸 빼면 다른 법원 물건이 섞이고 최저가 출처도 확정되지 않는다"
    },
    "usage_name": {
      "type": "string",
      "title": "Usage Name",
      "default": "아파트",
      "description": "물건 종류 — 이 도구는 같은 단지 실거래와 붙이므로 '아파트'가 기본이다. 오피스텔·다세대·연립주택도 되지만 단지 매칭률이 떨어진다. 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·근린시설·상가"
    },
    "include_past": {
      "type": "boolean",
      "title": "Include Past",
      "default": false,
      "description": "지난 기일 물건 포함 여부 — 기본은 오늘 이후 기일만(입찰 가능 후보). case_no 특정 조회는 이 값과 무관하게 기일 제한이 없다"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_complex_pyeong_priceArguments",
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "개별 거래 내역 수 (허용 범위 1~50)"
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Since",
      "default": null,
      "description": "이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "동명 단지 구분용 시군구명 (예: 마포구)"
    },
    "compare": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Compare",
      "default": null,
      "description": "단지 2~5개(complex_key·단지명 배열)를 같은 면적으로 나란히 — 면적 필수. 행마다 실제 면적 범위·거래 수가 다르니 함께 전하라. 단지 간 평균·순위는 없다. 단지 수만큼 한도를 쓴다"
    },
    "question": {
      "type": "string",
      "title": "Question",
      "default": "",
      "description": "(선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라"
    },
    "complex_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Complex Key",
      "default": null,
      "description": "정확한 단지 키 — realty_search_complexes·complex_ambiguous 후보가 돌려주는 complex_key. 주면 이름·지역보다 우선한다. **같은 동에 같은 이름의 다른 단지**(키 끝 '(1995)' 등)는 이름으로는 못 가르므로 이 인자로만 부를 수 있다"
    },
    "complex_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Complex Name",
      "default": null,
      "description": "단지명 (예: 마포래미안푸르지오2단지). complex_key를 주면 생략해도 된다"
    },
    "pyeong_supply": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 400,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Pyeong Supply",
      "default": null,
      "description": "분양평수(공급면적, **평**) — 사용자가 말하는 '34평'이 보통 이것이다. **㎡로 말했으면 여기가 아니라 area_m2_supply를 쓰라** (허용 범위 0 초과~400)"
    },
    "area_m2_supply": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 800,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Area M2 Supply",
      "default": null,
      "description": "공급(분양)면적을 **㎡ 그대로** 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 (허용 범위 0 초과~800)"
    },
    "pyeong_exclusive": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 400,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Pyeong Exclusive",
      "default": null,
      "description": "전용면적 기준 **실평수(평)** — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. **사용자가 ㎡로 말했으면 area_m2_exclusive를 쓰라** — ㎡ 값을 여기 넣으면 서버가 조용히 환산하지 않고 사유를 대고 거절한다(1평=3.3058㎡) (허용 범위 0 초과~400)"
    },
    "quoted_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Quoted Price 10K",
      "default": null,
      "description": "사용자가 **들은 가격**(호가·중개사 제시가·매물 가격, 만원). 주면 실거래 분포와 대조해 `quote_check`로 돌려준다. 이 서버는 **호가 데이터가 없다** — 실거래(MOLIT)뿐이라 '호가가 비싸다/싸다'를 판정하는 게 아니라 **실거래 어디쯤인지 위치만** 알려준다. 사용자가 가격을 말했는데 이 인자를 안 주면 모델이 그 값을 검증 없이 전제로 삼게 된다"
    },
    "area_m2_exclusive": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 500,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Area M2 Exclusive",
      "default": null,
      "description": "전용면적을 **㎡ 그대로** 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 (허용 범위 0 초과~500)"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    },
    "quoted_prices_10k": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Quoted Prices 10K",
      "default": null,
      "description": "사용자가 **매물 목록에서 복사·다운로드해 온 호가 여러 개**(만원 배열). 값이 2개 이상이면 단일 대조 대신 **호가 분포 ↔ 실거래 분포**를 비교한다(중위 대 중위, 두 구간이 겹치는지). 호가는 사용자가 가져온 것이라 서버는 **출처·수집시점·중복 매물 여부를 모른다** — 그 한계도 함께 응답에 싣는다"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_get_auction_caseArguments",
  "required": [
    "case_no"
  ],
  "properties": {
    "case_no": {
      "type": "string",
      "title": "Case No",
      "description": "사건번호 — `2026타경3571` 꼴이다(연도 4자리 + '타경' + 일련번호 1~6자리). 원장 전수가 '타경' 접두이고 '2024타경101026'처럼 6자리도 있다. '2026-3571'처럼 하이픈으로 써도 서버가 '타경'으로 펴고 무엇을 폈는지 응답에 적는다. 다만 '3571'처럼 **연도가 없으면 못 편다**(연도를 지어내면 다른 사건이 된다) — 사용자에게 연도를 물어라"
    },
    "question": {
      "type": "string",
      "title": "Question",
      "default": "",
      "description": "(선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라"
    },
    "court_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Court Name",
      "default": null,
      "description": "법원명 — '서울동부지방법원'·'인천지방법원'처럼 정식명으로 넣는다('진주지원'처럼 지원명만인 행도 있다). '의정부지법'처럼 줄여 넣어도 서버가 정식명으로 편다. 사건번호는 법원 간 유일하지 않아(전국 평균 2.8개 법원에서 중복) 생략하면 후보 목록이 돌아온다. **여기 넣은 법원에 그 사건이 없으면 서버가 법원 없이 한 번 더 찾아보고**, 그래도 없으면 원인 셋(표기·법원·수록범위)을 갈라 돌려준다"
    },
    "market_context": {
      "type": "boolean",
      "title": "Market Context",
      "default": true,
      "description": "기본 true — 같은 단지(빌라는 같은 동·면적대) 시세 대비 비율과 지역 낙찰가율을 `market_context`로 함께 싣는다(+2~4초). 사건 정보만 필요하면 false"
    },
    "rights_analysis": {
      "type": "boolean",
      "title": "Rights Analysis",
      "default": false,
      "description": "true면 **이 물건 낙찰받으면 뭘 떠안나**를 법원 원장(매각물건명세서)만으로 돌린 권리분석을 `item.rights_analysis`로 붙인다 — 말소기준권리·인수/소멸·명세서에 적힌 임차인의 대항력·우선변제·최우선변제·보류 항목. 등기부등본 권리 목록이나 임차인 정보를 넣어 돌리는 분석은 realty_auction_rights_analysis 몫이다"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_loan_eligibilityArguments",
  "required": [
    "purpose"
  ],
  "properties": {
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "소재지(시군구까지, 예: '서울 마포구'·'세종특별자치시') — 수도권·규제지역 판정에 쓴다"
    },
    "purpose": {
      "enum": [
        "구입",
        "전세",
        "생활안정",
        "전세반환",
        "중도금"
      ],
      "type": "string",
      "title": "Purpose",
      "description": "자금 용도 — **같은 담보라도 용도가 규제를 가른다**(구입=LTV·가액구간 한도, 생활안정=1억 한도·다주택 금지, **전세반환=세입자에게 보증금 돌려주는 목적(퇴거자금) — 원칙 1억이지만 6·27 이전 계약분 경과조치가 붙는 유일한 축**, 전세=세입자로 들어갈 때 쓰는 전세자금대출, 중도금=집단대출). ⚠️ **'전세'와 '전세반환'을 섞지 마라** — 방향이 반대다. 모르면 물어라"
    },
    "homes_owned": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Homes Owned",
      "default": null,
      "description": "**세대 기준** 보유 주택 수(선언) — 0=무주택, 1, 2+=다주택. 명의가 갈려도 세대로 센다. 서버는 주택 수를 판정하지 않는다 (허용 범위 0~9)"
    },
    "is_newlywed": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Newlywed",
      "default": null,
      "description": "신혼 해당 여부(선언)"
    },
    "is_first_time": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is First Time",
      "default": null,
      "description": "생애최초 해당 여부(**선언** — 서버는 판정하지 않는다)"
    },
    "house_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "House Price 10K",
      "default": null,
      "description": "대상 주택 가격(만원) — 정책상품 가격요건 대조에 쓴다"
    },
    "total_assets_10k": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Total Assets 10K",
      "default": null,
      "description": "순자산(만원, 자산−부채 — 부채가 더 많으면 음수) — 버팀목·디딤돌 자산 요건은 **순자산가액** 기준이다. **버팀목 전세는 자산 요건이 핵심 관문**이라 전세 문의면 받아라"
    },
    "annual_income_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Annual Income 10K",
      "default": null,
      "description": "부부합산 연소득(만원) — 정책상품 소득요건 대조에 쓴다"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_loan_limitArguments",
  "required": [
    "house_price_10k",
    "borrower"
  ],
  "properties": {
    "lender": {
      "enum": [
        "은행",
        "제2금융권"
      ],
      "type": "string",
      "title": "Lender",
      "default": "은행",
      "description": "업권 — DSR 한도가 은행 40% / 제2금융권 50%로 갈린다"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "주택 소재지(시군구까지, 예: '서울 마포구'·'성남시 분당구'·'부산 해운대구'). 규제지역·수도권 판정에 쓴다. 해석이 모호하면 후보를 돌려주니 is_regulated·is_metro로 직접 선언해도 된다"
    },
    "borrower": {
      "enum": [
        "무주택",
        "생애최초",
        "서민실수요",
        "1주택_처분조건부",
        "1주택_보유",
        "다주택"
      ],
      "type": "string",
      "title": "Borrower",
      "description": "차주 유형 — **사용자 선언**이다(서버는 생애최초·주택 수를 판정하지 않는다). 생애최초=본인·배우자 모두 주택 소유 이력 없음, 1주택_처분조건부=6개월 내 기존주택 처분 약정, 서민실수요=우대 요건 충족을 선언한 경우"
    },
    "is_metro": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Metro",
      "default": null,
      "description": "수도권(서울·경기·인천) 여부 직접 선언 — region 대신/우선 적용"
    },
    "rate_type": {
      "enum": [
        "변동",
        "혼합형",
        "주기형",
        "순수고정"
      ],
      "type": "string",
      "title": "Rate Type",
      "default": "변동",
      "description": "주담대 금리유형 — **스트레스 금리 적용비율이 갈리는 축이다**(변동 100%, 혼합형·주기형은 고정기간 비중별 차등, 순수고정 미적용). 기본값 '변동'은 최악 가정이라 한도가 가장 작게 나온다. 사용자가 상품을 안 정했으면 응답의 by_rate_type 비교표를 함께 전하라. 혼합형=고정기간 후 변동, 주기형=N년 주기로 금리 재산정, 순수고정=만기까지 고정"
    },
    "is_regulated": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Regulated",
      "default": null,
      "description": "규제지역(투기과열·조정대상) 여부 직접 선언 — region 대신/우선 적용"
    },
    "stress_stage": {
      "enum": [
        "현행",
        "3단계"
      ],
      "type": "string",
      "title": "Stress Stage",
      "default": "현행",
      "description": "스트레스 금리 단계 가정. 기본 '현행'. **지방(비수도권 비규제) 주담대만** 갈린다 — 지방은 2026-12-31까지 한시 2단계(0.75%p)이고 이후 연장 여부는 미정이다. '3단계'를 주면 유예가 끝나 3단계(1.5%p×적용비율 3단계)가 그대로 적용되는 가정으로 계산한다. 수도권·규제지역은 이미 3단계라 값이 같다"
    },
    "credit_loan_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Credit Loan 10K",
      "default": null,
      "description": "신용대출 잔액 또는 받을 예정액(만원). **직접 연 원리금을 계산해 넣지 마라** — 산정만기 5년 강제·산식 두 갈래·스트레스 1억 문턱이 전부 함정이라 서버가 계산한다. existing_annual_debt_payment_10k와 함께 주면 둘 다 합산한다"
    },
    "house_price_10k": {
      "type": "integer",
      "title": "House Price 10K",
      "description": "주택 시가(만원 단위, 예: 100000=10억). 가액구간 한도가 '시가' 기준이라 분양가·공시가가 아닌 시세를 넣는다",
      "exclusiveMinimum": 0
    },
    "loan_term_years": {
      "type": "integer",
      "title": "Loan Term Years",
      "default": 30,
      "maximum": 50,
      "minimum": 1,
      "description": "희망 만기(년). 수도권·규제지역은 30년 상한으로 조정되며 조정 사실을 응답에 싣는다 (허용 범위 1~50)"
    },
    "desired_loan_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Desired Loan 10K",
      "default": null,
      "description": "받으려는 주담대 금액(만원). 주면 '이만큼 되나'를 판정하고, DSR에 막히면 **무엇을 얼마나 바꾸면 들어가는지**(금리유형·만기·신용대출 축소·금리)를 함께 낸다. '4억 받으려는데 되나요'류 질문의 자리 — 최대치만 받아 모델이 역산하게 두지 마라. credit_loan_rate_pct를 함께 주면 **이 주담대를 먼저 받은 뒤 남는 신용대출 추가 여력**(desired.credit_room_after_mortgage)까지 계산한다 — credit_loan_10k를 주면 그 잔액을 기존 신용대출로 보고 추가분만 센다"
    },
    "rate_fixed_years": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 50,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rate Fixed Years",
      "default": null,
      "description": "혼합형의 고정금리 기간 또는 주기형의 금리변동주기(년). 미지정이면 시중은행 통상인 5년으로 가정하고 가정 사실을 응답에 싣는다. 변동·순수고정에는 무의미 (허용 범위 0~50)"
    },
    "annual_income_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Annual Income 10K",
      "default": null,
      "description": "연소득(만원) — interest_rate_pct와 함께 주면 DSR 상한 대출액까지 계산"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    },
    "interest_rate_pct": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 20,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Interest Rate Pct",
      "default": null,
      "description": "약정금리 가정(%, 예: 4.2) — DSR 계산에 필요. 없으면 DSR 금액 계산은 생략된다 (허용 범위 0 초과~20)"
    },
    "credit_loan_rate_pct": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 20,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Credit Loan Rate Pct",
      "default": null,
      "description": "신용대출 약정금리(%) — credit_loan_10k를 줬으면 필수다(이자 없이는 원리금을 못 낸다) (허용 범위 0 초과~20)"
    },
    "existing_annual_debt_payment_10k": {
      "type": "integer",
      "title": "Existing Annual Debt Payment 10K",
      "default": 0,
      "minimum": 0,
      "description": "기존 대출의 연간 원리금 상환액 합계(만원) — DSR 계산에서 차감"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_member_transfer_checkArguments",
  "required": [
    "project_type"
  ],
  "properties": {
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "사업장 소재지(시군구까지, 예: '서울 용산구'·'성남시 수정구') — 투기과열지구 판정과 (서울이면) 단계 자동 조회에 쓴다. 모호하면 후보를 돌려주니 is_speculation_zone을 직접 선언해도 된다"
    },
    "project_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Project Name",
      "default": null,
      "description": "사업장·구역 이름(예: '한남3구역') — 서울이면 정비사업 목록에서 진행 단계를 자동으로 잇는다(유일 매치만). 서울 밖은 목록이 없어 project_stage 선언이 필요하다"
    },
    "project_type": {
      "enum": [
        "재건축",
        "재개발"
      ],
      "type": "string",
      "title": "Project Type",
      "description": "사업 유형 — 제한 개시 시점이 갈린다(재건축=조합설립인가 후, 재개발=관리처분인가 후). 가로주택·소규모재건축 등 소규모정비사업은 별도 법제라 이 도구가 판정하지 않는다"
    },
    "project_stage": {
      "anyOf": [
        {
          "enum": [
            "관리처분인가",
            "구역해제",
            "도시계획심의",
            "분양",
            "사업계획승인",
            "사업시행인가",
            "안전진단",
            "안전진단(1차)",
            "이전고시",
            "정비계획 수립",
            "정비구역지정",
            "조합규약작성",
            "조합설립인가",
            "조합원 모집신고",
            "조합창립총회",
            "조합청산",
            "조합해산",
            "준공인가",
            "지구단위계획수립/건축심의/교통심의",
            "착공",
            "철거",
            "철거 및 착공",
            "청산 및 조합해산",
            "추진위구성",
            "추진위원회승인"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Project Stage",
      "default": null,
      "description": "진행 단계 직접 선언 — project_name 조회 대신/우선 적용. 허용값은 서울 정비사업 목록(정보몽땅)의 실측 어휘 전량이라, **자동 조회가 돌려준 stage를 그대로 다시 넣으면 같은 판정이 재현된다**(예: '철거'·'철거 및 착공'·'추진위구성')"
    },
    "is_speculation_zone": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Speculation Zone",
      "default": null,
      "description": "투기과열지구 여부 직접 선언 — region 대신/우선 적용"
    },
    "first_approval_application_after_20180125": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "First Approval Application After 20180125",
      "default": null,
      "description": "**재개발 부칙 선언** — 이 구역의 최초 사업시행계획인가 신청이 2018-01-25(법률 제14943호 시행일) 이후인가. 이전이면 관리처분인가 후에도 지위양도가 가능하다(서울 22개 구역 실재). 모르면 비워두라 — 서버가 미확인으로 실토한다"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_move_in_supplyArguments",
  "properties": {
    "to_ym": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "To Ym",
      "default": null,
      "description": "조회 창의 **끝** 월, YYYYMM 6자리(기본 from_ym+36개월). months와 같은 축이라 둘 중 하나만 준다"
    },
    "months": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 120,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Months",
      "default": null,
      "description": "from_ym부터 **앞으로 몇 개월**을 볼지 — to_ym 대신 쓰는 간편 인자(예: 24). **뒤로 세지 않는다** — months=12만 주면 from_ym이 이번 달이라 '앞으로 12개월'이 되고, '최근 12개월'을 원했다면 from_ym을 12개월 전으로 함께 줘야 한다. to_ym과 함께 주면 오류다(둘 중 하나만) (허용 범위 1~120)"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "**시도만** (예: 서울, 경기, 세종, 부산). 시군구('강남구')는 sigungu에 넣어라 — region에 넣으면 서버가 sigungu로 옮겨 조회하고 그 사실을 meta.unapplied_conditions에 적는다(시군구 어휘에 없는 이름은 옮기지 못하고 역시 거기 적는다). realty_supply_pipeline의 region은 시군구·동도 받는다 — 두 도구의 계약이 다르다"
    },
    "from_ym": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "From Ym",
      "default": null,
      "description": "조회 창의 **시작** 월, YYYYMM 6자리(예: 202508). 생략하면 **이번 달**이라 창이 전부 미래가 된다 — 이 도구의 기본 방향은 '입주 **예정**'이라서다. **'최근 N개월'·'지난해'처럼 지나간 물량을 물었으면 여기를 과거로 줘라**: 최근 12개월 = from_ym='202508' + months=12, 작년 한 해 = from_ym='202501' + months=12. 과거 조회도 그대로 된다(원장은 2020-02 공고분부터)"
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 정확한 이름 (예: 수원시, 강남구)"
    },
    "include_pipeline": {
      "type": "boolean",
      "title": "Include Pipeline",
      "default": false,
      "description": "true면 **아직 모집공고 전인** 예정 공급(사업계획승인 기준 — realty_supply_pipeline과 같은 값, 같은 지역·같은 창)을 `pipeline`에 함께 싣는다. 두 축은 더하지 마라(이중계상)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_nonapt_pricesArguments",
  "required": [
    "property_type",
    "region"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10,
      "maximum": 30,
      "minimum": 1,
      "description": "최근 거래 행 수 (허용 범위 1~30)"
    },
    "region": {
      "type": "string",
      "title": "Region",
      "description": "지역명 부분일치 (예: 관악구, 서울특별시 강남구, 강남구 역삼동). **법정동까지 되는 것은 이 도구만이 아니다** — 아파트 축의 realty_region_price_stats·realty_search_complexes도 '강남구 대치동'을 그대로 받는다. 동 단위로 좁히려고 이 도구를 고르지 마라"
    },
    "area_band": {
      "anyOf": [
        {
          "enum": [
            "40㎡미만",
            "40~59㎡",
            "60~84㎡",
            "85㎡이상"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Area Band",
      "default": null,
      "description": "전용면적대로 좁힌다(빌라·오피스텔만 — 단독주택은 전용면적 개념이 없다). 비아파트는 같은 동네에서도 면적 편차가 커서 지역 평균 하나로는 답이 안 된다. 안 넣어도 stats.by_area_band로 밴드별 분포가 온다"
    },
    "price_max": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Max",
      "default": null,
      "description": "최대 매매가(만원)"
    },
    "price_min": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Min",
      "default": null,
      "description": "최소 매매가(만원)"
    },
    "property_type": {
      "enum": [
        "villa",
        "officetel",
        "house",
        "land"
      ],
      "type": "string",
      "title": "Property Type",
      "description": "villa=다세대·연립(빌라), officetel=오피스텔, house=단독·다가구, land=토지. **이 네 값에 아파트는 없다** — 사용자가 아파트를 물었으면 아무 값이나 고르지 말고 이 도구를 부르지 마라(realty_search_complexes·realty_region_price_stats가 그 자리다). 2026-08-23 실측: '강남구 대치동 아파트 최근 실거래가'가 villa로 와 빌라 5건이 아파트로 답해졌다"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_notice_factsArguments",
  "properties": {
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword",
      "default": null,
      "description": "단지명 일부 (예: '우미린' — 공백 무관 매칭)"
    },
    "section": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Section",
      "default": null,
      "description": "팩트시트의 한 절만 전문으로 받는다 (예: '분양가층별', '유상옵션', '전매재당첨', '공고개요' — 절 이름은 공고 판본마다 다르니 모르면 비우고 응답의 절 목록을 보라. '공급'은 한 절이 아니라 공고개요·분양가층별 등에 나뉘어 있다). 비우면 전체 — 다만 전체가 도구 결과 한계를 넘으면 큰 절부터 떼어 내고 뗀 절 이름을 meta.omitted_sections에 적는다. 그때 이 인자로 되받아라."
    },
    "text_match": {
      "enum": [
        "all",
        "any"
      ],
      "type": "string",
      "title": "Text Match",
      "default": "all",
      "description": "text_query 낱말 처리 — all=모두 포함(기본), any=하나라도"
    },
    "text_pages": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Text Pages",
      "default": null,
      "description": "원문 쪽 직접 지정('1-3'·'44') — 팩트시트 대신 그 쪽 본문(최대 6쪽). text_query와 택일"
    },
    "text_query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Text Query",
      "default": null,
      "description": "**공고 원문 쪽 읽기** — 주면 팩트시트 대신 이 낱말(공백=AND)이 든 원문 쪽을 준다(realty_notice_text와 같은 값). 특공 소득·자산 기준·부적격·계약 유의사항처럼 팩트시트에 없는 세부용. text_pages와 택일"
    },
    "house_manage_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "House Manage No",
      "default": null,
      "description": "공고 관리번호 (realty_presale 응답의 house_manage_no)"
    },
    "text_pages_only": {
      "type": "boolean",
      "title": "Text Pages Only",
      "default": false,
      "description": "text_query와 함께 true면 본문 없이 일치 쪽 번호+발췌만 — 쪽을 먼저 고를 때"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_onbid_sale_rateArguments",
  "properties": {
    "sido": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sido",
      "default": null,
      "description": "시도. **주의: 결과 원장에는 지역 컬럼이 없다** — 물건명 접두에서 되찾은 값으로 거른다(커버리지는 응답의 region_basis에 실린다). ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구. 물건명에서 시도 다음 한 토막을 뽑은 것이라 '고양시 덕양구'는 '고양시'로만 잡힌다 — 자치구까지 좁히려면 이 원장으로는 안 된다. ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
    },
    "usage_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Usage Name",
      "default": null,
      "description": "용도 부분일치(대·중·소 3단). 원장 값 예: 주거용건물·아파트·토지·근린생활시설. 표본이 **입찰결과 원장**이라 물건 목록과 어휘가 미세하게 갈린다 — 없는 이름은 거절하며 이 원장의 쓸 수 있는 값을 준다."
    },
    "property_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Property Type",
      "default": null,
      "description": "재산구분. **이 축을 빼고 하나의 낙찰가율을 말하면 거의 틀린다** — 실측 중앙값이 압류재산 31.6% vs 국유재산 106.3%로 3배 넘게 갈린다."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_policy_rulesArguments",
  "properties": {
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Query",
      "default": null,
      "description": "**자유문으로 토픽을 찾는다** — 어느 topic인지 모를 때 사용자 말을 그대로 넣어라(예: '종부세 얼마부터 내요'→topic='comprehensive_real_estate_tax', '부모님이 보태주는 돈'→topic='gift_tax_and_funding_source', '전입은 빠른데 확정일자가 늦으면'→topic='auction_rights'). topic 없이 query만 주면 **후보 토픽 목록**이 오고, 후보가 하나면 그 토픽 본문까지 함께 온다. topic과 함께 주면 그 토픽을 그대로 주되 다른 후보가 있으면 알려준다. **아무것도 안 걸리면 지어내지 않고 0건이라고 답한다** — 그때는 이 서버에 그 축이 없는 것이니 표를 추측하지 마라"
    },
    "topic": {
      "enum": [
        "axes",
        "acquisition_tax",
        "regulated_area",
        "loan_rules",
        "credit_rehab",
        "credit_rehab_property",
        "lease_rules",
        "auction_rights",
        "capital_gains_tax",
        "subscription_account",
        "redevelopment_rules",
        "redevelopment_entitlement",
        "remodeling_rules",
        "one_home_exemption_map",
        "comprehensive_real_estate_tax",
        "gift_tax_and_funding_source",
        "property_tax",
        "jeonse_loan_rules",
        "interim_collective_loan",
        "living_expense_mortgage",
        "jeonse_return_mortgage",
        "auction_balance_loan",
        "funding_plan_report",
        "room_deduction_and_mci",
        "unit_alteration_rules",
        "list"
      ],
      "type": "string",
      "title": "Topic",
      "default": "list",
      "description": "**어느 표를 볼지 고른다 — 사용자가 쓰는 말로 찾아라.** axes=상품별 차이·6·27이 뭐에 걸리나·DSR 6축·수도권/규제지역 축 | **횡단 사실의 진실원**(6·27 상품별 적용·DSR 6축·수도권/규제지역·세대/인별/물건 기준 충돌). '어느 상품이 뭐가 다른가'류는 여기부터 — 상품 토픽과 어긋나면 이 표가 맞다, acquisition_tax=취득세·취득세율·다주택 중과·농특세·지방교육세·생애최초 감면 | 취득세율표(표준 구간·중과·부가세목·예외/특례·과표 논점·취득시기), regulated_area=규제지역·조정대상지역·투기과열지구·분양가상한제·토지거래허가 | **현재** 지정 현황, loan_rules=주담대·LTV·DSR·대출한도·스트레스 금리·생애최초 | 주담대 규제 원표(LTV·가액구간 한도·만기·DSR·스트레스 금리·생애최초 절차) — 조건별 판정·계산은 realty_loan_limit, credit_rehab=개인회생·신용회복·면책·공공정보 등록 | 개인회생×신용·대출 규칙 — 공공정보 등록·조기삭제(1년 성실변제, 2025-07)·면책, 기산점(개시≠인가) 함정. **재산·주택 축은 credit_rehab_property**, credit_rehab_property=개인회생 중인데 집 살 수 있나·배우자 명의로 주택 취득·청산가치·가용소득·퇴직금 압류금지·퇴직연금 압류금지 범위·주택임차보증금 압류금지·재산 은닉·인가 후 재산이 늘면 | **개인회생×부동산** — 개인회생재단의 범위(개시 vs 인가 시점)·청산가치 보장원칙이 묶는 것·압류금지라 재단에서 빠지는 재산(퇴직연금 전액 vs 퇴직금 1/2)·부부 명의 축·은닉과 정상 거래의 경계. **판정은 안 한다**, 신용·대출 축은 credit_rehab, lease_rules=전월세·임대차·계약갱신청구권·5% 상한·묵시적 갱신·집주인 실거주 | 주택임대차 갱신 — 갱신요구권(행사기간·거절사유·1회 2년)·5% 증액상한·갱신 후 해지권(3개월)·매수인 실거주 거절 판례(2021다266631), auction_rights=경매 권리분석·말소기준권리·대항력·확정일자·최우선변제·배당요구·유찰 횟수 역산·최저가 저감률(법원별 20%/30%)·인도명령·명도소송·지분경매·공유자 우선매수·공유물분할·가처분·명도확인서·부당이득·유치권 신고·상가 임차인 | 민사집행법 91조 인수/소멸·주임법 대항력·우선변제권·배당요구·배당순위 — '낙찰받으면 보증금 물어주나'·낙찰 후 명도(제136조 인도명령 6개월·명도소송 갈림)가 여기다. 판정=realty_auction_rights_analysis·금액표=realty_small_deposit_check, capital_gains_tax=양도세·양도소득세·세율표·장특공제·필요경비·다주택 중과·이월과세·양도세 신고·신고기한·예정신고·확정신고·기한후신고·가산세·분납·지방소득세 신고 | 세율표·필요경비 자본적/수익적 분류·중과 현황·2026 개편 계류 + **신고·납부 기한과 가산세**(예정 2개월·확정 5월·지방소득세 +2개월·분납·감면·비과세면 신고 의무가 없는가) — 세액 계산은 realty_capital_gains_tax, **비과세 갈림길은 one_home_exemption_map**, subscription_account=청약통장·청약 가점·배점표·납입 인정·예치금 전환 | 청약통장·가점 규칙(배점표 84점·기산 함정·월 25만원 인정·미납/선납·예부금 전환 2027-09-30 한시, 2026-09-23 1년 재연장) — 점수 계산은 realty_subscription_score, redevelopment_rules=정비구역 지정·노후도 요건·조합원 지위양도·비례율·재건축진단 | 재개발·재건축 — 노후도 60%·서울 조례 지표·39조 지위양도 제한과 예외·비례율 산식. 지위양도 가능 판정은 realty_member_transfer_check, redevelopment_entitlement=재개발 입주권·분양자격·권리산정기준일·뚜껑·도로 지분 | 재개발 분양자격 갈림길 지도(서울 한정) — 5경로·권리산정기준일 3층 경계·확인 체크리스트. 판정은 안 한다, remodeling_rules=리모델링 조합·15년 연한·수직증축·1기 신도시·증축 한도 | 공동주택 리모델링(**주택법** — 도시정비법과 별개 법제): 전용 85㎡ 미만 40%/이상 30%·세대수 15%·수직증축·39조 적용 밖·1기 신도시 특례. redevelopment_rules와 섞으면 오답, one_home_exemption_map=1세대1주택 비과세·2년 보유·2년 거주·12억·일시적 2주택·상속주택·동거봉양·상생임대·부속토지만 양도·매매특약 멸실 | **양도세 비과세 갈림길 지도** — 5관문·5경로+확인 체크리스트. **판정은 안 하지만 무엇을 확인해야 하는지는 다 있다** — 비과세 가능성이 보이면 세무사로 보내기 전에 여기다, comprehensive_real_estate_tax=종부세·종합부동산세·공시가격 문턱·공동명의·보유세 | **종부세 과세 문턱과 명의 축** — 인별 과세라 단독/공동명의가 갈리는 자리. 공시가 기준 문턱·공동명의 특례·2026 개편안(계류). **세액 계산은 안 한다**, gift_tax_and_funding_source=증여세·자금출처·자금출처조사·부모님이 보태주는 돈·차용증·공동명의 지분 | 증여재산공제 문턱 + 소명 — 10년 합산·배우자 6억·직계존속 5천만·혼인출산 1억 통합한도·지분≠기여도면 증여. **세액 계산·절세 설계는 안 한다**, property_tax=재산세·6월 1일 기준일·공시가격 과세표준·보유세 | **재산세(주택분) 구조·기준일·명의 축** — **물건별 과세라 공동명의여도 총액이 같다**(종부세와 반대). 6월 1일 기준일 함정·1주택 특례(2026 일몰). **계산은 안 한다**, jeonse_loan_rules=전세자금대출·버팀목·전세대출 DSR·중소기업 청년 전세 | 자격 + DSR 취급 — 구입자금과 다른 상품군이라 loan_rules 표를 갖다 쓰면 오답. **원금이 DSR에 안 잡히고 이자만**(정책분은 아예 제외). 한도 계산은 안 한다, interim_collective_loan=중도금대출·집단대출·잔금대출 전환·이자후불제 | **분양 중도금(집단)대출 구조·DSR·6억 한도 취급** — 중도금은 DSR 밖이지만 **다른 대출을 받을 땐 내 DSR에 잡히고, 잔금 전환 시 DSR·6억 한도가 걸린다**(계약 통과≠잔금 통과), living_expense_mortgage=생활안정자금·생활자금 대출·보유 주택 담보(구입 아님) | 이미 가진 집을 담보로 — **구입 목적이 아니다**. 수도권·규제지역 **1주택 1억 한도(기존분 합산)·다주택 금지(지방 무관)**, DSR은 구입자금과 같다, jeonse_return_mortgage=전세퇴거자금·전세보증금 반환 대출·세입자 내보낼 돈 | 원칙 1억이지만 **6·27 이전 임대차계약 + 소유권 취득분은 경과조치로 초과 가능**(LTV 70%). 경과조치는 **DSR 예외가 아니다**, auction_balance_loan=경락잔금대출·낙찰 잔금·대금지급기한 | **경락잔금대출**(경매 낙찰 잔금) — 대금지급기한에 대출 실행이 묶이는 구조. 방공제·MCI는 room_deduction_and_mci, funding_plan_report=자금조달계획서·입주계획서·증빙·30일 기한 | **주택취득자금 조달 및 입주계획서** — 제출 대상·증빙·30일 기한과 가족 차용을 적을 때 걸리는 자리, room_deduction_and_mci=방공제·MCI·MCG·실제 대출가능액이 깎이는 이유 | **방공제·MCI/MCG**(매매·경매 공통) — 규제 상한과 별개로 실제 대출가능액을 깎는 구조. 'MCI 되면 4.3억, 안 되면 3.9억'류와 '왜 계약 전에 확정을 못 해주나'의 근거, unit_alteration_rules=내력벽 철거·벽 헐기·욕실 이동·인테리어 허가·층상배관 | 이 집을 내 마음대로 고칠 수 있나 — 내력벽 철거 가부('2016년 유예로 허용'은 통설이고 조문이 깬다)·행위허가 동의율·경미한 행위·층상/층하 배관. 단지별 값은 realty_remodel_feasibility, list=제공 항목 안내(토픽 목차)"
    },
    "section": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Section",
      "default": null,
      "description": "**토픽의 하위 항목만 골라 받는다** — 미지정이면 종전과 같이 토픽 전체가 온다. 큰 토픽(auction_rights·unit_alteration_rules·loan_rules)에서 필요한 축만 집을 때 쓴다. 예: topic='auction_rights', section='assumed_regardless_of_rank' → 순위 무관 인수(유치권·법정지상권)만. 쉼표로 여러 개(section='tenant_opposing_power,tenant_priority_payment')도 된다. **없는 이름을 주면 조용히 무시하지 않고 거절하며 유효 목록을 값으로 돌려준다** — 이름을 모르면 section 없이 한 번 부르면 응답 meta.sections_available에 전 목록이 있다. topic='list'에는 하위 항목이 없다"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_presaleArguments",
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "공고 수 — 주택형별 분양가·순위별 일정이 붙어 행이 무겁다. 요청분을 다 실으면 응답이 크기 상한을 넘는 경우 **실제 반환 수를 줄이고 meta.size_capped**에 총계·좁혀 부르는 법을 값으로 싣는다 — 조용히 자르지 않는다 (허용 범위 1~50)"
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Since",
      "default": null,
      "description": "이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "시도 (예: 서울, 경기, 세종, 부산)"
    },
    "status": {
      "enum": [
        "전체",
        "접수중",
        "접수예정",
        "접수마감"
      ],
      "type": "string",
      "title": "Status",
      "default": "전체",
      "description": "오늘(KST) 기준 접수 상태로 거른다. **'오늘/지금 접수 가능한', '지금 넣을 수 있는' 질문은 '접수중'이다** — '접수예정'은 아직 못 넣는 것들이다. '다음 달 청약'처럼 앞으로를 묻는 질문만 '접수예정'. 기본 '전체'."
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword",
      "default": null,
      "description": "단지명·공급 주소 부분일치 (예: '우미린', '5-2생활권', '다솜동') — 생활권·동 단위 질의는 이걸로"
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 정확한 이름 (예: 수원시, 강남구). ⚠️세종은 이 필드가 동·생활권·도로명으로 오염돼 있으니 쓰지 말고 keyword를 쓰라"
    },
    "question": {
      "type": "string",
      "title": "Question",
      "default": "",
      "description": "(선택) 이 조회를 하게 된 사용자 질문 한 문장 — 맞는 다른 축·도구를 question_routing으로 돌려준다. 이름·연락처는 빼라"
    },
    "upcoming": {
      "type": "boolean",
      "title": "Upcoming",
      "default": false,
      "description": "⚠️True면 접수 **시작 전**(시작일이 오늘 이후, 오늘 시작 포함) 공고만 — 어제 이전에 시작해 **접수 중인 공고는 여기 없다**. 오늘 넣을 수 있는 것을 찾는다면 status='접수중'을 써라. status와 함께 쓰지 말 것(status가 이것을 대체한다)."
    },
    "notice_kind": {
      "enum": [
        "본공고",
        "무순위",
        "불법행위 재공급",
        "무순위·재공급"
      ],
      "type": "string",
      "title": "Notice Kind",
      "default": "본공고",
      "description": "공고 종류. 기본 '본공고'. 무순위(줍줍)·재공급을 물으면 그 값 — status 기본은 접수중+접수예정이고, '접수마감'이면 목록 대신 단지별 회차 이력 집계(몇 번 나왔나)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_presale_contextArguments",
  "properties": {
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "시도 (예: 경기, 서울, 경남). **시도 분포는 배경일 뿐 결론 근거가 아니다**(D-2026W33-40) — 결론은 시군구·평형대 셀에서 읽어라"
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword",
      "default": null,
      "description": "단지명 일부 (예: '우미린' — 공백 무관 매칭). house_manage_no와 택일이며 여럿이면 후보 목록을 돌려준다"
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구를 원장 어휘 그대로 (예: '천안시 서북구', '평택시', '서울 동작구' — 특별·광역시는 '서울 동작구'처럼 시도 접두가 붙는다). 공고를 지정하지 않고 그 지역 분포만 볼 때 쓴다"
    },
    "house_manage_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "House Manage No",
      "default": null,
      "description": "공고 관리번호 (realty_presale·realty_notice_facts 응답의 house_manage_no, 예 '2026000383')"
    },
    "exclusive_m2_max": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Exclusive M2 Max",
      "default": null,
      "description": "전용면적 상한(㎡) — 국평만 보려면 85"
    },
    "exclusive_m2_min": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Exclusive M2 Min",
      "default": null,
      "description": "전용면적 하한(㎡) — 국평만 보려면 80. 지정하면 모든 셀에 같은 필터가 걸린다"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_presale_costArguments",
  "properties": {
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword",
      "default": null,
      "description": "단지명 일부 (공백 무관)"
    },
    "house_ty": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "House Ty",
      "default": null,
      "description": "주택형 (예: '59', '84B') — 생략 시 공고의 주택형 목록을 돌려준다"
    },
    "movein_ym": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Movein Ym",
      "default": null,
      "description": "입주 년월 YYYYMM 덮어쓰기 — 공고에 입주예정이 없거나 다른 가정을 쓸 때"
    },
    "mid_rate_pct": {
      "type": "number",
      "title": "Mid Rate Pct",
      "default": 5,
      "maximum": 20,
      "description": "중도금 대출 연이율 %(기본 5.0 — 실제 금리는 공고·은행마다 다르다) (허용 범위 0 초과~20)",
      "exclusiveMinimum": 0
    },
    "house_manage_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "House Manage No",
      "default": null,
      "description": "공고 관리번호 (realty_presale의 house_manage_no)"
    },
    "extra_options_krw": {
      "type": "integer",
      "title": "Extra Options Krw",
      "default": 0,
      "minimum": 0,
      "description": "발코니 외 유상옵션 합계(원) — realty_notice_facts의 옵션가에서 골라 넣어라"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_presale_funding_planArguments",
  "required": [
    "house_manage_no",
    "own_funds_10k",
    "borrower"
  ],
  "properties": {
    "lender": {
      "enum": [
        "은행",
        "제2금융권"
      ],
      "type": "string",
      "title": "Lender",
      "default": "은행",
      "description": "업권"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "규제 판정용 지역 덮어쓰기 — 생략하면 공고 소재지로 판정한다"
    },
    "borrower": {
      "enum": [
        "무주택",
        "생애최초",
        "서민실수요",
        "1주택_처분조건부",
        "1주택_보유",
        "다주택"
      ],
      "type": "string",
      "title": "Borrower",
      "description": "잔금대출 차주 유형(사용자 선언 — realty_loan_limit과 동일 계약). 계약자 명의 기준으로 선언하라"
    },
    "house_ty": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "House Ty",
      "default": null,
      "description": "주택형 (예: '59', '84B')"
    },
    "is_metro": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Metro",
      "default": null,
      "description": "수도권 여부 직접 선언"
    },
    "movein_ym": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Movein Ym",
      "default": null,
      "description": "입주 년월 YYYYMM 덮어쓰기 — 공고에 입주예정이 없으면 이걸 안 주는 한 총 소요자금이 계산되지 않아 자금 판정도 못 한다(realty_presale_cost와 같은 계약·같은 이름). 후보는 realty_presale의 move_in_ym"
    },
    "rate_type": {
      "enum": [
        "변동",
        "혼합형",
        "주기형",
        "순수고정"
      ],
      "type": "string",
      "title": "Rate Type",
      "default": "변동",
      "description": "잔금대출 금리유형 — realty_loan_limit과 동일 계약. 기본 '변동'은 스트레스 금리 전액 가산이라 가장 보수적이다(안 닫힌다는 판정이 유형 때문일 수 있다)"
    },
    "floor_zone": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Floor Zone",
      "default": null,
      "description": "층 구분(예: '5~9층') — 생략하면 첫 밴드로 계산하고 나머지 밴드 총액을 병기한다"
    },
    "is_regulated": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Regulated",
      "default": null,
      "description": "규제지역 여부 직접 선언"
    },
    "mid_rate_pct": {
      "type": "number",
      "title": "Mid Rate Pct",
      "default": 5,
      "maximum": 20,
      "description": "중도금 대출 연이율 %(기본 5.0) (허용 범위 0 초과~20)",
      "exclusiveMinimum": 0
    },
    "own_funds_10k": {
      "type": "integer",
      "title": "Own Funds 10K",
      "minimum": 0,
      "description": "동원 가능한 자기자금(만원) — 계약금부터 잔금까지 전액 투입 가정으로 계산한다. 0도 유효하다(전액 대출 시나리오 — 계약금 게이트에서 정직하게 걸린다)"
    },
    "credit_loan_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Credit Loan 10K",
      "default": null,
      "description": "신용대출 잔액·예정액(만원) — realty_loan_limit과 동일 계약(서버가 산정만기 5년 규제식으로 계산한다). 직접 연 원리금을 계산해 넣지 마라"
    },
    "house_manage_no": {
      "type": "string",
      "title": "House Manage No",
      "description": "공고 관리번호 (realty_presale의 house_manage_no)"
    },
    "loan_term_years": {
      "type": "integer",
      "title": "Loan Term Years",
      "default": 30,
      "maximum": 50,
      "minimum": 1,
      "description": "잔금대출 만기(년) (허용 범위 1~50)"
    },
    "rate_fixed_years": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 50,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Rate Fixed Years",
      "default": null,
      "description": "혼합형 고정기간 또는 주기형 변동주기(년) — 미지정 시 5년 가정 (허용 범위 0~50)"
    },
    "annual_income_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Annual Income 10K",
      "default": null,
      "description": "차주 연소득(만원) — 주면 잔금대출의 DSR 상한까지 반영해 판정한다"
    },
    "extra_options_krw": {
      "type": "integer",
      "title": "Extra Options Krw",
      "default": 0,
      "minimum": 0,
      "description": "발코니 외 유상옵션 합계(원)"
    },
    "interest_rate_pct": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 20,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Interest Rate Pct",
      "default": null,
      "description": "잔금대출 약정금리 가정(%) (허용 범위 0 초과~20)"
    },
    "jeonse_deposit_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Jeonse Deposit 10K",
      "default": null,
      "description": "입주 시점 예상 전세보증금 선언(만원) — 주면 '세입자 보증금으로 잔금 치르기' 시나리오를 판정한다(거주의무·대출 병행 불가 게이트 포함). 시세 확인은 realty_complex_rent_by_pyeong·region_price_stats(metric=rental)"
    },
    "credit_loan_rate_pct": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 20,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Credit Loan Rate Pct",
      "default": null,
      "description": "신용대출 약정금리(%) — credit_loan_10k를 줬으면 필수 (허용 범위 0 초과~20)"
    },
    "expected_price_at_movein_10k": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Expected Price At Movein 10K",
      "default": null,
      "description": "입주(잔금) 시점 예상 시세 선언(만원) — 잔금대출 LTV는 실무상 입주시 시세·감정가 기준이라, 선언하면 그 값 기준 판정을 병렬로 준다. 서버는 미래 시세를 추정하지 않는다(선언 없으면 분양가 기준만)"
    },
    "existing_annual_debt_payment_10k": {
      "type": "integer",
      "title": "Existing Annual Debt Payment 10K",
      "default": 0,
      "minimum": 0,
      "description": "기존 대출 연간 원리금(만원)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_presale_vs_marketArguments",
  "properties": {
    "months": {
      "type": "integer",
      "title": "Months",
      "default": 12,
      "maximum": 24,
      "minimum": 3,
      "description": "실거래 비교 창(개월) (허용 범위 3~24)"
    },
    "pyeong": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Pyeong",
      "default": null,
      "description": "대조할 전용평(정수)을 직접 고른다 — 예: [26]이면 국민평형 84㎡만. 안 주면 **세대수 많은 순 상위 5개** 평형을 자동으로 고른다. comparison_truncated에 빠졌다고 적힌 평형은 이 인자로 되받아 부르면 된다(공시만 하고 길이 없으면 막다른 골목이다)"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "시도 (예: 서울, 경기, 세종)"
    },
    "keyword": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Keyword",
      "default": null,
      "description": "단지명·주소 부분일치 (예: '우미린', '5-2생활권', '다솜동')"
    },
    "house_manage_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "House Manage No",
      "default": null,
      "description": "realty_presale 응답의 공고 관리번호 — 알면 이걸로 특정하는 게 정확"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    },
    "include_price_trend": {
      "type": "boolean",
      "title": "Include Price Trend",
      "default": false,
      "description": "true면 같은 지역(공고의 시도·시군구) 분양 공고들의 **연도별 평당 분양가 추이**(realty_presale_price_trend와 같은 값)를 `price_trend`에 함께 싣는다 — '지금 넣을까, 기다릴까'"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_redevelopmentArguments",
  "properties": {
    "dong": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dong",
      "default": null,
      "description": "법정동 (예: 면목동·신길동) — 사업장 주소로 거른다. 구를 함께 주면 빠르다"
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 30,
      "maximum": 50,
      "minimum": 1,
      "description": "(허용 범위 1~50)"
    },
    "stage": {
      "anyOf": [
        {
          "enum": [
            "plan_establishment",
            "zone_designation",
            "safety_assessment",
            "committee_approval",
            "union_establishment",
            "project_approval",
            "disposal_approval",
            "sale",
            "construction_start",
            "completion",
            "relocation_notice",
            "union_dissolution"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Stage",
      "default": null,
      "description": "진행 단계 필터 — plan_establishment=정비계획 수립, zone_designation=정비구역지정, safety_assessment=안전진단, committee_approval=추진위원회승인, union_establishment=조합설립인가, project_approval=사업시행인가, disposal_approval=관리처분인가, sale=분양, construction_start=착공, completion=준공인가, relocation_notice=이전고시, union_dissolution=조합해산. 비우면 전체. 원천이 단계 코드를 안 준 사업장(조합청산·조합원 모집신고 등)은 이 필터에 안 걸린다"
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0,
      "minimum": 0,
      "description": "페이지네이션 오프셋"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "시군구 (예: 강남구) — 다른 도구와 같은 인자 이름. sigungu와 같은 뜻이다"
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 (예: 강남구). 비우면 서울 전체. region과 같은 뜻의 옛 이름(둘 중 하나만)"
    },
    "project_type": {
      "anyOf": [
        {
          "enum": [
            "reconstruction",
            "housing_redevelopment",
            "urban_redevelopment",
            "street_housing",
            "small_reconstruction",
            "small_redevelopment",
            "regional_housing",
            "remodeling"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Project Type",
      "default": null,
      "description": "reconstruction=재건축, housing_redevelopment=재개발(주택정비형), urban_redevelopment=재개발(도시정비형), street_housing=가로주택정비, small_reconstruction=소규모재건축, small_redevelopment=소규모재개발, regional_housing=지역주택, remodeling=리모델링. 비우면 전체"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_region_price_statsArguments",
  "required": [
    "region"
  ],
  "properties": {
    "top_n": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 20,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Top N",
      "default": null,
      "description": "**가격순 상위 거래 '목록'을 함께 받는다**(1~20). '신고가 상위 5개', '제일 비싸게 팔린 아파트', '고가 거래 목록'처럼 **개별 거래를 나열**하는 질문이 이 인자다 — 안 주면 이 도구는 평균·중앙·최고 같은 **집계만** 답하고 목록은 못 준다. 행에 단지·전용면적·평형·금액·계약일·층이 실린다(top_transactions). metric='price'에서만 동작한다 (허용 범위 1~20)"
    },
    "metric": {
      "enum": [
        "price",
        "rental"
      ],
      "type": "string",
      "title": "Metric",
      "default": "price",
      "description": "price=매매, rental=전월세. **평형 인자(pyeong_exclusive·pyeong_supply·area_m2_exclusive·area_m2_supply)는 price에서만 먹는다** — 전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다(전체 평형 값이 오고 warning_pyeong_fallback으로 실토한다). 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라"
    },
    "months": {
      "type": "integer",
      "title": "Months",
      "default": 12,
      "maximum": 60,
      "minimum": 1,
      "description": "조회 개월 수 (허용 범위 1~60)"
    },
    "region": {
      "type": "string",
      "title": "Region",
      "description": "지역명 — 시군구까지(예: '강남구', '수원시 권선구') 또는 **법정동까지**(예: '강남구 대치동', '세종특별자치시 나성동'). 시도 약칭은 서버가 정식명으로 펴지만('서울 마포구' → '서울특별시 마포구'), 동명 지역이 여럿이면 시도를 앞에 붙여라 — 안 붙이면 **고르지 않고 거절**하며 이름이 정확히 같은 후보 목록을 준다('동구'는 '남동구'가 아니다). 단지명은 여기 넣지 마라(단지는 realty_search_complexes·realty_complex_pyeong_price 담당)"
    },
    "by_dong": {
      "type": "boolean",
      "title": "By Dong",
      "default": false,
      "description": "시군구 안 **법정동별 중앙값**을 한 번에 함께 받는다(by_dong) — 동마다 이 도구를 따로 부르지 마라. metric='price'(매매): 평형 인자(area_m2_exclusive 등)를 주면 **동별 그 평형 매매 중앙값·건수**(동 하나에 한 행), 안 주면 법정동 × 평형대 4구간(소형<60·중소형 60~85·중형 85~115·대형 115㎡+) 중앙값과 지역 평형대 4구간 시세(이상치 필터)를 싣는다(창 상한 24개월). metric='rental': 법정동 × 전용면적대(60㎡ 미만·60~85㎡·85㎡ 초과) 전세 보증금 중앙값(평형 인자 미적용). 둘 다 표본 3건 이상 칸만 나오고 뺀 칸 수를 공시한다. region이 법정동 하나면 그 동 한 곳의 행만 온다 — 형제 동과 견주려면 region에 시군구를 넣어라"
    },
    "compare_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Compare From",
      "default": null,
      "description": "기준일 전후 비교(YYYY-MM-DD) — '○○ 발표 전후 단지별 시세'. 단지마다 전·후 창의 건수·중앙값·최고가 거래(계약일·층)·변화율이 붙는다. 단지 도구를 단지마다 부르지 마라. 창은 months 전체라 기준일 이전이 들어오게 잡아라. price 전용"
    },
    "pyeong_supply": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Pyeong Supply",
      "default": null,
      "description": "분양평수(공급면적, 평) — 흔히 말하는 '34평'이 이것이다. 내부에서 ×0.745로 전용 실평수로 환산한다. **㎡로 말했으면 area_m2_supply를 쓰라** **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라."
    },
    "area_m2_supply": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 800,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Area M2 Supply",
      "default": null,
      "description": "공급(분양)면적을 **㎡ 그대로** 받는다(예: 112.8). pyeong_supply와 동시에 주면 거절한다 **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라. (허용 범위 0 초과~800)"
    },
    "pyeong_exclusive": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Pyeong Exclusive",
      "default": null,
      "description": "전용면적 기준 **실평수(평)** — ㎡가 아니다. 전용 84㎡면 25.4를 넣는다. **사용자가 ㎡로 말했으면 이 인자가 아니라 area_m2_exclusive를 쓰라** (㎡ 값을 여기 넣으면 60평 초과로 거절된다). 1평=3.3058㎡ **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라."
    },
    "area_m2_exclusive": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 500,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Area M2 Exclusive",
      "default": null,
      "description": "전용면적을 **㎡ 그대로** 받는다(예: 84, 59, 114.98). 사용자가 '전용 84㎡'라고 말했으면 환산하지 말고 84를 여기 넣어라 — 서버가 평으로 환산하고 그 사실을 응답에 적는다. pyeong_exclusive와 동시에 주면 거절한다 **전월세(metric='rental') 통계는 평형별로 나뉘어 있지 않아 평형 인자가 적용되지 않는다** — 주면 전체 평형 기준 값이 오고 warning_pyeong_fallback으로 실토한다. 평형별 전월세는 단지 단위 realty_complex_rent_by_pyeong으로 조회하라. (허용 범위 0 초과~500)"
    },
    "include_footnotes": {
      "type": "boolean",
      "title": "Include Footnotes",
      "default": false,
      "description": "true면 계산값 근거 전문(산식·모집단·기간·원천)을 footnotes에 싣는다. 기본은 행마다 한 줄 요지"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_search_auctionsArguments",
  "properties": {
    "sido": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sido",
      "default": null,
      "description": "시도. '서울'처럼 줄여 써도 되고 '서울특별시'도 된다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
    },
    "sort": {
      "enum": [
        "date_desc",
        "date_asc",
        "price_asc",
        "price_desc",
        "bid_count_desc"
      ],
      "type": "string",
      "title": "Sort",
      "default": "date_desc",
      "description": "정렬 기준"
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "반환 개수 (최대 50) (허용 범위 1~50)"
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Since",
      "default": null,
      "description": "이 날짜(YYYY-MM-DD, 31일 전까지) 이후 바뀐 것만 — 예약 실행에서 '어제 이후'면 since=어제. 기준·지연은 응답에"
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0,
      "minimum": 0,
      "description": "페이지 오프셋. has_more가 true면 next_offset으로 다시 호출하라."
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 (예: 강남구, 성남시) ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
    },
    "usage_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Usage Name",
      "default": null,
      "description": "물건 종류 — 원장 값 예: 아파트·오피스텔·다세대·연립주택·단독주택·다가구주택·근린시설·상가·대지·임야·전답. 부분일치라 '빌라'는 '연립주택,다세대,빌라' 행에 걸린다. **'토지'는 이 원장에 없는 이름이다** — 대지·임야·전답으로 나뉘어 있어 그대로 넣으면 서버가 사유와 유효값 목록을 들어 거절한다. 비우면 전 종류"
    },
    "exclude_past": {
      "type": "boolean",
      "title": "Exclude Past",
      "default": false,
      "description": "매각기일이 이미 지난 행 제외 여부. 기본 False(전체 반환 — 지난 기일 행에는 past_auction_note 플래그가 붙는다). '지금 입찰 가능한 물건' 질문이면 True로 호출하라 — 오늘 이후 기일(기일 미정 포함)만 남는다."
    },
    "max_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Price 10K",
      "default": null,
      "description": "최대 감정가, **만원** 단위"
    },
    "min_bid_count": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 100,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Bid Count",
      "default": null,
      "description": "최소 유찰 횟수. 유찰이 쌓일수록 최저입찰가가 내려간다. (허용 범위 0~100)"
    },
    "min_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Price 10K",
      "default": null,
      "description": "최소 감정가, **만원** 단위 (5억이면 50000)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_search_onbidArguments",
  "properties": {
    "sido": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sido",
      "default": null,
      "description": "시도. '서울'처럼 줄여 써도 되고 '서울특별시'도 된다. ⚠️ '광주'는 광주광역시와 경기도 광주시 둘 다라 **한쪽으로 읽지 않고 거절한다**(error='sido_ambiguous') — 광역시면 '광주광역시', 경기도 광주시면 sido='경기도'·sigungu='광주시'로 갈라 넣어라."
    },
    "sort": {
      "enum": [
        "deadline",
        "price_asc",
        "price_desc",
        "discount"
      ],
      "type": "string",
      "title": "Sort",
      "default": "deadline",
      "description": "deadline=마감 임박순 · price_asc/desc=감정가순 · discount=감정가 대비 최저가가 낮은 순(저감 많이 된 순)"
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "반환 **물건** 수 (최대 50) (허용 범위 1~50)"
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0,
      "minimum": 0,
      "description": "페이지 오프셋. has_more면 next_offset으로 다시 호출하라."
    },
    "sigungu": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sigungu",
      "default": null,
      "description": "시군구 (예: 춘천시, 강남구). 부분일치다 — '고양시'는 '고양시 덕양구'도 잡는다. ⚠️ 시도 없이 시군구만 주면 **합치지 않고 거절한다**(error='region_ambiguous') — '중구'처럼 여러 시도에 같은 이름이 있으면 합친 값은 어느 지역의 것도 아니다. sido와 갈라 넣어라(예: sido='서울특별시'·sigungu='중구'). 거절 응답이 후보를 준다."
    },
    "open_only": {
      "type": "boolean",
      "title": "Open Only",
      "default": true,
      "description": "입찰 마감이 아직 안 지난 회차가 남은 물건만. 기본 True — 원장에는 이미 끝난 회차 행이 함께 들어 있어서(물건 25,669개 중 마감 전 회차가 남은 것은 10,327개), 끄면 지금 입찰할 수 없는 물건이 섞인다. cltr_mng_no로 특정 물건을 볼 때는 무시된다."
    },
    "usage_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Usage Name",
      "default": null,
      "description": "용도 부분일치(대·중·소 3단을 한꺼번에 건다). 중분류 5종은 토지·주거용건물·상가용및업무용건물·용도복합용건물·산업용및기타특수용건물이고 소분류는 91종이다. **'아파트'는 소분류라 중분류로는 안 걸린다** — 넓게 보려면 '주거용건물'. 원장 값 예: 주거용건물·아파트·다세대주택·대지·상가주택. 경매 어휘 '전답'은 여기 없다(전·답으로 갈렸다) — 없는 이름은 거절하며 쓸 수 있는 값을 준다."
    },
    "cltr_mng_no": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cltr Mng No",
      "default": null,
      "description": "물건관리번호(예 '2026-0600-031235')로 한 물건만. **이것이 상세 조회다** — 이 원장은 행이 물건이 아니라 회차라, 한 물건의 상세는 곧 그 물건의 회차 전부이고 그때 `rounds`에 회차별 최저입찰가 일정이 실린다. 법원 사건번호(2025타경…)는 여기 넣지 마라."
    },
    "max_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Price 10K",
      "default": null,
      "description": "최대 감정가, **만원** 단위"
    },
    "min_price_10k": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Price 10K",
      "default": null,
      "description": "최소 감정가, **만원** 단위 (5억이면 50000)"
    },
    "property_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Property Type",
      "default": null,
      "description": "재산구분 — 공매에서 가장 중요한 축이다. 압류재산(체납처분·국세징수법)·국유재산·공유재산·기타일반재산·수탁재산·불용품. **성격이 완전히 다르다**: 압류재산은 체납자 재산의 강제매각이고 나머지는 공공이 가진 재산의 처분·임대다."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_small_deposit_checkArguments",
  "properties": {
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "물건 소재지. '서울', '경기도 부천시', '부산광역시 기장군'처럼 시도를 붙이면 확실하다. 비우면 그 판의 **전 구간 표**를 그대로 준다"
    },
    "deposit_10k": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "title": "Deposit 10K",
      "default": null,
      "description": "임차보증금(**만원**). 주면 그 판의 '소액임차인 범위' 상한과 대조해 **범위에 드는지의 산수**만 한다 — 최우선변제를 받는다는 판정이 아니다"
    },
    "security_right_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Security Right Date",
      "default": null,
      "description": "**최선순위 담보물권(근저당 등)의 설정일** YYYY-MM-DD. 금액표를 고르는 기준일이다 — '오늘'도 '임대차계약일'도 아니다(각 개정 시행령 부칙 경과조치: '이 영 시행 전에 임차주택에 대하여 담보물권을 취득한 자에 대해서는 종전의 규정에 따른다'). 등기부 을구에서 확인한다. **모르면 비워 두라 — 서버가 현행표를 답인 척 주지 않는다**. ⚠️ **연도만 아는 경우 날짜를 지어내지 마라** — '2019년'만 들었으면 '2019-01-01'을 만들지 말고 security_right_year=2019를 쓰라. 그 해 전체가 한 시행령 판 안이면 서버가 날짜 없이 답하고, 판이 갈리는 해면 월·일을 되묻는다"
    },
    "security_right_year": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 2200,
          "minimum": 1900
        },
        {
          "type": "null"
        }
      ],
      "title": "Security Right Year",
      "default": null,
      "description": "**최선순위 담보물권 설정 '연도'만** 알 때 쓴다(예: 2019). 사용자가 연도만 말했을 때 security_right_date에 임의의 날짜를 지어 넣는 대신 여기에 연도를 그대로 넣어라 — 그 해 전체가 한 시행령 판 안에 있으면 월·일 없이도 표가 정해지고(응답이 그 근거를 밝힌다), 판이 갈리는 해면 표를 고르지 않고 등기 접수일을 되묻는다 (허용 범위 1900~2200)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "realty_supply_pipelineArguments",
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "사업 목록 상한 (기본 30) (허용 범위 1~100)"
    },
    "to_ym": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "To Ym",
      "default": null,
      "description": "YYYYMM (기본 from_ym+60개월)"
    },
    "months": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 120,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Months",
      "default": null,
      "description": "from_ym부터 **몇 개월**을 볼지 — to_ym 대신 쓰는 간편 인자(예: 24). to_ym과 함께 주면 오류다(realty_move_in_supply와 같은 계약) (허용 범위 1~120)"
    },
    "region": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region",
      "default": null,
      "description": "지역 — 시도·시군구·동 부분일치 (예: '세종', '세종특별자치시 합강동', '수원시'). ⚠️ 짝 도구 realty_move_in_supply의 region은 **시도 전용**이다 — 인자를 그대로 옮겨 부르지 마라"
    },
    "from_ym": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "From Ym",
      "default": null,
      "description": "YYYYMM (기본 이번 달)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "title": "report_issueArguments",
  "properties": {
    "kind": {
      "enum": [
        "결함",
        "질문기록"
      ],
      "type": "string",
      "title": "Kind",
      "default": "결함",
      "description": "'결함'=사용자가 답이 틀렸다고 제보해 달라고 한 경우(기본). '질문기록'=사용자가 '이런 질문에도 답하게 해 달라'·'이 데이터도 넣어 달라'처럼 **개선 요청을 전해 달라고 한 경우** — 그 질문과 무엇이 없었는지를 넘긴다(응답에 그 질문이 어느 도구 축에 해당하는지가 `routing`으로 함께 온다). 사용자가 요청하지 않은 질문을 기록용으로 넘기지 않는다"
    },
    "problem": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Problem",
      "default": null,
      "description": "사용자가 제보한 문제. 사용자가 지적한 말을 그대로 옮겨도 된다. kind='결함'이면 필수, kind='질문기록'이면 비워도 된다."
    },
    "expected": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Expected",
      "default": null,
      "description": "사용자가 맞다고 본 값이 있으면"
    },
    "question": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Question",
      "default": null,
      "description": "사용자가 제보·개선 요청과 함께 전해 달라고 한 질문(kind='질문기록'이면 필수). ⚠️ **개인 식별 조합은 일반형으로 바꿔서 넣는다** — 소득·보유자산·보유단지·거주지 중 둘 이상이 겹치면 그대로 적지 말 것(예: '○○아파트 33평 보유 + 주식 10억 + 잠실 거주' → '1주택 보유(대출 없음), 인근 재건축 단지로 갈아타기'). 무인증 공개 서버의 로그다"
    },
    "tool_used": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Tool Used",
      "default": null,
      "description": "문제가 된 답을 만든 도구 이름"
    },
    "wrong_value": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Wrong Value",
      "default": null,
      "description": "틀린 수치·문장"
    },
    "missing_axis": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Missing Axis",
      "default": null,
      "description": "answered_fully=false일 때 **없어서 못 답한 것**(예: '단지별 구조형식(벽식/라멘) 라벨 없음', '경기 정비사업 단계 조회 불가 — 서울 한정')"
    },
    "answered_fully": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Answered Fully",
      "default": null,
      "description": "kind='질문기록' 전용 — 이 서버 도구만으로 그 질문에 완결된 답을 했는가. false면 missing_axis에 무엇이 없었는지 적는다"
    }
  },
  "additionalProperties": false
}