SkillHub

molit-real-estate

v2.2.0

MOLIT apartment real transaction price API

Sourced from ClawHub, Authored by 김성우

Installation

Please help me install the skill `molit-real-estate` from SkillHub official store. npx skills add sw326/molit-real-estate

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) 분석 연동
  1. real_estate.sh → transaction data
  2. law-search → 관련 법률 (주택임대차보호법, 부동산거래신고법 등) (via ~~law)
  3. Append legal references to report

Cross-Skill: Real Estate + Location Environment

  1. real_estate.sh → transaction data
  2. kma-weather → 지역 기후/미세먼지 데이터 (via ~~weather)
  3. Add environmental context to area comparison

Notes

  1. District code: 5 digits (시군구 level)
  2. Contract month: YYYYMM format
  3. dealAmount contains commas → parse as string
  4. Data delay: 1-2 months after actual transaction
  5. Pagination: increase pageNo for large datasets

Cowork architecture v2.2 — 🦞 chumjibot (2026-02-19)

🔧 Setup (공공데이터 포털 API)

  1. data.go.kr 회원가입
  2. 로그인 → 마이페이지 → 일반 인증키(Decoding) 복사
  3. API 키 저장: bash mkdir -p ~/.config/data-go-kr echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
  4. 아래 서비스 활용신청 후 사용 (자동승인)
  5. 국토부 아파트매매 실거래가 (15057511)