data-public

# 공공데이터 정밀 조회 (Public Data Advanced)

## 역할

공공데이터포털(data.go.kr)과 KOSIS 통계청 OpenAPI를 직접 제어해 정밀 조회·고급 분석을 수행하는 전문가. 자연어 1줄 질문은 `korean-stats` MCP로 우선 라우팅하고, 본 스킬은 OpenAPI 직접 제어·파라미터 정밀 조작·특정 엔드포인트 호출이 필요한 케이스를 담당합니다.

## 라우팅 우선순위 (중요)

| 요청 유형 | 우선 스킬/MCP | 비고 |
| --- | --- | --- |
| 자연어 KOSIS 통계 1줄 질문("광진구 고용률", "성남시 인구 추이", "전국 출산율 순위") | **korean-stats MCP** (공용키 hosted, 발급 불필요) | `quick_stats`·`quick_trend`·`quick_rank`·`chain_*` 14도구. 92 키워드 + 100+ 자연어 별칭. |
| data.go.kr 정밀 조회·특정 API 엔드포인트 직접 호출 | **본 스킬** (BYOK: DATA_GO_KR_API_KEY) | OpenAPI 직접 제어. |
| KOSIS OpenAPI 정밀 파라미터·고급 시계열 분석 | **본 스킬** (BYOK: KOSIS_API_KEY) | 통계표 ID·분류 코드 직접 지정. |
| CSV/Excel 통계 파일 분석 | `moai-analyst:data-explorer` | 파싱된 파일 분석. |
| 차트 시각화 | `moai-analyst:data-visualizer` | 차트 생성. |

> **자연어 KOSIS 통계 질문은 korean-stats MCP가 우선입니다.** 본 스킬은 (1) data.go.kr의 다양한 API를 직접 제어할 때, (2) KOSIS에서 특정 통계표 ID·분류 항목을 정밀하게 지정해야 할 때, (3) OpenAPI 응답을 가공·분석해야 할 때 사용합니다.

## 지원 데이터 소스

### 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: 라우팅 확인

자연어 1줄 질문이면 `korean-stats` MCP 우선. 본 스킬은 아래 케이스에만 진입:

- data.go.kr 특정 API 엔드포인트 직접 지정 필요
- KOSIS 통계표 ID·분류 항목 코드를 정밀하게 제어해야
- OpenAPI 응답 원본(JSON/XML/SDMX) 가공 필요

### Step 2: 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회/일

   또는 자연어 1줄 질문이면 korean-stats MCP(키 불필요)를 사용하세요.

   어떤 API 키를 등록하시겠습니까?"

  AskUserQuestion:
  ○ 공공데이터포털 키 입력 (권장)
  ○ KOSIS 통계 키 입력
  ○ 두 키 모두 입력
  ○ korean-stats MCP로 자연어 조회 (키 불필요)
  + Other

  → 키 입력 후 ${CLAUDE_PLUGIN_DATA}/moai-credentials.env에 저장
  → Step 3로 진행
```

### Step 3: 데이터 검색
- 사용자 요청에서 키워드·API 엔드포인트·파라미터 추출
- WebFetch로 API 호출
- 결과 파싱 (JSON/XML/SDMX)

### Step 4: 결과 정리
- 마크다운 테이블로 데이터 표시
- 시각화 필요 시 moai-analyst:data-visualizer 연계

## 주요 KOSIS 통계 분류

| 분류 | 코드 | 예시 |
|------|------|------|
| 인구 | MT_ZTITLE | 인구총조사, 주민등록인구 |
| 경제 | MT_ZTITLE | GDP, 경제성장률 |
| 물가 | MT_ZTITLE | 소비자물가지수 |
| 고용 | MT_ZTITLE | 경제활동인구, 실업률 |

## 이 스킬을 사용하지 말아야 할 때

- **자연어 KOSIS 통계 1줄 질문** → `korean-stats` MCP 우선 (`quick_stats`·`quick_trend`·`quick_rank`·`chain_*`). 공용키 hosted라 발급 불필요. 92 키워드 + 100+ 자연어 별칭, 17 시도 + 230+ 자치구 라우팅, 추계/잠정치 구분, 출처 자동 인용까지 지원.
- **CSV/Excel 분석** → `moai-analyst:data-explorer` 사용
- **차트 생성** → `moai-analyst:data-visualizer` 사용
- **기업 공시·재무** → `dart` MCP(korean-dart-mcp) 사용 — 공시·재무·지분·XBRL + 버핏급 애널리스트 프레임(insider_signal·disclosure_anomaly·buffett_quality_snapshot)

## References

| 파일 | 로드 조건 |
|------|-----------|
| references/public-data/guide.md | data.go.kr·KOSIS OpenAPI 호출 패턴·파라미터 지정 등 정밀 조회 방법이 필요할 때 |