종합부동산웹앱 API 연결 감사와 정비사업 공식 데이터 구현
질의 원문
모두 api 연결이 되어 있는 것 아니야? 지금 모두 나머지 작업 진행해줘.
수집 경로와 시점
- 수집시점: 2026-08-12 08:16 KST
- 로컬 코드/문서 감사:
src/realestate/collectors/api_audit.py,src/realestate/collectors/datagokr.py,src/realestate/collectors/external_apis.py,docs/BACKLOG.md,docs/DATA_SOURCES.md - 실행 명령:
PYTHONPATH=src python -m realestate.cli api-auditPYTHONPATH=src python -m realestate.cli collect-redev-national --region 서울 --top 5PYTHONPATH=src python -m realestate.cli ext-apis --kosis-pop-move 5PYTHONPATH=src python -m realestate.cli collect-seoul-redev --region 중랑 --top 5- 공식 확인 경로:
- KOSIS 국내인구이동통계: <https://kosis.kr/statHtml/statHtml.do?conn_path=I3&orgId=101&tblId=DT_1B26002>
- 서울 열린데이터광장 OA-22856 정비사업 추진현황: <https://data.seoul.go.kr/dataList/OA-22856/L/1/datasetView.do>
- 국토교통부 전국 도시정비사업 통합 데이터: <https://www.data.go.kr/data/15160169/fileData.do>
- 공식 CSV 다운로드: <https://www.data.go.kr/cmm/cmm/fileDownload.do?atchFileId=FILE_000000003667489&fileDetailSn=1&insertDataPrcus=N>
데이터 등급
| 항목 | 등급 | 판정 |
|---|---|---|
| 로컬 API 감사 결과 | 내부 파생 | 코드 경로, 키 존재 여부, endpoint 등재 상태를 종합한 감사 결과 |
| 국토교통부 전국 도시정비사업 통합 데이터 | 1차 공공원본 | data.go.kr 공식 파일/API 데이터. 파일은 키 없이 다운로드 가능 |
| KOSIS 국내인구이동통계 | 1차 공공원본 | DT_1B26002, itmId=T60, 성별 계, 연령 계 조합으로 최신월 순이동 수집 연결 |
| 서울 OA-22856 정비사업 추진현황 | 1차 공공원본 | 공식 xlsx 파일 다운로드 POST 경로를 확인하고 수집기 연결 |
| 정비사업 후보 랭킹 | 파생/스크리닝 | 공식 CSV의 추진단계·유형·공급 예정 세대수만 사용한 후보 선별 |
답변 요약
“전부 API 연결 완료”는 아니다. 최초 감사 결과는 총 30건 중 연결완료 15건, 부분연결 11건, 목록만 3건, 수동확인 1건이었다. 이어서 KOSIS 순이동과 서울 OA-22856 파일 수집기를 추가한 뒤 최신 감사 결과는 연결완료 17건, 부분연결 10건, 목록만 2건, 수동확인 1건이다.
연결완료는 코드 경로와 endpoint 또는 공식 파일 수집 경로가 있다는 뜻이다. 키가 등록되어도 서비스별 활용신청, 응답 스키마 확인, 로그인/결제 권한이 없으면 실호출은 실패할 수 있다. 실패한 데이터는 가짜 값으로 채우지 않고 SourceUnavailable 또는 수동확인으로 남긴다.
이번에 진행한 작업
- API 감사기를 추가해 연결완료, 부분연결, 목록만, 수동확인을 분리했다.
api-auditCLI를 추가해reports/api_readiness.md를 생성한다.- 국토교통부 전국 도시정비사업 통합 데이터 공식 CSV 수집기를 추가했다.
collect-redev-nationalCLI를 추가해 공식 CSV 1,566건을 후보풀로 읽고, 조건별 재개발·재건축 투자 후보 리포트를 만든다.api-audit에 전국 정비사업 통합 데이터를 연결완료 항목으로 반영했다.- KOSIS 국내인구이동통계 전용 함수
fetch_kosis_population_move()를 추가하고,ext-apis --kosis-pop-move리포트를 생성했다. - 서울 열린데이터광장 OA-22856 정비사업 xlsx 수집기와
collect-seoul-redevCLI를 추가했다. api-audit에 KOSIS 순이동과 서울 정비사업 추진현황을 연결완료로 승격했다.
공식 정비사업 CSV 확인 결과
- 원천: 국토교통부 전국 도시정비사업 통합 데이터
- 공개 형태: 파일/API 데이터
- 공식 파일 등록일: 2026-07-01
- 공식 파일 수정일: 2026-07-02
- 전체 행 수: 1,566건
- 주요 필드: 시도, 시군구, 구역명칭, 현 사업 추진단계, 사업유형, 사업시행자, 공급 예정 세대 수
- 실제 수집 결과: 공식 CSV를 내려받아 서울 조건으로 상위 5건 리포트를 생성했다.
서울 조건 예시 결과
collect-redev-national --region 서울 --top 5 실행 결과 상위 후보는 모두 추진단계가 착공인 대규모 정비사업으로 점수화되었다.
| 순위 | 후보 | 지역 | 유형 | 단계 | 예정세대수 | 점수 |
|---|---|---|---|---|---|---|
| 1 | 이문3재정비촉진(3-1지구,3-2지구) | 서울 동대문구 | 재개발 | 착공 | 4,321 | 82.4 |
| 2 | 반포주공1단지(1,2,4주구) | 서울 서초구 | 재건축 | 착공 | 5,007 | 82.4 |
| 3 | 방배5 | 서울 서초구 | 재건축 | 착공 | 3,064 | 82.4 |
| 4 | 장위4재정비촉진 | 서울 성북구 | 재개발 | 착공 | 2,840 | 82.4 |
| 5 | 갈현제1 | 서울 은평구 | 재개발 | 착공 | 4,116 | 82.4 |
KOSIS 순이동 확인 결과
ext-apis --kosis-pop-move 5 실행 결과 최신 기준월은 2026년 6월이었다.
| 순위 | 지역 | 지역코드 | 기준월 | 순이동 |
|---|---|---|---|---|
| 1 | 경기도 | 41 | 202606 | +5,161명 |
| 2 | 인천광역시 | 28 | 202606 | +2,229명 |
| 3 | 서구 | 28260 | 202606 | +2,196명 |
| 4 | 평택시 | 41220 | 202606 | +1,271명 |
| 5 | 파주시 | 41480 | 202606 | +1,259명 |
순이동은 수요 보조지표다. 지역명 중복이 있을 수 있으므로 리포트에는 지역코드를 함께 표기하도록 했다.
서울 OA-22856 중랑 조건 예시 결과
collect-seoul-redev --region 중랑 --top 5 실행 결과 공식 xlsx 원본 후보는 473건이었다.
| 순위 | 후보 | 지역 | 단계 | 점수 |
|---|---|---|---|---|
| 1 | 상봉9 | 서울 중랑구 | 착공 | 68.8 |
| 2 | 중화3 | 서울 중랑구 | 착공 | 68.8 |
| 3 | 상봉7 | 서울 중랑구 | 사업시행인가 | 62.0 |
| 4 | 망우1(염광아파트) | 서울 중랑구 | 조합설립인가 | 54.4 |
| 5 | 면목7구역 | 서울 중랑구 | 조합설립인가 | 54.4 |
일부 행은 사업유형 또는 건립세대수가 비어 있어 규모점수는 중립·소표본 보수값으로 처리했다.
가정
- 공식 CSV의 단계 표기는 최신 원문 파일 기준으로 받아들이되, 개별 구역의 조합원 지위·권리산정일·분담금은 별도 원문 확인 전까지 확정하지 않는다.
- 후보 점수는 추진단계, 예정세대수, 기존 재개발·재건축 랭킹 엔진의 중립 사업성 가정을 사용한다.
- 용적률·대지면적·종전자산·비례율이 없으면 사업성은 중립점으로 둔다.
한계·미확인
- 정비사업 CSV는 투자 후보 선별용이다. 권리산정일, 조합원 지위, 종전자산 감정평가, 비례율, 추가분담금은 제공하지 않는다.
- 서울 OA-22856은 공식 파일 데이터로 연결했지만 파일명·seq가 바뀌면 다운로드 POST 파라미터를 다시 확인해야 한다.
- KOSIS 순이동은 최신월 총계 연결까지 완료했지만 주민등록 세대수 등 다른 수요 지표는 별도 통계표 파라미터 확정이 남았다.
- 온비드는 endpoint는 있으나 실제 활용신청 후 응답 필드명을 스키마 테스트로 잠가야 한다.
- 개별 등기사항증명서는 공동인증서 로그인과 건당 결제가 필요하므로 대량 자동화 대상이 아니다.
설계 결정
- API 연결 상태를 “키 있음” 하나로 보지 않고, 코드 경로·endpoint·실호출 가능성·수동권한 필요성을 분리한다.
- 공식 파일 데이터도 안정적으로 반복 수집 가능하면 연결완료로 본다. 단, 파일의 한계를 리포트와 감사표에 명시한다.
- 정비사업 후보 자동화는 공식 CSV로 넓게 후보를 만들고, 개별 투자 판단은 원문 확인 체크리스트와 연결한다.
- 서울권 정비사업은 전국 CSV와 서울 OA-22856을 병행한다. 전국 CSV는 공급 예정 세대수 중심, 서울 파일은 자치구·추진단계·건립세대수 중심으로 서로 보완한다.
- 추정값을 사실처럼 쓰지 않기 위해, 분담금·권리산정일·조합원 지위는 이번 자동 수집 결과에 포함하지 않는다.