아파트 실거래가 데이터 시각화 대시보드
2026.04.09

소개
아파트 매매와 전세 실거래가 데이터를 Streamlit 라이브러리를 활용하여 시각화해보았습니다.
당연히 데이터는 먼저 공공데이터포털에서 API를 활용하여 수집해서 전처리 후 DB에 저장했습니다.
진행 방법
데이터 수집
공공데이터포털 에서 아파트 실거래가를 검색한 후에 활용 신청하면 API Key를 받을 수 있습니다. API Key는 Encoding, Decoding Key 두 개가 발급되는데, AI에게는 수집하고자 하는 데이터와 Decoding Key값을 알려주면 됩니다. 그러면 수집은 바로 됩니다.

데이터 전처리
공공데이터포털에서 수집된 데이터는 주소가 파싱이 안되어 있어서 전처리가 필요합니다. 시도/시군구/법정동으로 구분되어야 대시보드를 만들더라도 선택이 가능하기에 주소 파싱을 해야합니다. AI에게 아래와 같이 주소를 파싱해달라고 요청합니다.
- 원본 시군구 컬럼(예: "서울특별시 강남구 압구정동")을 시도 / 시군구 / 읍면동으로 분리데이터 시각화
Streamlit 라이브러리를 활용해서 시각화 대시보드를 구현했고, 지역, 단지, 거래유형을 선택해서 조회해볼 수 있습니다.
대시보드는 한번에 원하는 결과를 바로 구현하기는 어렵습니다. 그래서 프롬프트 입력할 때 대시보드를 만들기 위한 요구사항을 구체적으로 적으면 좋습니다. 물론 그렇게 한다고 해도 한번에 딸깍 완성되는 건 아니라서 수차례 티키타카는 필요합니다.
아래 프롬프트 참조해보세요.
### 시각화
#### 뷰 1: 개별 실거래가 (산점도 + 거래량)
매매 가격 → 전세 가격 → 매매 거래량 → 전세 거래량 순서로 4행 분리 배치한다. X축(시간)은 모든 행이 공유한다.
- 가격 행: 산점도(scatter). 개별 거래를 점으로 표시. 같은 월의 점들이 겹치지 않도록 jitter(수평 흩뿌림)를 적용. 평형대별(10평대, 20평대, 30평대 등) 색상으로 구분
- 거래량 행: 막대(bar). 월별 거래 건수
- 거래유형 선택에 따라 매매만(2행), 전세만(2행), 또는 매매+전세(4행)로 자동 조정
#### 뷰 2: 평균 실거래가 (선 그래프 + 거래량)
뷰 1과 동일한 행 분리 배치.
- 가격 행: 선 그래프(line). 월별 중위가를 선으로 표시. 매매와 전세를 색상으로 구분. 선 위에 데이터 포인트 마커 표시
- 거래량 행: 막대(bar). 월별 거래 건수
#### 공통 사항
- 차트 크기는 충분히 크게 (가로 전체 너비, 세로 500px 이상)
- 호버 시 상세 정보 표시 (뷰 1: 단지명, 계약년월, 거래금액, 전용면적, 추정평형, 층 / 뷰 2: 중위가, 거래량, 해당 월)
- 범례 표시
### 사용자 인터페이스 (사이드바)
#### 뷰 전환
- 메인 영역 상단에서 뷰를 전환한다: "개별 실거래가", "평균 실거래가" (탭 또는 라디오 버튼)
#### 지역 선택 (계층적 필터)
- 시도: selectbox (단일 선택, 기본값: 서울특별시)
- 시군구: selectbox (시도 선택에 따라 목록 갱신, 기본값: 강남구)
- 읍면동: multiselect (시군구 선택에 따라 목록 갱신, 기본값: 전체)
- 단지: multiselect (읍면동 선택에 따라 목록 갱신, 기본값: 전체)
#### 거래유형 선택
- 매매+전세 함께 보기, 매매만, 전세만 (라디오 버튼, 기본값: 매매+전세)
#### 평형 필터
- 평형대: multiselect (10평 미만, 10평대, 20평대, 30평대, 40평대, 50평대, 60평 이상 / 기본값: 30평대)
#### 기간 선택
- 시작 연도 ~ 종료 연도 범위 슬라이더 (데이터 존재 범위 내에서 선택)
- 기본값: 전체 기간
#### 기타
- 직거래 포함 여부: 체크박스 (기본: 미포함)
### 메인 화면 추가 정보
차트 아래에 매매 기준 요약 정보를 표시한다. "전세만" 선택 시에는 요약 정보를 표시하지 않는다.
- 선택한 조건의 총 거래 건수
- 최근 거래가 (최근 3건)
- 기간 내 최고가 / 최저가

![# [Claude Code] 네이버 부동산 일일이 뒤지던 나, AI한테 맡겼더니 지도가 생겼다 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2Fc7fbe36016f36f40a6c7b4d7.jpg&w=3840&q=75)
![[Claude Code] PDF 한 장 보여줬더니 AI가 서초구 임장보고서 PPT를 만들어줬다 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F98b8ad81f0f74498eb37a3c2.jpg&w=3840&q=75)

프롬프트 전문을 그대로 공유해주신 게 정말 유용할 것 같아요👏
특히 "가격 행은 산점도에 jitter 적용, 거래량 행은 막대, 계층적 필터는 시도→시군구→읍면동→단지 순으로 갱신" 이런 부분이 인상적이에요ㅎㅎ
이 정도로 구체적으로 써두면 AI가 엉뚱한 방향으로 갈 여지가 거의 없을 것 같아요 🔥
공공데이터 실거래가를 쓰셨는데, 혹시 네이버 부동산 호가랑 같이 비교해보신 적 있으신가요? 실거래가 시차랑 호가 괴리가 있어서 두 개를 겹쳐 보면 시장 흐름 파악에 더 도움될 것 같거든요 🤔
좋은 사례 감사합니다!