# 국가통계포털(KOSIS)

> Source: https://docs.wrks.ai/user-guide/agent-tools/kosis · Last updated: 2026-11-03

에이전트에 국가통계포털(KOSIS) 도구를 연결하면 국가데이터처(구 통계청) 승인통계 공식 DB(KOSIS)에서 원하는 통계 지표를 찾고, 데이터를 추출하고, 차트와 분석 보고서까지 한번에 만들 수 있어요. 정확한 통계 용어를 몰라도 평소 쓰는 말로 물어보면 됩니다.

### 개요

![국가통계포털(KOSIS) 도구 가이드 — 공식 통계, 일상어로 묻고 차트로 받으세요](https://docs.wrks.ai/files/d45a7e57a4e70332c3663e)

#### 일반 AI와 무엇이 다른가요?

일반 LLM은 학습 데이터로 수치를 추정하지만, 이 도구는 KOSIS 공식 DB를 직접 조회합니다.

| 비교     | 일반 AI                | 국가통계포털 MCP          |
| ------ | -------------------- | ------------------- |
| 데이터 출처 | 학습 데이터 기반 추정         | KOSIS 공식 DB 직접 조회   |
| 최신성    | 학습 시점까지 (수개월\~1년 지연) | KOSIS 최신 수록 시점까지 반영 |
| 정확성    | 할루시네이션 가능 (수치 오류)    | KOSIS 원본 수치 그대로 제공  |
| 출처 검증  | 출처 불명확               | 원본 링크 + 기준시점 명시     |
| 세부 분류  | 대략적인 전국 수치 정도        | 시도/성별/연령/품목별 세부 조회  |
| 시계열    | 단편적 수치만 제시           | 원하는 기간 시계열 + 차트 생성  |

KOSIS 공식 DB에 직접 연결되어 할루시네이션 없이 정확한 최신 데이터를 세부 분류까지 — 모든 수치에 원본 링크가 붙어 검증할 수 있습니다.

![일반 AI vs 국가통계포털 MCP 비교표](https://docs.wrks.ai/files/f7cc6262396e4809c86449)

#### 할 수 있는 것

* **스마트 지표 검색** — 일상어(서울 집값, 청년 일자리 등)를 공식 통계 용어로 자동 변환해 관련 통계표를 찾아줍니다
* **항목·분류 탐색** — 통계표에서 선택 가능한 지표(항목)와 세부 분류(지역/성별/연령/산업)를 확인
* **맞춤형 데이터 추출** — 선택한 항목·분류와 기간 범위의 시계열 데이터를 표로 추출
* **차트 자동 생성** — 선 그래프, 막대 그래프 등을 자동 생성 — 차트 유형은 대화로 변경 가능
* **2차 분석** — 전년동월비(YoY), 지역 간 격차, 이동평균, 기간별 비교 등 추가 분석
* **출처·기준 시점 명시** — 모든 결과에 KOSIS 원본 링크와 기준 시점을 함께 제공

![KOSIS 도구로 할 수 있는 것 — 6가지 기능 카드](https://docs.wrks.ai/files/31d533d5b5798b127e8ba7)


정확한 통계 용어를 몰라도 됩니다 — 평소 쓰는 말로 물어보세요.


### 사전 준비 — 에이전트에 도구 연결

국가통계포털(KOSIS)은 에이전트에 연결해 쓰는 MCP 기반 도구입니다. 사용하려는 에이전트에 국가통계포털 도구가 연결되어 있는지 확인한 뒤 대화를 시작하세요.

### 기능별 사용법

#### 일상어로 통계 찾기 ① — 서울 집값

평소 쓰는 말로 물어보면 관련 통계표를 찾고, 데이터와 차트까지 만들어줍니다.

> "서울 집값 추이를 볼 수 있는 통계 있어? 그래프도 줘봐"

"집값" → 서울 아파트 매매 실거래가격지수를 자동으로 찾고, 추이 그래프와 KOSIS 원본 링크까지 제공합니다.

![일상어 질문 — 서울 아파트 매매 실거래가격지수 자동 매칭과 추이 그래프](https://docs.wrks.ai/files/b21759e81b49874f6ec6b6)

#### 일상어로 통계 찾기 ② — 장보기 물가

막연한 질문에서도 맥락을 파악해 관련 품목을 자동으로 골라줍니다.

> "요즘 장보기가 너무 비싼데, 물가 관련 통계 뭐가 있어? 식재료를 중점으로 5년치 그래프도 만들어줘"

"장보기" 맥락을 파악해 식재료 관련 CPI 5개 품목(총지수, 식료품, 농축수산물, 신선식품, 가공식품)을 자동 선별 — 5년 추이 차트와 누적변화율 비교표까지 생성합니다.

![장보기 물가 질문 — 식재료 관련 CPI 품목 자동 선별과 5년 추이 차트](https://docs.wrks.ai/files/d1ba69f9e6a569955e4aeb)

#### 일상어로 통계 찾기 ③ — 청년 일자리

한 문장 질문으로 여러 지표와 차트를 한꺼번에 받을 수 있습니다.

> "요즘 청년 일자리 상황이 어떤지 볼 수 있는 통계 찾아줘. 그래프도 여러가지를 만들어줘"
>
> "한국 출산율이 얼마나 떨어졌는지 볼 수 있는 통계 찾아줘"
>
> "소비자물가지수 관련 통계표를 찾아줘"
>
> "국내총생산 GDP 관련 통계표 찾아줘"

경제활동인구조사 청년(15\~29세) 지표를 자동 매핑 — 고용률·실업률·경활참가율, 성별 비교, 고용보조지표까지 차트 4장을 자동 생성합니다.

![청년 일자리 질문 — 청년 고용 지표 차트 4장 자동 생성](https://docs.wrks.ai/files/9025d40e7f09070f650be0)

#### 항목·분류 선택

통계표에서 어떤 지표를 볼지, 어떤 기준(지역/성별/연령/품목)으로 나눌지 확인하고 고릅니다.

> "경제활동인구조사에서 어떤 지표들을 볼 수 있는지 알려줘"
>
> "지역별로는 어떤 값을 선택할 수 있어?"
>
> "성별이랑 연령별 분류도 보여줘"
>
> "소비자물가지수에서 품목별로 어떤 항목을 선택할 수 있어?"

총괄 지표(실업률·고용률·취업자수), 전국 + 17개 시도, 성별·연령(5세/10세 단위), 품목성질별/지출목적별 분류 체계까지 안내합니다.

![항목·분류 선택 — 통계표 내 선택 가능한 지표·분류 안내](https://docs.wrks.ai/files/917df6087964f37609749f)

#### 데이터 추출

항목·분류·기간을 지정하면 시계열 데이터를 표로 추출하고 차트도 함께 만들어줍니다.

> "전국 실업률 최근 12개월 데이터를 뽑아줘"
>
> "서울이랑 부산 실업률을 최근 12개월 비교해서 뽑아줘"
>
> "합계출산율 전국 최근 20년 데이터를 뽑아줘"
>
> "소비자물가지수 총지수 전국 최근 60개월 데이터 뽑아줘"

데이터 표(시점·값·단위) + 추이 차트 + 출처(통계표명, KOSIS URL, 기준시점)까지 한 번에 받습니다.

![데이터 추출 — 전국 실업률 12개월 표·차트와 서울·부산 비교](https://docs.wrks.ai/files/1b1d129b9b2b72884f65e7)

#### 차트 만들기

선 그래프(추이), 막대 그래프(비교)를 자동 생성하고, 만든 차트는 대화로 유형을 바꿀 수 있습니다.

> "서울이랑 전국 실업률을 최근 5년간 비교하는 선 그래프 만들어줘"
>
> "최신 시점 기준 시도별 고용률을 막대 그래프로 보여줘"
>
> "GDP 성장률(전년대비) 최근 20년을 막대 그래프로 보여줘"
>
> "이걸 선그래프로 바꿔줘" — 데이터를 다시 뽑지 않고 차트 유형만 변경됩니다

![차트 만들기 — 비교 선 그래프·시도별 막대 그래프·GDP 성장률 차트](https://docs.wrks.ai/files/be2bbed7fd0512a21deffa)

#### 2차 분석 — 전년동월비·격차·이동평균

추출한 원데이터에서 YoY, 지역 간 격차, 기간별 비교 등 추가 분석을 수행합니다.

> "소비자물가지수 총지수 최근 12개월 데이터를 뽑고, 전년동월비(YoY) 증감률을 계산해서 표와 차트로 보여줘"
>
> "서울이랑 전국 실업률 격차(서울-전국)를 계산해서 차트로 보여줘"
>
> "전국 고용률 60개월 뽑아서 12개월 이동평균 계산하고, 원 계열이랑 같이 보여줘"

"코로나 전(2018\~2019)과 후(2022\~2025)의 평균을 비교해줘"처럼 구간을 지정한 비교 분석도 가능합니다.

![2차 분석 — YoY 자동 계산 표와 이중 Y축 차트](https://docs.wrks.ai/files/7ddae538ea29a9cb5be36f)

#### 종합 보고서 만들기

표·차트·해석·출처를 포함한 보고서급 결과물을 한 문장으로 — 만든 뒤 조건만 바꿔 다시 받을 수 있습니다.

> "서울과 전국의 실업률을 최근 10년간 비교하는 보고서를 만들어줘. 표, 차트, 해석, 출처 모두 포함해줘"
>
> "실업률 말고 고용률로 바꿔서 다시 보여줘"
>
> "기간을 최근 3년으로 줄여줘"
>
> "부산도 추가해서 3개 비교로 바꿔줘"

**포함되는 것**: 요약 통계, 연평균 비교 테이블, 추이 차트(12개월 이동평균 자동 추가), 트렌드 해석, KOSIS 링크·기준시점까지 담깁니다.

![종합 보고서 만들기 — 표·차트·해석·출처 포함 결과물](https://docs.wrks.ai/files/7803cd6717d8cf367883fe)

### 활용 팁

1. **기간을 구체적으로** — "최근 데이터"보다 "최근 12개월", "2020\~2025년"처럼 명시하면 원하는 범위를 정확히 받습니다.
2. **대화가 길어지면 새 대화로** — 여러 MCP 도구를 오래 사용하면 참조 파일이 쌓여 느려질 수 있습니다. 주제가 바뀌면 새 대화를 추천합니다.
3. **그래프 개수는 적당히** — 차트 1장마다 데이터 조회 + 시각화가 필요합니다. 한번에 많이 요청하면 응답 시간과 토큰 비용이 늘어납니다. 과금 방식은 [종량제 요금표](https://docs.wrks.ai/pricing)를 참고하세요.
4. **요청 범위는 좁게** — 17개 시도 × 5개 항목 × 120개월 같은 대량 요청보다, 필요한 범위만 좁혀 요청하면 더 빠릅니다.

![활용 팁 — 기간·범위를 구체적으로 지정하는 네 가지 요령](https://docs.wrks.ai/files/671384697a1c85bb9ab273)

### 주의사항



* **승인통계 범위 내 데이터** — KOSIS에 수록된 국가 승인통계 기반입니다. 실시간 주가, 해외 통계 등 KOSIS에 없는 데이터는 제공하지 않습니다.
* **반영 시차 가능** — 국가데이터처 보도자료(속보치)와 KOSIS 수록 시점 사이에 며칠\~수 주 차이가 있을 수 있습니다.
* **잠정치/확정치 구분** — 최신 시점 데이터는 잠정치일 수 있으며, 이후 확정치로 변경될 수 있습니다.
* **장기 시계열 기준 개편** — CPI 기준연도(2020=100), 산업분류 개편 등으로 장기 비교 시 불연속이 있을 수 있습니다.


모든 결과에 KOSIS 원본 링크와 기준 시점이 제공됩니다. 중요한 수치는 원본 링크에서 한 번 더 확인하세요.

![주의사항 — 데이터 범위와 시점 특성 네 가지](https://docs.wrks.ai/files/97965df23fa5805af1e37d)

지표 찾기부터 데이터 추출, 차트, 종합 보고서까지 — KOSIS 공식 DB에서 출처가 검증되는 숫자만 받아보세요.

![국가 통계, 이제 대화로 꺼내 쓰세요 — 시작 안내](https://docs.wrks.ai/files/a35e0dbc98076e9f0c8436)