종합부동산웹앱 임대사업 정보원 추가
질의 원문
부분연결 10건, 목록 2건, 수동1건은 무엇이고 왜 생긴거지? 그리고 정비 목록은 공개 csc만 있으면 충분한거야? api 호출이 필요 없는 거야? 그리고 정부에서 임대 사업 정보 및 지자체의 임대사업 정보도 추가로 넣어줘.
진행해
수집 경로와 시점
- 수집시점: 2026-08-12 10:10 KST
- 로컬 감사 결과:
PYTHONPATH=src python -m realestate.cli api-audit - 로컬 카탈로그 확인:
PYTHONPATH=src python -m realestate.cli data-apis - 공식 확인 경로:
- 국토교통부 마이홈 공공주택 모집공고: <https://www.data.go.kr/data/15108420/openapi.do>
- 국토교통부 마이홈 공공임대주택 단지정보: <https://www.data.go.kr/data/15110581/openapi.do>
- 국토교통부 마이홈 예비입주자 대기현황: <https://www.data.go.kr/data/15108378/openapi.do>
- 마이홈 3종 OpenAPI 공지: <https://www.data.go.kr/bbs/ntc/selectNotice.do?originId=NOTICE_0000000004765>
- LH 국민임대 기존임대주택 목록: <https://www.data.go.kr/data/15084926/fileData.do?recommendDataYn=Y>
- 전북개발공사 지역별 임대주택 계약금액: <https://www.data.go.kr/data/15131850/openapi.do>
- 경기주택도시공사 경기도 시군구별 건설형 공공임대주택 현황: <https://www.data.go.kr/data/15159838/fileData.do>
- 경기도 이천시 임대사업자등록현황: <https://www.data.go.kr/data/15103475/fileData.do>
- 부산광역시 강서구 임대사업자등록 현황: <https://www.data.go.kr/data/15025794/fileData.do?recommendDataYn=Y>
- 부산광역시 기장군 임대사업자 현황: <https://www.data.go.kr/data/15023429/fileData.do>
- 서울특별시 동작구 임대주택현황: <https://www.data.go.kr/data/15040538/fileData.do>
데이터 등급
| 항목 | 등급 | 판정 |
|---|---|---|
| API 연결 준비도 감사 | 내부 파생 | 코드 경로, endpoint, 키 필요 여부, 수동권한 필요 여부를 종합한 로컬 감사 |
| 마이홈 공공주택 모집공고·공공임대 단지·예비입주자 | 1차 공공원본 | data.go.kr 국토교통부 OpenAPI. 활용신청과 파라미터 확인 필요 |
| LH 국민임대 기존임대주택 목록 | 1차 공공원본 | data.go.kr 파일데이터. 파일은 로그인 없이 다운로드 가능하고 자동변환 OpenAPI는 활용신청 필요 |
| GH·전북개발공사 공공임대 현황·임대조건 | 1차 공공원본 | 지방공사 제공 공식 파일/OpenAPI |
| 이천·부산 강서·부산 기장·서울 동작 임대사업/임대주택 현황 | 1차 공공원본 | 지자체 제공 공식 파일데이터. 지자체별 기준일과 필드 차이 존재 |
부분연결·목록만·수동확인의 의미
이전 감사의 부분연결 10건은 “키 또는 범용 수집 함수, 혹은 공식 목록은 있으나 바로 투자 지표로 쓰기에는 endpoint, 활용신청, 응답 스키마, 파라미터 확정이 남은 항목”이었다.
| 상태 | 기존 항목 | 생긴 이유 |
|---|---|---|
| 부분연결 10건 | 철도역정보, 열차운행정보, 도로교통량, 항만시설, 경사연 연구정보, 행안부 정책연구, KOSIS 주민등록 세대수, 온비드 공매, 금융상품통합비교공시, 학교알리미/NEIS | 공식 원천 또는 후보는 확인됐지만, 서비스별 활용신청·오퍼레이션 URL·파라미터·스키마 검증이 아직 남음 |
| 목록만 2건 | 서울 건축인허가, 지방행정 인허가 데이터(localdata) | 카탈로그 등재 수준이며 전용 수집기와 필드 매핑이 없음 |
| 수동확인 1건 | 개별 등기사항증명서 | 공동인증서 로그인과 건당 결제가 필요해 대량 자동화 대상이 아님 |
따라서 “키가 있다”와 “투자 판단에 자동 연결됐다”는 다르다. 이 프로젝트에서는 실패한 원천을 가짜 값으로 채우지 않고 부분연결 또는 수동확인으로 남긴다.
정비사업 공개 CSV 판단
공개 CSV와 xlsx만으로도 넓은 후보 스크리닝은 충분하다. 국토부 전국 정비사업 CSV와 서울 OA-22856 xlsx는 추진단계, 사업유형, 구역명, 예정 세대수 같은 1차 후보풀을 안정적으로 준다. 파일 다운로드 경로가 안정적이고 반복 수집 가능하면 별도 API 호출이 없어도 “연결완료”로 본다.
다만 최종 투자 판단에는 충분하지 않다. 공개 목록에는 권리산정일, 조합원 지위, 종전자산 감정평가, 비례율, 추가분담금, 개별 물건 편입 여부가 없거나 제한적이다. 그래서 정비사업은 “파일 기반 후보 스크리닝 → 정보몽땅/조합/공람안/고시 원문 확인” 흐름으로 분리한다.
추가한 임대사업·공공임대 정보원
이번 작업으로 datagokr.CATALOG에 임대사업/공공임대 카테고리 10건을 추가했다.
| 구분 | 키 | 공식 데이터 | 데이터ID | 현재 상태 |
|---|---|---|---|---|
| 정부 | 마이홈공공주택모집공고 | 국토교통부_마이홈포털 공공주택 모집공고 조회 서비스 | 15108420 | 부분연결 |
| 정부 | 마이홈공공임대단지 | 국토교통부_마이홈포털 공공임대주택 단지정보 조회 서비스 | 15110581 | 부분연결 |
| 정부 | 마이홈예비입주자대기 | 국토교통부_마이홈포털 예비입주자 대기현황 조회서비스 | 15108378 | 부분연결 |
| 정부·공공기관 | LH국민임대기존주택 | 한국토지주택공사_(국민임대)마이홈포털 기존임대주택 목록 | 15084926 | 부분연결 |
| 지방공사 | 전북공공임대계약금액 | 전북개발공사_지역별 임대주택 청약 면적 대비 계약 금액 조회 서비스 | 15131850 | 부분연결 |
| 지방공사 | 경기건설형공공임대 | 경기주택도시공사_경기도 시군구별 건설형 공공임대주택 현황 | 15159838 | 부분연결 |
| 지자체 | 이천임대사업자등록 | 경기도 이천시_임대사업자등록현황 | 15103475 | 부분연결 |
| 지자체 | 부산강서임대사업자등록 | 부산광역시_강서구_임대사업자등록 현황 | 15025794 | 부분연결 |
| 지자체 | 부산기장임대사업자현황 | 부산광역시_기장군_임대사업자 현황 | 15023429 | 부분연결 |
| 지자체 | 서울동작임대주택현황 | 서울특별시_동작구_임대주택현황 | 15040538 | 부분연결 |
구현 결과
src/realestate/collectors/datagokr.py의 범용 data.go.kr 카탈로그에rental카테고리를 추가했다.src/realestate/collectors/api_audit.py에서 임대사업/공공임대 후보를 부분연결로 감사하고, 공공임대와 민간 등록임대의 한계를 별도 문구로 남기게 했다.tests/test_datagokr.py와tests/test_api_audit.py에 임대사업 카탈로그와 API 감사 회귀 테스트를 추가했다.api-audit최신 결과는 총 40건, 연결완료 17건, 부분연결 20건, 목록만 2건, 수동확인 1건이다. 부분연결이 10건에서 20건으로 늘어난 것은 임대 정보원 10건을 새로 후보풀에 넣었기 때문이다.reports/api_readiness.md와reports/investment_board.html을 재생성했다.
가정
- 임대사업/공공임대 정보원은 먼저 후보풀과 공급·임대조건 보조지표로 등록하고, 실제 수집기는 활용신청 후 오퍼레이션 URL 또는 파일 다운로드 경로를 확정한 뒤 붙인다.
- 공공임대 공급·대기·임대조건은 민간 투자 판단에서 “수요·공급 압력 보조지표”로 사용한다.
- 지자체 임대사업자등록 현황은 지역 내 민간 등록임대 재고와 제도권 임대 비중을 보는 보조지표로 사용한다.
한계·미확인
- 마이홈 3종은 OpenAPI가 확인됐지만 활용신청 후 실제 오퍼레이션 URL과 파라미터 조합을 테스트로 잠가야 한다.
- 파일데이터의 자동변환 OpenAPI는 활용신청이 필요하며, 파일 다운로드와 API 응답 스키마가 다를 수 있다.
- 지자체 임대사업자 데이터는 기준일, 전출·폐업 제외 여부, 주소 마스킹, 개인 정보 공란 처리, 필드명이 서로 다르다. 전국 합산 전에는 표준화가 필요하다.
- 공공임대 모집공고와 LH 임대주택 데이터는 실제 청약 가능 여부, 입주자격, 임대조건을 원문 공고와 LH/마이홈에서 다시 확인해야 한다.
- 임대사업자등록 현황은 개별 매물의 임대차 안정성이나 보증금 반환 가능성을 확정하지 않는다. 등기, 전입세대, 확정일자, 보증보험 가능 여부는 별도 원문 확인 대상이다.
설계 결정
- 임대사업/공공임대는 가격 자동 갱신이 아니라 수요·공급·정책성 보조 데이터로 분리한다.
- 새 정보원은 endpoint가 아직 확정되지 않았으므로 연결완료로 과장하지 않고 부분연결로 표기한다.
- 공공임대 계열은 “임대주택 공급·보증금·월임대료 지표”, 민간 등록임대 계열은 “지자체 등록임대 현황 지표”로 후속 수집기를 나눈다.
- 공개 파일 데이터는 반복 수집 가능한 경우 API와 같은 실무 효용을 가지지만, 원문에 없는 투자 핵심값은 자동 추정하지 않는다.
원문 Markdown: docs/analysis/2026-08-12-종합부동산웹앱-임대사업정보원-추가.md