1. 공공데이터포털이란 무엇인가요?
공공데이터포털은 쉽게 말해
정부와 공공기관이 가지고 있는 데이터를 모아둔 인터넷 자료 창고입니다.
예를 들어 정부, 지자체, 공공기관은 여러 가지 정보를 가지고 있습니다.
교통 정보, 날씨 정보, 병원 정보, 약국 정보, 관광지 정보, 버스 도착 정보, 미세먼지 정보, 부동산 정보, 인구 통계 같은 것들이 있습니다.
이런 데이터를 국민이나 기업, 개발자가 활용할 수 있도록 공개해둔 곳이 바로 공공데이터포털입니다.
2. 왜 필요한가요?
예전에는 공공기관이 가진 데이터를 일반 사람이 쉽게 가져다 쓰기 어려웠습니다.
그런데 공공데이터포털을 이용하면
필요한 데이터를 검색하고, 다운로드하거나, API 형태로 연결해서 사용할 수 있습니다.
즉, 공공데이터포털은
공공기관의 데이터를 필요한 사람이 쉽게 찾아 쓰도록 만든 공식 플랫폼이라고 보면 됩니다.
부동산 API를 이용해서 클로드 코드에서 데이터 가져오기
국토교통부_상업어무용 부동산 매매 실거래가 자료 → [활용신청]
웹사이트 개발 → 입력 : 웹사이트 개발
- 동의하기 체크
- [활용신청] 클릭
- 일일 트래픽이란?
- 일일 트래픽은 하루 동안 내 사이트나 서비스에 들어온 방문/요청의 양
- 일일 트래픽이란?
3. 데이터 특성
- 범위: 상업·업무용 부동산만 (주거용 제외)
- 갱신: 거래신고 기반 (계약월 기준)
- 정밀도: 지역코드(5자리) + 월 단위 → 동(洞) 수준의 월별 거래 추적 가능
- 한도: 일일 10,000 트래픽 (웹사이트 개발 용도)
- 활용신청 후 → [활용현황 신청] 페이지로 자동 이동 →
- 각 계정마다 고유의 일반 인증키 생성
- 개인 일반 인증키 저장 필수
인증키 보관 원칙
인증키는 비밀번호처럼 다뤄야 합니다.
블로그에 공개하지 않기
강의 화면에 그대로 노출하지 않기
GitHub 공개 저장소에 올리지 않기
카카오톡 단체방에 공유하지 않기
스크린샷에서 가리기좋은 습관은 이것입니다.
API 인증키는 비밀번호처럼 보관하고, 공개 자료에서는 반드시 가립니다.
4. API 요청 주소 구조 이해하기
이번 부동산 API의 기본 엔드포인트는 다음과 같습니다.
https://apis.data.go.kr/1613000/RTMSDataSvcNrgTrade/getRTMSDataSvcNrgTrade여기에 조회 조건을 붙입니다.
첨부 글의 예시는 다음 조건을 사용합니다.
serviceKey = [본인 키]
LAWD_CD = 11440
DEAL_YMD = 202603
numOfRows = 1000
pageNo = 1각 항목의 의미는 다음과 같습니다.
| 항목 | 의미 | 예시 |
| serviceKey | 개인 인증키 | 본인 발급 키 |
| LAWD_CD | 지역코드 | 11440 |
| DEAL_YMD | 계약 연월 | 202603 |
| numOfRows | 한 번에 가져올 데이터 수 | 1000 |
| pageNo | 페이지 번호 | 1 |
5. 지역코드 이해하기
부동산 데이터는 지역코드를 사용합니다.
오늘 볼 지역으로 다음 지역코드를 제시합니다.
| 지역 | 지역코드 |
| 마포구 | 11440 |
| 용산구 | 11170 |
| 성동구 | 11200 |
예를 들어 마포구 데이터를 보고 싶으면 다음 조건을 사용합니다.
LAWD_CD = 114406. 계약월 이해하기
DEAL_YMD는 계약 연월입니다.
예를 들어 2026년 3월 데이터를 보고 싶다면 다음처럼 입력합니다.
DEAL_YMD = 202603형식은 "YYYYMM" 입니다.
| 기간 | 입력값 |
| 2026년 1월 | 202601 |
| 2026년 2월 | 202602 |
| 2026년 3월 | 202603 |
| 2026년 12월 | 202612 |
오늘 볼 기간 예시로 2026년 3월, DEAL_YMD = 202603을 제시합니다.
7. Claude Code에게 API를 설명하는 프롬프트
이제 Claude Code에게 API 정보를 알려 줍니다.
처음에는 분석을 시키기보다 API 연결 테스트부터 해야 합니다.
공공데이터포털의 국토교통부 상업업무용 부동산 매매 실거래가 자료 API를 테스트하려고 합니다.
[API 정보]
- 엔드포인트: https://apis.data.go.kr/1613000/RTMSDataSvcNrgTrade/getRTMSDataSvcNrgTrade
- 메서드: GET
- 응답 형식: XML
- 인증키 파라미터: serviceKey
[조회 조건]
- serviceKey: [본인 인증키]
- LAWD_CD: 11440
- DEAL_YMD: 202603
- numOfRows: 10
- pageNo: 1
먼저 API 요청 URL을 구성해 주세요.
그다음 응답이 정상인지 확인하는 절차를 설명해 주세요.처음에는 numOfRows를 10으로 작게 두는 것이 좋습니다.
데이터가 정상적으로 들어오는지 확인한 뒤 1000으로 늘립니다.
8. Claude Code 실습 프롬프트 — 마포구 데이터 가져오기
Claude Code에서 다음 공공데이터 API를 사용해
마포구의 2026년 3월 상업업무용 부동산 매매 실거래 데이터를 가져와 주세요.
[활용 API]
- 공공데이터포털 / 국토교통부 상업업무용 부동산 매매 실거래가 자료
- 엔드포인트: https://apis.data.go.kr/1613000/RTMSDataSvcNrgTrade/getRTMSDataSvcNrgTrade
- 메서드: GET
- 응답 포맷: XML
- 인증키(serviceKey): [본인 키]
[조회 조건]
- LAWD_CD = 11440
- DEAL_YMD = 202603
- numOfRows = 1000
- pageNo = 1
[요청]
1. API 요청 URL을 구성해 주세요.
2. 응답 XML을 가져와 주세요.
3. resultCode가 00인지 확인해 주세요.
4. totalCount를 확인해 주세요.
5. items.item 데이터를 표로 정리해 주세요.
[주의]
- 인증키는 출력 결과에 그대로 노출하지 마세요.
- 거래금액 단위와 면적 단위를 임의로 바꾸지 마세요.9. 응답 XML에서 확인할 것
API가 정상적으로 응답하면 XML 안에 여러 항목이 들어옵니다.
먼저 확인할 것은 세 가지입니다.
| 확인 항목 | 의미 |
| resultCode | 요청 성공 여부 |
| resultMsg | 응답 메시지 |
| totalCount | 전체 데이터 수 |
Subagent 실습에서도 데이터 수집 Subagent에게 “resultCode가 00인지 확인”하고 “totalCount를 확인”하라고 지시합니다.
일반적으로 resultCode = 00 이면 정상 응답으로 봅니다.
resultCode = 00
→ 정상 응답정상 응답이 아니면 인증키, 요청 주소, 파라미터, 활용신청 상태를 확인해야 합니다.
10. 부동산 데이터 분석에 필요한 핵심 지표
API에서 데이터를 가져오는 것만으로는 충분하지 않습니다.
가져온 데이터를 어떤 기준으로 볼 것인지 정해야 합니다.
부동산 가격 전망에 필요한 핵심 지표를 다음처럼 제시합니다.
| 지표 | 의미 | 상승 신호 | 하락 또는 주의 신호 |
| 거래량 | 실제 거래가 얼마나 있는지 | 거래가 꾸준히 발생 | 거래가 거의 없음 |
| 평균 거래금액 | 시장 가격대 | 고가 거래 증가 | 저가 거래 위주 |
| 평당가 | 면적 대비 가격 | 평당가 상승 | 평당가 하락 |
| 50억 이상 거래 비중 | 큰 자금 유입 여부 | 중대형 거래 증가 | 소액 거래만 발생 |
| 200억 이상 거래 | 기관·법인급 거래 가능성 | 대형 거래 발생 | 대형 거래 부재 |
| 건물 연식 | 신축·노후 비중 | 신축 또는 리모델링 가능성 | 노후 건물 위주 |
| 매수자 구분 | 개인·법인·공공기관 | 법인 매수 증가 | 개인 단발성 거래 위주 |
| 해제건 | 취소된 거래 | 해제건 적음 | 해제건 많음 |
| 중개·직거래 | 거래 신뢰도 참고 | 중개거래 중심 | 직거래 비중 과다 시 주의 |
이 지표를 보면 단순히 “거래금액이 높다”만 보는 것이 아니라, 거래량, 평당가, 고가 거래 비중, 매수자 성격, 해제건까지 함께 판단할 수 있습니다.
11. 가격 전망 판단 공식
첨부 글은 가격 전망을 볼 때 다음 기준을 제시합니다.
가격이 오를 가능성 =
거래가 늘고
+ 평당가가 높아지고
+ 고가 거래가 많고
+ 법인/기관 매수가 있고
+ 해제건이 적을 때
상승 가능성이 높다고 판단하지만 주의해야 합니다.
이것은 확정이 아니라 가능성 평가입니다.
상승 확정
하락 확정이렇게 쓰면 안 됩니다.
대신 이렇게 써야 합니다.
상승 가능성이 있습니다.
하락 가능성이 있습니다.
판단을 보류해야 합니다.
현재 데이터만으로는 추정입니다.부동산 데이터는 한 달치만 보고 장기 전망을 확정할 수 없습니다.
12. 실무용 분석 프롬프트
API 데이터가 정상적으로 들어온 뒤에는 Claude Code에게 다음처럼 분석을 요청할 수 있습니다.
방금 가져온 마포구 2026년 3월 상업업무용 부동산 매매 실거래 데이터를 분석해 주세요.
[분석 기준]
1. 거래량
2. 평균 거래금액
3. 평당가
4. 50억 이상 거래 비중
5. 200억 이상 거래 여부
6. 건물 연식
7. 매수자 구분
8. 해제건 여부
9. 중개거래와 직거래 비중
[계산 조건]
- cdealType == "O"인 해제건은 집계에서 제외해 주세요.
- dealAmount의 콤마를 제거하고 숫자로 처리해 주세요.
- 거래금액 단위는 만원으로 유지해 주세요.
- 면적 단위는 ㎡로 유지해 주세요.
- 평당가 = dealAmount ÷ (buildingAr × 0.3025)로 계산해 주세요.
- 건물 연식 = dealYear − buildYear로 계산해 주세요.
[출력 형식]
1. 데이터 요약표
2. 핵심 지표 계산표
3. 상승 신호
4. 하락 또는 주의 신호
5. 마포구 가격 전망 한 줄 결론
[주의]
데이터만으로 확정할 수 없는 내용은 반드시 “추정”이라고 표시해 주세요.이 프롬프트는 후속 Sub-agent 실습과 연결됩니다.
Subagent 예시도 해제건 제외, 거래금액 숫자 처리, 평당가 계산, 건물 연식 계산, 거래금액 구간 분류를 지시합니다.
13. API 실습에서 자주 나는 오류
| 증상 | 원인 | 해결 |
| 인증 오류 | serviceKey 누락 또는 잘못된 키 | 일반 인증키 다시 확인 |
| 데이터 없음 | 지역코드 또는 계약월 오류 | LAWD_CD, DEAL_YMD 확인 |
| XML 파싱 오류 | 응답 형식 처리 문제 | XML 구조 확인 |
| resultCode가 00이 아님 | 요청 파라미터 오류 | 요청 URL 다시 구성 |
| totalCount가 0 | 해당 월 거래 없음 | 다른 월 또는 지역 조회 |
| 한글 깨짐 | 인코딩 문제 | UTF-8 처리 확인 |
| 요청 제한 | 트래픽 한도 초과 | 요청 횟수 줄이기 |
| 금액 계산 오류 | 단위 혼동 | 거래금액 만원 단위 확인 |
| 평당가 오류 | ㎡ → 평 변환 실수 | buildingAr × 0.3025 적용 |
14. 강의용 설명 스크립트
아래는 수업에서 그대로 읽어도 되는 설명문입니다.
여러분, 공공데이터포털은 어렵게 생각하지 않으셔도 됩니다.
정부와 공공기관이 가지고 있는 데이터를 모아 둔 인터넷 자료 창고라고 생각하시면 됩니다.
예를 들어 교통 정보, 날씨 정보, 병원 정보, 약국 정보, 관광지 정보, 미세먼지 정보, 부동산 정보가 있습니다.
예전에는 이런 데이터를 일반 사람이 쉽게 가져다 쓰기 어려웠습니다.
그런데 공공데이터포털을 이용하면 필요한 데이터를 검색하고,
파일로 다운로드하거나,
API로 연결해서 프로그램이 직접 가져오게 할 수 있습니다.
오늘은 그중에서 부동산 실거래가 API를 사용해 보겠습니다.
먼저 공공데이터포털에서 API를 검색합니다.
그다음 활용신청을 합니다.
활용신청을 하면 내 계정에 고유한 인증키가 생깁니다.
이 인증키가 바로 데이터 창고에 들어갈 수 있는 열쇠입니다.
Claude Code에게는 엔드포인트, 인증키, 지역코드, 계약월을 알려 줍니다.
그러면 Claude Code가 API에 요청하고,
응답 XML을 받아서,
필요한 데이터를 표로 정리할 수 있습니다.
중요한 것은 인증키를 절대 공개하지 않는 것입니다.
API Key는 비밀번호처럼 다뤄야 합니다.15. Q&A — 자주 묻는 질문 5가지
Q1. 공공데이터포털은 무료인가요?
대부분의 공공데이터는 무료로 활용할 수 있습니다. 다만 API마다 활용신청, 인증키, 트래픽 한도, 이용 조건이 다를 수 있으므로 각 API 상세 페이지를 확인해야 합니다.
Q2. API를 사용하려면 꼭 개발자여야 하나요?
아닙니다. API 구조를 이해하면 비개발자도 Claude Code나 AI 도구의 도움을 받아 데이터를 가져오고 분석할 수 있습니다. 다만 인증키, 요청 주소, 파라미터, 응답 형식 같은 기본 개념은 알아야 합니다.
Q3. serviceKey는 무엇인가요?
serviceKey는 공공데이터 API를 사용할 수 있게 해 주는 개인 인증키입니다. 첨부 글에서도 각 계정마다 고유의 일반 인증키가 생성되며, 개인 일반 인증키 저장이 필수라고 안내합니다.
Q4. resultCode가 00이 아니면 어떻게 하나요?
요청이 정상 처리되지 않았다는 뜻일 수 있습니다. serviceKey가 맞는지, 활용신청이 완료되었는지, LAWD_CD와 DEAL_YMD 같은 조회 조건이 맞는지 확인해야 합니다. 처음에는 numOfRows=10처럼 작은 요청으로 테스트하는 것이 좋습니다.
Q5. 부동산 가격 전망을 API 데이터만으로 확정해도 되나요?
아닙니다. API 데이터는 분석의 근거가 될 수 있지만, 한 달치 실거래 데이터만으로 가격 상승이나 하락을 확정하면 안 됩니다. 첨부 글도 데이터에 없는 내용은 “추정”이라고 표시하고, 가격 전망은 확정이 아니라 가능성 평가로 표현하라고 안내합니다.
16. 핵심 정리
공공데이터포털은 정부와 공공기관의 데이터를 모아 둔 공식 인터넷 자료 창고입니다.
API를 사용하면 Claude Code가 데이터를 직접 요청해 가져올 수 있습니다.
이번 실습에서는 국토교통부 상업업무용 부동산 매매 실거래가 자료 API를 사용합니다.
활용신청을 하면 개인 일반 인증키가 발급됩니다.
API 요청에는 다음 정보가 필요합니다.
엔드포인트
serviceKey
LAWD_CD
DEAL_YMD
numOfRows
pageNo마포구는 11440, 용산구는 11170, 성동구는 11200입니다.
2026년 3월은 DEAL_YMD=202603입니다.
가장 중요한 원칙은 두 가지입니다.
API Key는 비밀번호처럼 관리한다.
데이터 분석 결과는 확정이 아니라 근거 기반 추정으로 표현한다.마지막으로 이 문장을 기억하면 됩니다.
공공데이터 API는 정부 데이터 창고와 Claude Code를 연결해 주는 공식 데이터 통로입니다.
작성자 프로필
강호종 AI 길라잡이 강사
생성형 AI 활용 업무 효율화 전문강사 · 디지털융합교육원 지도강사 & AI 전문강사, 젠스파크 AI 전문강사 · (사)한국AINFT협회 이사
저서: 『생성형 AI 활용 업무혁신』(2026.1) · 『이것이 GEO마케팅이다』(2026) 외
📞 010-9912-9934 | 📧 art386@naver.com | Ⓑ blog.naver.com/art386 | Ⓣ aiart386.tistory.com
생성형 AI, AI 리터러시, ChatGPT·Claude·Gemini 실무 활용, AI 업무 자동화, GEO마케팅을 중심으로 공공기관·기업·단체 대상 강의와 콘텐츠를 제작합니다.
메타 설명
공공데이터포털 API 사용법을 초보자도 이해할 수 있게 정리한 글입니다. 국토교통부 상업업무용 부동산 매매 실거래가 자료 API를 예시로 활용신청, 일반 인증키 확인, 엔드포인트, 조회 조건, Claude Code 데이터 수집 프롬프트까지 설명합니다.
해시태그
#클로드시리즈 #ClaudeCode #공공데이터포털 #공공데이터API #API사용법 #부동산실거래가 #국토교통부API #MCP #Agent #Subagent #AI업무자동화 #AI리터러시 #생성형AI강의 #AI강사 #강호종강사 #AI길라잡이 #Claude활용 #ChatGPT활용 #GEO마케팅 #AX전환
