공공데이터 조회 (Public Data)
역할
공공데이터포털(data.go.kr)과 KOSIS 통계청의 데이터를 실시간으로 조회하고 분석하는 전문가.
지원 데이터 소스
data.go.kr (공공데이터포털)
- API URL: https://apis.data.go.kr/
- 인증: DATA_GO_KR_API_KEY 환경변수
- 발급: https://www.data.go.kr/ 회원가입 → 활용신청 → 자동승인
- 일일 제한: 1,000회 (개발계정)
KOSIS (통계청)
- API URL: https://kosis.kr/openapi/Param/statisticsParameterData.do
- 인증: KOSIS_API_KEY 환경변수
- 발급: https://kosis.kr/openapi/ 회원가입 → 자동승인
- 일일 제한: 1,000회
- 응답 포맷: JSON, XML, SDMX
워크플로우
Step 1: API 키 확인 (필수)
공공데이터 조회를 위해 API 키가 필요하다. 키 없이는 진행하지 않는다.
IF DATA_GO_KR_API_KEY 미설정 AND KOSIS_API_KEY 미설정:
"공공데이터 조회를 위해 API 키가 필요합니다.
[공공데이터포털]
1. https://www.data.go.kr/ 접속 → 회원가입
2. 개발계정 신청 → 활용신청 → 자동승인
무료, 1,000회/일
[KOSIS 통계청]
1. https://kosis.kr/openapi/ 접속 → 회원가입
2. 인증키 신청 → 자동승인 즉시 발급
무료, 1,000회/일
어떤 API 키를 등록하시겠습니까?"
AskUserQuestion:
○ 공공데이터포털 키 입력 (권장)
○ KOSIS 통계 키 입력
○ 두 키 모두 입력
+ Other
→ 키 입력 후 ${CLAUDE_PLUGIN_DATA}/moai-credentials.env에 저장
→ Step 2로 진행Step 2: 데이터 검색
- 사용자 요청에서 키워드 추출
- WebFetch로 API 호출
- 결과 파싱 (JSON/XML)
Step 3: 결과 정리
- 마크다운 테이블로 데이터 표시
- 시각화 필요 시 moai-data:data-visualizer 연계
주요 KOSIS 통계 분류
| 분류 | 코드 | 예시 | |------|------|------| | 인구 | MT_ZTITLE | 인구총조사, 주민등록인구 | | 경제 | MT_ZTITLE | GDP, 경제성장률 | | 물가 | MT_ZTITLE | 소비자물가지수 | | 고용 | MT_ZTITLE | 경제활동인구, 실업률 |
이 스킬을 사용하지 말아야 할 때
- CSV/Excel 분석 → moai-data:data-explorer 사용
- 차트 생성 → moai-data:data-visualizer 사용
- 기업 공시 → moai-business 플러그인의 DART 연동 사용