kosis-stats

Retrieve KOSIS Open API statistics table metadata and data cells.

8|1|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/mouseco/k-gov-skills --skill kosis-stats-mouseco
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: kosis-stats
Source: https://github.com/mouseco/k-gov-skills/tree/main/skills/kosis-stats
Command: npx skills add https://github.com/mouseco/k-gov-skills --skill kosis-stats-mouseco

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

๊ณต๊ณต๊ธฐ๊ด€ ๋ฌธ์„œ์— ๋“ค์–ด๊ฐˆ ํ•œ๊ตญ ๊ณต์‹ ํ†ต๊ณ„ ์ˆ˜์น˜๋ฅผ, KOSIS Open API์—์„œ ์‚ฌ๋žŒ์ด ์ผ์ผ์ด ์ฐพ๊ณ  ๋ฉ”ํƒ€/๋ฐ์ดํ„ฐ๋ฅผ ์กฐํ•ฉํ•˜๋Š” ๋ฐ˜๋ณต ์ž‘์—… ์—†์ด ๋น ๋ฅด๊ฒŒ ์กฐํšŒํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•์Šต๋‹ˆ๋‹ค.

Core Features & Use Cases

  • KOSIS ํ†ต๊ณ„ํ‘œ ๊ฒ€์ƒ‰: ํ‚ค์›Œ๋“œ๋กœ ํ†ต๊ณ„ํ‘œ ํ›„๋ณด๋ฅผ ์ฐพ์•„ org_id/tbl_id๋ฅผ ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค.
  • ํ†ต๊ณ„ํ‘œ ๋ฉ”ํƒ€ ์กฐํšŒ: ๋ถ„๋ฅ˜(OBJ/ITM), ๋‹จ์œ„, ์ˆ˜๋ก์ฃผ๊ธฐ ๋“ฑ ๋ฐ์ดํ„ฐ ๊ตฌ์กฐ๋ฅผ ๋จผ์ € ํ™•์ธํ•œ ๋’ค ๋‹ค์Œ ๋‹จ๊ณ„๋กœ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
  • ํ†ต๊ณ„ ๋ฐ์ดํ„ฐ ์…€ ์กฐํšŒ: ๊ธฐ๊ฐ„๊ณผ ๋ถ„๋ฅ˜ ํ•„ํ„ฐ๋ฅผ ์ ์šฉํ•ด ํ•„์š”ํ•œ ๊ตฌ๊ฐ„์˜ ์ˆ˜์น˜ ๋ฐ์ดํ„ฐ๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.
  • ๋Œ€์šฉ๋Ÿ‰ ์ž๋ฃŒ์šฉ bigdata: ํฐ ๋ฒ”์œ„(๋Œ€์šฉ๋Ÿ‰ ์…€) ์กฐํšŒ๋ฅผ ์œ„ํ•ด ์‚ฌ์ „ ๋“ฑ๋ก๋œ userStatsId ๊ธฐ๋ฐ˜์œผ๋กœ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ›์Šต๋‹ˆ๋‹ค.
  • Use when: ๊ณต๋ฌด์›/๊ณต๊ณต๊ธฐ๊ด€ ๋ณด๊ณ ์„œ, ์‚ฌ์—…๊ณ„ํš, ์ •์ฑ… ๊ทผ๊ฑฐ์กฐ์‚ฌ์—์„œ ์ธ๊ตฌยท๊ณ ๋ นํ™”ยท์ฒญ๋…„ยท๊ณ ์šฉยท๋ฌผ๊ฐ€ยท์ง€์—ญ๊ฒฝ์ œยท๊ต์œกยท๋ณต์ง€ ๊ฐ™์€ ์ง€ํ‘œ์˜ ์ˆ˜์น˜๋ฅผ ๊ทผ๊ฑฐ๋กœ ์ •๋ฆฌํ•ด์•ผ ํ•  ๋•Œ

Quick Start

Ask the AI to run kosis-stats search for the keyword "1์ธ ๊ฐ€๊ตฌ" and return the top table ids to use next.

Frequently Asked Questions about kosis-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve official Korean statistics from the KOSIS Open API?โ–ผ

To retrieve official Korean statistics from the KOSIS Open API, search for a table by keyword to find its org_id and tbl_id, validate the metadata dimensions, then fetch the bounded data cells using your API key or proxy.

What is the process for getting KOSIS metadata before fetching data cells?โ–ผ

Getting KOSIS metadata involves querying the table structure to verify classifications, units, and time periods before fetching data cells, ensuring you apply the correct dimension filters for your public sector evidence.

Can I retrieve large datasets from KOSIS using bigdata endpoints?โ–ผ

Yes, you can retrieve large datasets from KOSIS using the bigdata flow, which requires a pre-registered userStatsId to successfully fetch large volumes of data cells beyond standard rate and row limits.

Do I need a direct KOSIS API key to fetch public sector statistics?โ–ผ

You need either a direct KOSIS API key or a hosted and self-hosted proxy with HTTP access to fetch public sector statistics, enforcing read-only usage while retrieving official statistics table metadata and data.

What are the limitations when fetching official statistics data cells?โ–ผ

Limitations when fetching official statistics data cells include KOSIS rate and row limit handling, requiring you to bound your time period and classifier slice carefully to avoid errors during API retrieval.