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

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 키 저장:

   mkdir -p ~/.config/data-go-kr
   echo "YOUR_API_KEY" > ~/.config/data-go-kr/api_key
   

4. 아래 서비스 활용신청 후 사용 (자동승인)
   • 국토부 아파트매매 실거래가 (15057511)