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