54 lines
1.4 KiB
Markdown
54 lines
1.4 KiB
Markdown
# 부동산 실거래가 검색 시스템
|
|
|
|
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억" |