당근부동산 검색 가이드 (`daangn-realty-search`)

당근부동산 공개 웹 데이터 표면을 사용해 지역 기반 부동산 매물 후보를 검색하고, 상세 페이지의 공개 메타를 읽기 전용으로 확인하는 스킬입니다.

사용 시나리오

"당근부동산 합정동 월세 매물 찾아봐"
"마포구 전세 후보 당근에서 봐줘"
"이 당근부동산 URL 상세 요약해줘"

구현 표면

브라우저 자동화, 로그인, 채팅, 문의, 예약, 계약 자동화를 사용하지 않습니다.

지역 해석: https://www.daangn.com/kr/api/v1/regions/keyword?keyword=<지역명>
검색: https://realty.daangn.com/map/{name1}/{name2}/{name3}의 SSR window.RELAY_STORE
상세: https://realty.daangn.com/articles/<id>의 application/ld+json 및 <title>

구버전 https://www.daangn.com/kr/realty/?_data=routes/kr.realty._index 표면은 2026-06 기준 HTTP 204 빈 응답으로 폐기되어 사용하지 않습니다.

로컬 실행

python3 daangn-realty-search/scripts/daangn_realty.py search --region "합정동" --limit 5
python3 daangn-realty-search/scripts/daangn_realty.py search --region "합정동" --sales-type "STORE,OFFICETEL" --trade-type "MONTH"
python3 daangn-realty-search/scripts/daangn_realty.py detail "https://realty.daangn.com/articles/..."

지역 필터

지역명은 당근 region API로 name1/name2/name3를 해석한 뒤 지도 URL 경로에 넣습니다.

합정동 → 서울특별시 마포구 합정동 → /map/서울특별시/마포구/합정동

출력 해석

검색 결과는 salesType, area_sqm, area_pyeong, trades, url, 상세 보강 시 title, address, floor_label을 우선 확인합니다. 부동산 판단에는 실시간 상태, 보증금/월세, 관리비, 면적, 중개/직거래 여부가 중요하므로 원본 URL을 함께 제시합니다.

제한사항

당근부동산 목록 JSON과 realty.daangn.com 상세 HTML 구조 변경에 영향을 받습니다.
문의, 방문 예약, 계약, 결제, 채팅은 실행하지 않습니다.
공고 내용은 실시간 상태와 달라질 수 있어 최종 판단 전 원문 확인이 필요합니다.

2.2 KiB Raw Permalink Blame History

당근부동산 검색 가이드 (daangn-realty-search)