부동산 실거래가 검색 시스템

FastAPI와 OpenAI를 활용한 부동산 실거래가 검색 웹 애플리케이션

기능

• 자연어로 부동산 조건 입력
• OpenAI API를 통한 자동 정보 추출
• 국토교통부 공공데이터 API 연동
• 실제 실거래가 데이터 조회 및 표시
• AI 기반 매물 추천: 사용자 요구사항과 가장 일치하는 TOP 10 매물 선별
• 지원 정보:
  • 매물 형태 (아파트, 오피스텔, 빌라, 주택 등)
  • 거래 유형 (전세, 월세, 매매)
  • 지역 자동 인식 및 코드 변환
  • 실거래가 목록 표시
  • AI 필터링을 통한 최적 매물 추천

설치

cd C:\o2o\RealEstateSearch
pip install -r requirements.txt

설정

1. .env 파일에 API 키 설정:

# OpenAI API 키
OPENAI_API_KEY=your-actual-api-key

# 공공데이터 API 키 (국토교통부)
APT_TRADE_API_KEY=your-key      # 아파트 매매
APT_RENT_API_KEY=your-key       # 아파트 전월세
OFFI_TRADE_API_KEY=your-key     # 오피스텔 매매
OFFI_RENT_API_KEY=your-key      # 오피스텔 전월세
SH_TRADE_API_KEY=your-key       # 연립/다세대 매매
SH_RENT_API_KEY=your-key        # 연립/다세대 전월세
HOUSE_TRADE_API_KEY=your-key    # 단독/다가구 매매
HOUSE_RENT_API_KEY=your-key     # 단독/다가구 전월세

2. 공공데이터포털(data.go.kr)에서 각 API 서비스키 발급

실행

cd C:\o2o\RealEstateSearch\backend
python main.py

브라우저에서 http://localhost:20001 접속

입력 예시

• "강남역 근처 아파트 전세 2억 이하 투룸"
• "서초동 30평대 오피스텔 매매 10억 이하"
• "판교 빌라 방 3개 월세 100/50"
• "잠실 주상복합 전세 5억"
• "분당 단독주택 매매 20억"