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

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

## 기능

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

## 설치

```bash
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
```

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

## 실행

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

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

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