| name | office-building-ledger-search |
| description | 국토교통부 건축HUB 건축물대장·건축인허가·주택인허가 실측 데이터로 한 필지의 용도지역·주용도·구조·규모·건폐율/용적률·세대/주차·사용승인일·내진·공시가격 시계열·노후도·철거멸실(석면)·인허가 파이프라인을 조회해 드립니다. archhub MCP의 11개 도구를 호출하므로 별도 설치·API 키가 필요 없습니다(공용키 hosted remote 커넥터).
다음과 같은 요청 시 사용하세요:
- "자양동 2-2번지 건물 정보 한눈에", "이 필지 용도지역·건폐율·용적률 보여줘"
- "자양동 건축물 통계 내줘", "이 동네 주용도 분포"
- "광진구 자양동 노후건물 40년 넘은 것", "노후건축물 정비사업 대상 선별"
- "자양동 철거된 건물 석면 포함", "철거멸실 현황"
- "진행 중인 건축 인허가", "허가 났는데 사용승인 전인 건물"
- "이 빌딩 층별로 뭐가 있는지", "층별 용도·면적"
- "자양동 24-28번지 공시가격 추이", "공시가격 시계열"
- "건축물대장 원본 보여줘", "건축인허가 이력"
건축사·시공·중개·감정평가·디벨로퍼·공무원이 실무에서 바로 쓰는 건축물 실체 데이터입니다.
본 스킬은 "건축물 실체(용도·구조·규모·규제·인허가·노후·철거)" 전담입니다. "실거래가/전월세 시세"는 office-public-data-real-estate-search를 사용하세요.
|
| version | 0.1.0 |
국토교통부 건축HUB 조회 (office-building-ledger-search)
역할
국토교통부 건축HUB의 건축물대장·건축인허가·주택인허가 데이터를 기반으로 한 필지·동 단위의 건축물 실체 정보를 조회하는 전문가. 용도지역·주용도·구조·규모·건폐율/용적률·세대/주차·사용승인·내진·공시가격 시계열·노후도·철거멸실(석면)·인허가 파이프라인을 data.go.kr 공식 API 실측값으로 제공합니다.
본 스킬은 chrisryugj/archhub-mcp (MIT) MCP 서버(공용키 탑재 remote 커넥터, URL만 등록)를 호출합니다. 출처는 국토교통부 건축HUB(공공데이터포털 data.go.kr)이며, 결과가 없으면 [NOT_FOUND]로 환각을 차단합니다.
페르소나
| 페르소나 | 주력 도구 | 시나리오 |
|---|
| 공무원·공공기관 | district_stats·old_buildings·demolitions·permits_pipeline | 동 단위 노후도 집계, 정비·안전점검 대상 선별, 철거·공급 파이프라인 |
| 건축사·시공 | building_profile·building_floors·district_stats·building_permit | 용도지역·규모 규제, 층별 구성, 동네 규모 벤치마크, 인허가 이력 |
| 디벨로퍼 | building_profile·district_stats·old_buildings·demolitions·permits_pipeline | 노후 분포·철거·진행중 인허가로 사업성·공급 스크리닝 |
| 중개 | building_profile·building_floors·price_history | 매물 종합카드 + 층별 임대구성 + 공시가 추이 |
| 감정평가 | building_profile·price_history·building_ledger | 용도지역·면적·승인일·주차 + 공시가격 시계열 |
지원 도구 (archhub MCP 11개)
| 도구 | 설명 |
|---|
find_region | 주소 키워드("광진구 자양동") → sigungu_code/bdong_code. 다른 도구 사용 전 필수 선행. |
building_profile | 용도지역 포함 종합카드 — 용도지역·주용도·구조·규모·건폐율/용적률·세대·주차·사용승인·내진·에너지. 한 필지 1콜 종합. |
building_floors | 층별 구성 스택 — 옥탑→지상→지하 각 층 용도·면적. 리모델링·용도변경·임대구성. |
price_history | 공시가격 시계열 — 호별 연도별 추이·총증감률·연평균상승률(CAGR). 감정평가·자산분석. |
district_stats | 동 단위 통계 + 규모 벤치마크 — 총괄·주용도별·연대별·노후도 분포 + 주용도별 층수·용적률·높이 중앙값. 도시계획·정비사업. |
old_buildings | 노후건축물 분석 — 사용승인 경과연수 기준 정렬. 안전점검·정비사업 1차 선별. min_age_years 파라미터. |
demolitions | 철거멸실 현황 — 최근 철거순 + 석면 함유 부위 ⚠. 디벨로퍼·철거업체·공무원. since_year 파라미터. |
permits_pipeline | 인허가 파이프라인 — 사용승인 전 진행중 건, 착공/미착공 단계 구분. 신규 공급 파이프라인. since_year 파라미터. |
building_ledger | 건축물대장 10종(기본개요·총괄표제부·표제부·층별개요·전유공용면적·주택가격 등) 원천 데이터. |
building_permit | 건축인허가 17종(기본개요·동별·층별·대수선·철거멸실·주차장 등). |
housing_permit | 주택인허가 16종(기본개요·동별·부대시설·관리공동 등). |
워크플로우
Step 1 — 주소 → 코드 변환 (필수 선행)
모든 도구는 sigungu_code(시군구 5자리) + bdong_code(법정동 5자리)를 받습니다. 사용자가 주소("광진구 자양동")를 주면 반드시 먼저 find_region을 호출해 코드를 얻습니다. 번지(bun/ji)는 큰 동에서 속도를 위해 지정을 권합니다.
주소: "광진구 자양동 2-2번지"
→ find_region("광진구 자양동")
→ sigungu_code=11215, bdong_code=10500, bun=2, ji=2
동명이 중복되는 경우(예: 부산 중구 vs 서울 중구 vs 울산 중구)는 광역시를 같이 말해야 정확히 구분됩니다.
Step 2 — 목적에 따른 도구 선택
| 목적 | 도구 |
|---|
| 특정 건물 종합 정보 | building_profile |
| 층별 용도·면적 | building_floors |
| 공시가격 추이 | price_history |
| 동 단위 통계·분포 | district_stats |
| 노후 건물 선별 | old_buildings |
| 철거·석면 현황 | demolitions |
| 진행중 인허가 | permits_pipeline |
| 원천 데이터(대장/인허가) | building_ledger / building_permit / housing_permit |
Step 3 — 결과 정리
- 건물명·위치·주용도·구조·규모(지상/지하층·연면적·대지면적)를 한 카드로 정리.
- 건폐율/용적률이 응답에 없으면 면적으로 직접 계산해
(계산) 표시로 추정값과 실측값을 구분.
- 용도지역 정보가 없는 필지(오래된 단독주택 등)는 해당 줄을 조용히 생략(임의 채움 금지).
- 공시가격은 시세가 아님을 명시(통상 시세의 60~70% 수준, 현실화율 정책 변동 포함). 증감률·CAGR을 실거래가 상승률로 해석하지 않도록 경고.
- 답변 말미에 출처(국토교통부 건축HUB, data.go.kr) 명시.
응답 컴팩트 규칙
- 주소 + sigungu/bdong 코드(처음 1회)
- 주용도·구조·규모(층수·연면적·대지면적)
- 건폐율·용적률·세대/주차·사용승인일
- 통계 호출 시: 총괄(동 수·연면적·평균 경과연수) + 상위 5개 주용도 + 연대별/노후도 분포 요약
- 노후/철거/인허가 목록: 상위 5-10건 + 전체 건수 표시
책임 분담 (중요)
본 스킬은 "건축물 실체" 전담입니다. **"실거래가/전월세 시세"**은 페어 스킬을 사용하세요.
| 작업 | 스킬 | 데이터 소스 |
|---|
| 실거래가·전월세 시세 | moai-analyst:office-public-data-real-estate-search | 국토교통부 실거래가 신고 |
| 건축물 실체(용도·구조·규모·규제·인허가·노후·철거) | moai-analyst:office-building-ledger-search (본 스킬) | 국토교통부 건축HUB |
| 인구·가구 통계 | moai-analyst:office-public-data-public-data | KOSIS |
| 법원 경매 매각공고 | moai-analyst:office-public-data-court-auction-search | 대법원 경매정보 |
이 스킬을 사용하지 말아야 할 때
- 실거래가·전월세 시세 →
moai-analyst:office-public-data-real-estate-search
- 인구·고용·물가 등 통계 →
moai-analyst:office-public-data-public-data (KOSIS 자연어 우선)
- 법원 경매 매각공고·감정평가액·최저매각가 →
moai-analyst:office-public-data-court-auction-search
- 소유자·소유정보(개인정보) → 건축HUB API에 소유자 필드가 없으므로 본 스킬 범위 밖(등기부등본 조회 권장)
- 위반건축물 조회 → 표제부/기본개요/총괄표제부 어디에도 위반건축물 필드가 없음(API 실측 확인) → 조회 불가
- 부동산 세금·법률 자문 → 세무사·법무사 전문가 안내
Prerequisites
사용자 측 필수 시크릿 없음. API 키 발급 불필요.
- archhub MCP는 공용키가 탑재된 remote 커넥터(
https://archhub-mcp.fly.dev/mcp)로, URL만 .mcp.json에 등록하면 바로 사용합니다.
- 인터넷 연결만 있으면 동작합니다.
- 로컬 실행(stdio)이 필요한 경우에만
ARCHHUB_SERVICE_KEY(data.go.kr 건축HUB 서비스 Decoding 인증키)가 필요합니다. 일반적인 사용은 remote 커넥터로 충분합니다.
Failure modes
[NOT_FOUND] — 해당 필지/동에 데이터 없음. 환각 차단(임의 답변 금지).[EXTERNAL_API_ERROR] — data.go.kr 업스트림 API 오류. 재시도 안내.- 주소가 모호한 경우 →
find_region이 sigungu/bdong을 못 찾으면 광역시도 컨텍스트를 보강해 재시도 요청.
- 큰 동(수천 건) →
old_buildings·district_stats·demolitions·permits_pipeline은 전체를 받아 다소 느릴 수 있음. 번지(bun/ji) 지정 권장.
관련 스킬 체이닝
- before:
moai-analyst:office-public-data-real-estate-search — 실거래가 시세로 입지 검토 선행
- after:
moai-consultant:business-market-analyst — 건축물 + 시세 데이터 기반 시장 분석
- after:
moai-analyst:office-public-data-court-auction-search — 경매 매각공고와 건축물대장 교차 검토
- after:
moai-officer:office-pdf-writer — 건축물 종합카드·통계 PDF 보고서 생성
- after:
moai-officer:office-xlsx-creator — 노후건물·인허카 파이프라인 엑셀 정리
- pair:
moai-officer:office-mcp-connector-setup — archhub MCP 사전 준비 가이드
Done when
- 주소를
find_region으로 sigungu_code/bdong_code로 변환했다(번지가 있으면 bun/ji 포함).
- 요청 목적(종합카드·층별·통계·노후·철거·인허가·공시가)에 맞는 도구를 선택해 호출했다.
- 결과를 용도·구조·규모·건폐율/용적률·출처 포함으로 정리했다.
- 공시가격은 시세가 아님을 명시했다(price_history 호출 시).
- "건축물 실체 vs 실거래가 시세" 책임 분담을 지켰다(시세 요청은 real-estate-search로 라우팅).
