mirror of
https://github.com/NomaDamas/k-skill.git
synced 2026-06-24 02:04:11 +00:00
43 lines
2 KiB
Markdown
43 lines
2 KiB
Markdown
# 당근부동산 검색 가이드 (`daangn-realty-search`)
|
|
|
|
당근부동산 공개 웹 데이터 표면을 사용해 지역 기반 부동산 매물 후보를 검색하고, 상세 페이지의 공개 메타를 읽기 전용으로 확인하는 스킬입니다.
|
|
|
|
## 사용 시나리오
|
|
|
|
- "당근부동산 합정동 월세 매물 찾아봐"
|
|
- "마포구 전세 후보 당근에서 봐줘"
|
|
- "이 당근부동산 URL 상세 요약해줘"
|
|
|
|
## 구현 표면
|
|
|
|
브라우저 자동화, 로그인, 채팅, 문의, 예약, 계약 자동화를 사용하지 않습니다.
|
|
|
|
1. 지역 해석: `https://www.daangn.com/kr/api/v1/regions/keyword?keyword=<지역명>`
|
|
2. 검색: `https://www.daangn.com/kr/realty/?in=<지역명>-<id>&_data=routes/kr.realty._index`
|
|
3. 상세: `https://realty.daangn.com/articles/<id>`의 `application/ld+json` 및 `<title>`
|
|
|
|
## 로컬 실행
|
|
|
|
```bash
|
|
python3 daangn-realty-search/scripts/daangn_realty.py search --region "합정동" --limit 5
|
|
python3 daangn-realty-search/scripts/daangn_realty.py search --region "합정동" --sales-type "APARTMENT" --trade-type "MONTHLY_RENT"
|
|
python3 daangn-realty-search/scripts/daangn_realty.py detail "https://realty.daangn.com/articles/..."
|
|
```
|
|
|
|
## 지역 필터
|
|
|
|
지역명은 당근 region API로 내부 id를 해석한 뒤 `in=<지역명>-<id>` 형태로 검색 URL에 넣습니다.
|
|
|
|
```text
|
|
합정동 → 서울특별시 마포구 합정동, id=231 → in=합정동-231
|
|
```
|
|
|
|
## 출력 해석
|
|
|
|
검색 결과는 `title`, `salesType`, `trade`, `area`, `areaPyeong`, `totalManageCost`, `url`을 우선 확인합니다. 부동산 판단에는 실시간 상태, 보증금/월세, 관리비, 면적, 중개/직거래 여부가 중요하므로 원본 URL을 함께 제시합니다.
|
|
|
|
## 제한사항
|
|
|
|
- 당근부동산 목록 JSON과 `realty.daangn.com` 상세 HTML 구조 변경에 영향을 받습니다.
|
|
- 문의, 방문 예약, 계약, 결제, 채팅은 실행하지 않습니다.
|
|
- 공고 내용은 실시간 상태와 달라질 수 있어 최종 판단 전 원문 확인이 필요합니다.
|