jhhackaton/README.md

1.4 KiB

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

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-openai-api-key

# 공공데이터 API 키 (국토교통부)
PUBLIC_DATA_API_KEY=your-public-data-api-key
  1. 공공데이터포털(data.go.kr)에서 국토교통부 실거래가 API 서비스키 발급
    • 하나의 키로 모든 부동산 API 사용 가능

실행

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

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

입력 예시

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