58 lines
1.6 KiB
Markdown
58 lines
1.6 KiB
Markdown
# 부동산 실거래가 검색 시스템
|
|
|
|
FastAPI와 OpenAI를 활용한 부동산 실거래가 검색 웹 애플리케이션
|
|
|
|
## 기능
|
|
|
|
- 자연어로 부동산 조건 입력
|
|
- OpenAI API를 통한 자동 정보 추출
|
|
- 국토교통부 공공데이터 API 연동
|
|
- 실제 실거래가 데이터 조회 및 표시
|
|
- 지원 정보:
|
|
- 매물 형태 (아파트, 오피스텔, 빌라, 주택 등)
|
|
- 거래 유형 (전세, 월세, 매매)
|
|
- 지역 자동 인식 및 코드 변환
|
|
- 실거래가 목록 표시
|
|
|
|
## 설치
|
|
|
|
```bash
|
|
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 서비스키 발급
|
|
|
|
## 실행
|
|
|
|
```bash
|
|
cd C:\o2o\RealEstateSearch\backend
|
|
python main.py
|
|
```
|
|
|
|
브라우저에서 http://localhost:20001 접속
|
|
|
|
## 입력 예시
|
|
- "강남역 근처 아파트 전세 2억 이하 투룸"
|
|
- "서초동 30평대 오피스텔 매매 10억 이하"
|
|
- "판교 빌라 방 3개 월세 100/50"
|
|
- "잠실 주상복합 전세 5억"
|
|
- "분당 단독주택 매매 20억" |