집콕맵 - 서울 아파트 실거래가·학군·학원비·출퇴근 시간 지도

👉 https://jipkokmap.kr (서울 6,809개 단지)

본인 예산에 맞는 학군지 아파트를 찾도록 돕는 모바일 우선 웹앱. 설치·로그인 없이 바로 씁니다.

기능	설명
동네 학원비	교육청 공시 교습비로 계산한 단지 반경 1km 월 학원비 중앙값 (강남 36만 vs 강북 19.8만)
예산별 학군지	같은 가격대 안에서의 학군 순위 — "내 6억으로 갈 수 있는 최고 학군"
출퇴근 시간	회사 역을 넣으면 지하철 소요 시간 계산, 맞벌이 두 곳 동시 조건
공사 중 예정역	동북선 등 공사 중 노선 예정역 도보권 단지
배정 초등학교	공식 학구도 기준 배정 학교, 통학 거리, 학급당 인원
실거래·전세가율	국토교통부 실거래가, 갭, 상승·위험 신호

데이터 출처와 계산 방식은 지표 설명에 전부 공개돼 있습니다.

정적 파일(HTML/JS) + Python 파이프라인으로 만듭니다.

구조

pipeline/
  fetch_trades.py    국토교통부 실거래가 API -> data/raw/trades_*.json  (DATA_GO_KR_KEY 필요)
  fetch_roads.py     OSM Overpass -> app/data/roads.geojson (큰길/골목/인도 분류, 키 불필요)
  fetch_poi.py       OSM Overpass -> data/raw/poi.json (지하철역, 초등학교 위치)
  fetch_boundary.py  OSM 행정경계 -> data/raw/boundary_<구>.geojson (좌표 검증용)
  geocode_osm.py     단지명 <-> OSM 아파트 매칭으로 좌표 채움 (키 불필요, 경계 밖 제외)
  geocode.py         카카오 주소검색으로 나머지 좌표 채움 (KAKAO_REST_API_KEY + 카카오맵 서비스 활성화 필요)
  fetch_rent.py      아파트 전월세 실거래 -> data/raw/rent_*.json (전세가율·갭)
  fetch_kapt.py      K-apt 단지목록(V4)+기본정보(V5) -> data/raw/kapt.json (세대수·동수·최고층·분양/임대/혼합·복도식)
  fetch_neis.py      나이스 학원·교습소 + 초·중학교 (카카오 좌표화) -> academies.json, schools_neis.json
  fetch_seoul_apt.py 서울시 공동주택 아파트 정보(열린데이터광장, SEOUL_KEY) -> seoul_apt.json (분양/임대/혼합·세대수·주차·면적별 세대수, K-apt 보강)
  fetch_schoolinfo.py 학교알리미 OpenAPI(SCHOOLINFO_KEY) -> schoolinfo/<type>_<급>_<구>_<년>.json (학생수·학급당·전출입)
  fetch_kakao_poi.py 카카오 로컬로 단지 반경 어린이집·소아과·병원·마트·공원·도서관 개수 -> kakao_poi.json
  demo_data.py       키 없을 때 쓰는 데모 단지·학군·경매 (마포구 공덕·아현·염리)
  build.py           위 소스를 합쳐 app/data/*.json 생성 (평당가, 1년 변동, 배정초등(보로노이 추정), 역거리, 대로변 여부, 장단점 자동 요약)
app/
  index.html, app.js, style.css   MapLibre GL 기반 지도 + 하단 시트 UI
  data/                           build.py 산출물
  vendor/                         maplibre-gl 4.7.1 (로컬 번들)

실행

pip install -r requirements.txt
python pipeline/fetch_roads.py          # 최초 1회 (Overpass, 1~2분)
python pipeline/build.py                # app/data 생성 (키 없으면 데모 모드)
python -m http.server 8765 --directory app
# -> http://localhost:8765

실데이터 갱신 순서 (마포구 기준)

python pipeline/fetch_trades.py --lawd 11440 --months 24   # 실거래 (지난달 캐시, 이번달만 재조회)
python pipeline/fetch_boundary.py --name 마포구             # 최초 1회
python pipeline/fetch_poi.py                                # 역/초등학교, 가끔
python pipeline/geocode_osm.py                              # 새 단지 좌표 (OSM)
python pipeline/geocode.py                                  # 나머지 좌표 (카카오)
python pipeline/fetch_rent.py --lawd 11440 --months 12      # 전월세
python pipeline/fetch_kapt.py --sgg 11440                   # 세대수 등 (가끔)
python pipeline/fetch_neis.py --gu 마포구                   # 학원/학교 (가끔)
python pipeline/fetch_kakao_poi.py                          # 생활 편의 (새 단지만)
python pipeline/build.py

data/raw/geocode.json 에 좌표가 없는 단지는 앱에 안 나온다. 세대수/최고층/용적률은 K-apt 공동주택 API 연동 전까지 0 (화면에서 숨김).

정적 페이지 + 배포

python pipeline/generate_pages.py --base https://<owner>.github.io/apt-map   # app/apt/*.html, sitemap.xml, robots.txt
python pipeline/deploy_github_pages.py --owner <owner> --repo apt-map           # GITHUB_TOKEN 필요, gh-pages 브랜치로 app/ 푸시 + Pages ON

단지 페이지는 app/apt/<동>-<단지명>.html, 앱 딥링크는 index.html?id=<단지id>.

주기 갱신 (작업 스케줄러 JipkokMapRefresh, 매주 월 05:00)

python pipeline/refresh.py            # 주간: 실거래/전월세 갱신 -> 좌표 -> 편의시설 -> build -> pages -> 알림 -> deploy
python pipeline/refresh.py --full     # 분기: K-apt, 학원(NEIS), 학교알리미까지
python pipeline/build_schoolzones.py  # 학구도 zip 갱신 시 (data/raw/schoolzone/ 에 풀어둔 뒤)

제보·찜 API (Cloudflare Worker)

python pipeline/deploy_worker.py     # CLOUDFLARE_API_TOKEN 필요. worker/worker.js 업로드 + KV 바인딩 + app/config.js 갱신

엔드포인트: /reports?id= (GET), /reports (POST {id,name,area,price,kind,note}), /recent, /favs?code=, /favs (POST {code,ids}), /health

데이터 출처 / 한계

기능	현재	실서비스 계획
실거래가	데모 생성값	국토교통부 API (무료, 신고 지연 최대 30일)
호가	데모 구간 + 사용자 제보(localStorage)	KB시세 상하한 / 지역 중개사 제휴 / 제보 검수. 네이버부동산 크롤링은 하지 않음
초등 배정	데모 폴리곤	학구도안내서비스(schoolzone.emac.kr) 통학구역
중학교	법정동별 학교군 목록 (데모)	교육지원청 중학교 학교군
도로/인도	실데이터 (OSM, 마포구 일대)	전국 확장 + 표준노드링크 교통량
경매	데모 3건	대법원 법원경매정보 수집