Real Estate Actual Price

개인용 대만 실거래가 등록 조회 MVP. Web/PWA와 MCP tools가 동일한 SQLite 데이터베이스 및 조회 로직을 공유하며, OpenAI API 키가 필요 없습니다.

1단계 기능

• 內政部地政司 공식 실거래 등록 매매 CSV ZIP 가져오기(당기 또는 과거 분기)

• 주소, 행정구역, 주소 내 식별 가능한 커뮤니티/건물 텍스트로 조회

• 거래일, 단가, 총가, 면적, 층, 건물 연령 및 건물 유형 표시

• 최근 1년/3년 거래 건수, 단가 중앙값, 평균, 최고, 최저 및 월별 추세 계산

• search_transactions, get_market_stats, list_areas, get_data_status MCP tools 제공

• 모바일에서 사용 가능한 반응형 Web/PWA

Windows 로컬 시작

Python 3.11–3.14 사용; 아래 명령은 이 컴퓨터에서 현재 정상 실행되는 Python을 사용합니다.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e ".[dev]"
python scripts\sync_data.py --current
python web.py

http://127.0.0.1:5000을 열어보세요. 첫 번째 동기화는 당기 데이터만 가져옵니다. 전체 3년 통계가 필요하면 최근 12개 완료 분기를 추가로 가져오세요. 예:

python scripts\sync_data.py --season 112S3 --season 112S4 --season 113S1 --season 113S2 --season 113S3 --season 113S4 --season 114S1 --season 114S2 --season 114S3 --season 114S4 --season 115S1 --season 115S2

특정 시/도만 가져와 시간을 단축할 수도 있습니다:

python scripts\sync_data.py --current --city 臺北市 --city 新北市

반복 가져오기는 공식 사건 번호를 기준으로 업데이트되며, 중복 누적되지 않습니다.

Render 공개 PWA(6대 도시 데모 버전)

Repository에는 render.yaml과 Dockerfile이 포함되어 있습니다. Render에서 Web Service를 만들고 이 repository를 연결한 후 Free 플랜을 선택하세요. 빌드 시 臺北市, 新北市, 桃園市, 臺中市, 臺南市, 高雄市의 당기 공식 데이터를 다운로드하여 가져옵니다. 완료 후 Render가 HTTPS URL을 제공하며, 모바일에서 열어 PWA로 설치할 수 있습니다.

Render 무료 서비스는 15분간 유휴 상태면 절전 모드로 전환되며, 첫 재시작 시 약 1분이 걸립니다. 재배포할 때마다 6대 도시 데이터를 다시 다운로드합니다. 이 공개 데모 버전은 MCP endpoint를 제공하지 않으며, MCP와 전체 로컬 데이터베이스는 개인 컴퓨터에서 사용합니다.

MCP server

python mcp_server.py

기본적으로 Streamable HTTP로 http://127.0.0.1:8001/mcp를 제공합니다. 먼저 MCP Inspector로 확인할 수 있습니다:

npx @modelcontextprotocol/inspector@latest

ChatGPT 개발자 모드는 일반 localhost에 직접 연결할 수 없습니다. OpenAI 공식 문서에 따르면 개인 로컬 테스트는 Secure MCP Tunnel을 사용하거나 /mcp를 공개 연결 가능한 HTTPS endpoint에 배포해야 합니다. 1단계에는 공개 배포 및 검증이 포함되지 않습니다.

테스트

python -m pytest

데이터 소스 및 제한

주요 데이터 소스는 內政部地政司의 "不動產成交案件實際資訊" Open Data입니다. 당기 정적 데이터는 보통 매월 1, 11, 21일에 발행되며, 동적 조회 사이트는 더 최신일 수 있습니다. 데이터는 신고 및 비식별화된 내용이며, 주소는 도로 구간, 번호 구간 또는 지번까지만 있을 수 있습니다. 기존 주택 데이터에는 신뢰할 수 있고 통일된 커뮤니티 이름 필드가 없으므로, 커뮤니티/건물 이름 조회는 주소와 비고 텍스트를 비교하며, 누락되거나 동명 오매칭될 수 있습니다. 건물 연령은 사용 가능한 건물 완공 연월로 추정하며, 결측값은 "알 수 없음"으로 표시합니다. 단가는 공식 제곱미터 단위를 평당으로 환산하며, 주차장 및 특수 거래 포함 시에도 비고를 읽어야 하며, 평가나 투자 조언으로 간주해서는 안 됩니다.

공식 출처:

• https://data.gov.tw/dataset/25119

• https://plvr.land.moi.gov.tw/DownloadOpenData