> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/user-guide/undefined-1/kosis.md).

# 국가통계포털(KOSIS)

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

### 개요

![국가통계포털(KOSIS) 도구 가이드 — 공식 통계, 일상어로 묻고 차트로 받으세요](https://deck.onpod.ai/d/5dhaYM/p/36.jpg)

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

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

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

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

![일반 AI vs 국가통계포털 MCP 비교표](https://deck.onpod.ai/d/5dhaYM/p/37.jpg)

#### 할 수 있는 것

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

![KOSIS 도구로 할 수 있는 것 — 6가지 기능 카드](https://deck.onpod.ai/d/5dhaYM/p/38.jpg)

{% hint style="info" %}
정확한 통계 용어를 몰라도 됩니다 — 평소 쓰는 말로 물어보세요.
{% endhint %}

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

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

### 기능별 사용법

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

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

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

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

![일상어 질문 — 서울 아파트 매매 실거래가격지수 자동 매칭과 추이 그래프](https://deck.onpod.ai/d/5dhaYM/p/39.jpg)

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

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

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

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

![장보기 물가 질문 — 식재료 관련 CPI 품목 자동 선별과 5년 추이 차트](https://deck.onpod.ai/d/5dhaYM/p/40.jpg)

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

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

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

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

![청년 일자리 질문 — 청년 고용 지표 차트 4장 자동 생성](https://deck.onpod.ai/d/5dhaYM/p/41.jpg)

#### 항목·분류 선택

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

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

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

![항목·분류 선택 — 통계표 내 선택 가능한 지표·분류 안내](https://deck.onpod.ai/d/5dhaYM/p/42.jpg)

#### 데이터 추출

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

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

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

![데이터 추출 — 전국 실업률 12개월 표·차트와 서울·부산 비교](https://deck.onpod.ai/d/5dhaYM/p/43.jpg)

#### 차트 만들기

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

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

![차트 만들기 — 비교 선 그래프·시도별 막대 그래프·GDP 성장률 차트](https://deck.onpod.ai/d/5dhaYM/p/44.jpg)

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

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

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

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

![2차 분석 — YoY 자동 계산 표와 이중 Y축 차트](https://deck.onpod.ai/d/5dhaYM/p/45.jpg)

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

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

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

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

![종합 보고서 만들기 — 표·차트·해석·출처 포함 결과물](https://deck.onpod.ai/d/5dhaYM/p/46.jpg)

### 활용 팁

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

![활용 팁 — 기간·범위를 구체적으로 지정하는 네 가지 요령](https://deck.onpod.ai/d/5dhaYM/p/47.jpg)

### 주의사항

{% hint style="warning" %}

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

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

![주의사항 — 데이터 범위와 시점 특성 네 가지](https://deck.onpod.ai/d/5dhaYM/p/48.jpg)

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

![국가 통계, 이제 대화로 꺼내 쓰세요 — 시작 안내](https://deck.onpod.ai/d/5dhaYM/p/49.jpg)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/user-guide/undefined-1/kosis.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.