청약홈 분양정보 MCP 서버

한국부동산원의 청약홈 분양정보 조회 서비스를 MCP(Model Context Protocol)로 제공하는 서버입니다.

설치

npm install -g @minjunkwon/houselotto-mcp-server

Claude Desktop 설정

Claude Desktop의 설정 파일(~/Library/Application Support/Claude/claude_desktop_config.json)에 다음과 같이 추가하세요:

{
  "mcpServers": {
    "houselotto": {
      "command": "npx",
      "args": ["@minjunkwon/houselotto-mcp-server"]
    }
  }
}

또는 글로벌 설치 후:

{
  "mcpServers": {
    "houselotto": {
      "command": "houselotto-mcp-server"
    }
  }
}

사용 가능한 도구

1. apt_detail - APT 분양정보 상세조회

• 아파트, 민간사전청약, 신혼희망타운의 분양정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no, house_secd, house_dtl_secd, subscrpt_area_code, subscrpt_area_code_nm, rcrit_pblanc_de_start, rcrit_pblanc_de_end

2. urbty_ofctl_detail - 오피스텔/도시형/민간임대 분양정보 상세조회

• 오피스텔, 도시형생활주택, 민간임대, 생활숙박시설의 분양정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no, search_house_secd, subscrpt_area_code, rcrit_pblanc_de_start, rcrit_pblanc_de_end

3. remndr_detail - APT 잔여세대 분양정보 상세조회

• 무순위 및 불법행위 재공급 잔여세대 정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no, house_secd, subscrpt_area_code, rcrit_pblanc_de_start, rcrit_pblanc_de_end

4. apt_model - APT 분양정보 주택형별 상세조회

• 특정 아파트의 주택형별 상세 정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no

5. urbty_ofctl_model - 오피스텔/도시형 주택형별 상세조회

• 특정 오피스텔/도시형의 주택형별 정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no

6. remndr_model - APT 잔여세대 주택형별 상세조회

• 특정 잔여세대의 주택형별 정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no

7. pbl_pvt_rent_detail - 공공지원 민간임대 분양정보 상세조회

• 공공지원 민간임대 분양정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no, subscrpt_area_code, rcrit_pblanc_de_start, rcrit_pblanc_de_end

8. pbl_pvt_rent_model - 공공지원 민간임대 주택형별 상세조회

• 공공지원 민간임대의 주택형별 정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no

9. opt_detail - 임의공급 분양정보 상세조회

• 임의공급 분양정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no, subscrpt_area_code, rcrit_pblanc_de_start, rcrit_pblanc_de_end

10. opt_model - 임의공급 주택형별 상세조회

• 임의공급의 주택형별 정보를 조회합니다.
• 파라미터: house_manage_no, pblanc_no

지역 코드

• 서울: 100
• 강원: 200
• 대전: 300
• 충남: 312
• 세종: 338
• 충북: 360
• 인천: 400
• 경기: 410
• 광주: 500
• 전남: 513
• 전북: 560
• 부산: 600
• 경남: 621
• 울산: 680
• 제주: 690
• 대구: 700
• 경북: 712

주택구분 코드

APT 관련

• 01: APT
• 09: 민간사전청약
• 10: 신혼희망타운

오피스텔/도시형 관련

• 0201: 도시형생활주택
• 0202: 오피스텔
• 0203: 민간임대
• 0204: 생활형숙박시설

기타

• 04: 무순위 (잔여세대)
• 06: 불법행위 재공급
• 03: 공공지원민간임대
• 11: 임의공급

날짜 형식

• APT 관련: YYYY-MM-DD 형식
• 공공지원민간임대, 임의공급: YYYYMMDD 형식

금액 정보 해석

이 서비스에서 제공하는 분양가 정보는 만원 단위입니다.

예시

• 198,000 → 1억 9천 8백만원
• 350,000 → 3억 5천만원
• 125,500 → 1억 2천 5백 50만원

계산 방법

표시된 숫자에 **만원(10,000원)**을 곱하면 실제 금액이 됩니다.

사용 예시

Claude Desktop에서 다음과 같이 질문할 수 있습니다:

• "서울 지역의 최근 APT 분양정보를 조회해줘"
• "주택관리번호 2022000248인 아파트의 상세정보를 알려줘"
• "경기도의 오피스텔 분양정보를 찾아줘"
• "최근 공공지원 민간임대 정보를 조회해줘"