- name
- molit-real-estate
- description
- MOLIT apartment real transaction price API
- version
- 2.2.0
- author
- chumjibot
- created
- 2026-02-10
- updated
- 2026-02-19
- tags
- [real-estate, korea, openapi, data.go.kr]
- connectors
- [~~realestate, ~~law, ~~search, ~~notify]
Real Estate Transaction Skill
MOLIT apartment sale transaction data + law integration.
Overview
| Key | Value |
|---|
| Provider | MOLIT (Ministry of Land, Infrastructure and Transport) |
| Service ID | 15126469 |
| Auth | ~/.config/data-go-kr/api_key |
| Endpoint | https://apis.data.go.kr/1613000/RTMSDataSvcAptTrade |
| Legal basis | Real Estate Transaction Report Act |
| Playbook | playbook.md |
Scripts
scripts/
└── real_estate.sh [district_code] [YYYYMM] [rows]
Workflow
Step 1: Identify district & period
- "강남 아파트" → Gangnam-gu (11680), current month
- Refer to
playbook.md for watchlist areas - Default: current month; if empty, try recent 3 months
Step 2: Fetch transaction data
real_estate.sh [code] [YYYYMM]
Step 3: Analyze
- Price per pyeong (area ÷ 3.3058)
- YoY comparison (on request)
- ~~search for market trend supplement
Step 4: Law integration (~~law, optional)
- Rental disputes → Housing Lease Protection Act
- Sales → Real Estate Transaction Report Act
Step 5: Structured response
Output Template
## 🏠 [District] Apartment Transactions
### Recent Transactions
| Apt | Area | Floor | Price | Per Pyeong | Date |
|-----|------|-------|-------|-----------|------|
### 📊 Summary
- Avg price: X억
- Avg per pyeong: X만/평
- Total transactions: X
### 💡 Notes
[Trend / related law info]
Key District Codes (Seoul)
| District | Code | District | Code |
|---|
| Jongno | 11110 | Mapo | 11440 |
| Yongsan | 11170 | Gangnam | 11680 |
| Seocho | 11650 | Songpa | 11710 |
| Gangdong | 11740 | Yeongdeungpo | 11560 |
| Seongdong | 11200 | Gwanak | 11620 |
Other Cities
| District | Code |
|---|
| Busan Haeundae | 26350 |
| Daegu Suseong | 27200 |
| Incheon Yeonsu | 28185 |
| Daejeon Yuseong | 30200 |
Response Fields (XML → English keys since 2026)
| Key | Description |
|---|
| aptNm | Apartment name |
| umdNm | District name |
| excluUseAr | Exclusive area (㎡) |
| floor | Floor |
| dealAmount | Price (만원, comma-separated) |
| dealYear/Month/Day | Transaction date |
| dealingGbn | Transaction type |
| buildYear | Year built |
Connectors
| Placeholder | Purpose | Current Tool |
|---|
~~realestate | Transaction API | MOLIT data.go.kr |
~~law | Legal references | law.go.kr |
~~search | Trend supplement | Brave Search |
~~notify | Alerts | Telegram |
Intent Router
| # | Intent | Trigger Expression | Output |
|---|
| 1 | Price Check | "강남 아파트 실거래가", "최근 거래 보여줘" | Transaction list + summary |
| 2 | Trend Analysis | "송파 시세 추이", "6개월간 가격 변화" | Multi-month comparison |
| 3 | Area Comparison | "강남 vs 서초 비교", "강남3구 어디가 비싸?" | Side-by-side district table |
Details: see Workflow above.
Cross-Skill Integration
| Trigger | Partner Skill | How |
|---|
| "관련 법률도", 임대차/전세 분쟁 | law-search (~~law) | 주택임대차보호법, 부동산거래신고법 검색 |
| "주변 환경도", 입지 분석 | kma-weather (~~weather) | 해당 지역 기후/환경 데이터 보강 |
| "투자 관점에서" | finance-sector-analysis | 부동산 섹터(XLRE) 분석 연동 |
Cross-Skill: Real Estate + Legal Context
real_estate.sh → transaction datalaw-search → 관련 법률 (주택임대차보호법, 부동산거래신고법 등) (via ~~law)- Append legal references to report
Cross-Skill: Real Estate + Location Environment
real_estate.sh → transaction datakma-weather → 지역 기후/미세먼지 데이터 (via ~~weather)- Add environmental context to area comparison
Notes
- District code: 5 digits (시군구 level)
- Contract month: YYYYMM format
- dealAmount contains commas → parse as string
- Data delay: 1-2 months after actual transaction
- Pagination: increase pageNo for large datasets
*Cowork architecture v2.2 — 🦞 chumjibot (2026-02-19)*
🔧 Setup (공공데이터 포털 API)
- data.go.kr 회원가입
- 로그인 → 마이페이지 → 일반 인증키(Decoding) 복사
- API 키 저장:
mkdir -p ~/.config/data-go-kr
echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
- 아래 서비스 활용신청 후 사용 (자동승인)
- 국토부 아파트매매 실거래가 (15057511)
