kosis-stats

Search KOSIS Open API for Korean statistics tables and fetch filtered data cells.

7.1k|836|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill kosis-stats
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: kosis-stats
Source: https://github.com/NomaDamas/k-skill/tree/main/kosis-stats
Command: npx skills add https://github.com/NomaDamas/k-skill --skill kosis-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

KOSIS(๊ตญ๊ฐ€ํ†ต๊ณ„ํฌํ„ธ) Open API๋กœ ํ•œ๊ตญ ๊ณต์‹ ํ†ต๊ณ„ํ‘œ๋ฅผ ์ง์ ‘ ์ฐพ์•„๋ณด๊ณ , ํ‘œ์˜ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ์™€ ๊ธฐ๊ฐ„ยท๋ถ„๋ฅ˜์— ๋งž๋Š” ์ˆ˜์น˜๋ฅผ ๋ฐ˜๋ณตํ•ด์„œ ์กฐํšŒํ•˜๋Š” ๋ฒˆ๊ฑฐ๋กœ์›€์„ ์ค„์—ฌ์ค๋‹ˆ๋‹ค.

Core Features & Use Cases

  • ๊ณต์‹ ํ†ต๊ณ„ํ‘œ ๊ฒ€์ƒ‰(Search): ํ‚ค์›Œ๋“œ๋กœ ํ†ต๊ณ„ํ‘œ ํ›„๋ณด๋ฅผ ์ฐพ์•„ ํ†ต๊ณ„ํ‘œ ID(ORG_ID/TBL_ID)๋ฅผ ๋น ๋ฅด๊ฒŒ ํ™•๋ณดํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ ์กฐํšŒ(Meta): ํ‘œ์˜ ๋ถ„๋ฅ˜ ์ฐจ์›(OBJ/ITM), ํ•ญ๋ชฉ, ๋‹จ์œ„ ๋“ฑ์„ ํ™•์ธํ•ด ์˜ฌ๋ฐ”๋ฅธ ํŒŒ๋ผ๋ฏธํ„ฐ๋กœ ๋ฐ์ดํ„ฐ๋ฅผ ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ๊ฒŒ ํ•ฉ๋‹ˆ๋‹ค.
  • ๋ฐ์ดํ„ฐ ์…€ ์กฐํšŒ(Data): ๊ธฐ๊ฐ„(์—ฐ/์›”/๋ถ„๊ธฐ ๋“ฑ)๊ณผ ๋ถ„๋ฅ˜(ํ•„์ˆ˜ ์ฐจ์› ํฌํ•จ)๋ฅผ ์ง€์ •ํ•ด ์กฐํšŒ ์ „์šฉ์œผ๋กœ ์›์‹œ ์ˆ˜์น˜๋ฅผ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.
  • ๋Œ€์šฉ๋Ÿ‰ ์กฐํšŒ(Bigdata, ์„ ํƒ): ํฐ ๋ฒ”์œ„์˜ ๋ฐ์ดํ„ฐ๋ฅผ ๋ฐ›๊ธฐ ์œ„ํ•ด ์‚ฌ์ „ ๋“ฑ๋ก๋œ userStatsId ๊ธฐ๋ฐ˜์œผ๋กœ ๋Œ€์šฉ๋Ÿ‰ endpoint๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.

์‹ค์ œ ์‚ฌ์šฉ ์˜ˆ:

  • โ€œ1์ธ ๊ฐ€๊ตฌ ๋น„์œจโ€ ํ†ต๊ณ„ํ‘œ๋ฅผ ๊ฒ€์ƒ‰ํ•œ ๋’ค, ๋ฉ”ํƒ€๋ฅผ ํ™•์ธํ•˜๊ณ  ์ตœ๊ทผ 5๊ฐœ๋…„ ๋˜๋Š” ํŠน์ • ์—ฐ๋„ ๋ฒ”์œ„์˜ ์ˆ˜์น˜๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค.
  • ํŠน์ • ์ง€์—ญ/๋ถ„๋ฅ˜ ์ฐจ์›์ด ํ•„์š”ํ•œ ํ‘œ์—์„œ ์ฝ”๋“œ ์˜ค๋ฅ˜(ํ•„์ˆ˜ ๋ถ„๋ฅ˜ ๋ˆ„๋ฝ)๋ฅผ ๋ฉ”ํƒ€ ์กฐํšŒ๋กœ ํšŒ๋ณตํ•˜๋Š” ํ๋ฆ„์„ ์•ˆ๋‚ดํ•ฉ๋‹ˆ๋‹ค.

Quick Start

Ask: โ€œKOSIS์—์„œ 1์ธ ๊ฐ€๊ตฌ ๋น„์œจ ํ†ต๊ณ„ํ‘œ๋ฅผ ์ฐพ์•„์„œ 2023~2024๋…„ ์ „๊ตญ์˜ ์ˆ˜์น˜๋งŒ ์กฐํšŒํ•ด์ค˜.โ€

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 data from the KOSIS Open API?โ–ผ

To retrieve official Korean statistics data from the KOSIS Open API, search for a statistics table by keyword to extract its ORG_ID and TBL_ID, fetch the table metadata for required dimensions, and then query filtered data cells for specific periods and classifiers.

What is the best way to find specific table identifiers in Korean official statistics?โ–ผ

The best way to find specific table identifiers in Korean official statistics is to perform a keyword search via the KOSIS Open API, which returns candidate tables along with their unique ORG_ID and TBL_ID needed for subsequent data retrieval.

Why does my KOSIS API data retrieval fail when I omit certain classifier codes?โ–ผ

KOSIS API data retrieval fails when required classifier codes are omitted because the table has mandatory dimension constraints. You must first query the table metadata to identify and include all required dimension and classifier codes in your request.

Can I retrieve large volumes of Korean bigdata statistics through the standard API endpoint?โ–ผ

To retrieve large volumes of Korean bigdata statistics, you cannot use the standard endpoint. You must use the optional bigdata endpoint by registering a userStatsId beforehand to handle the expanded data range.

Does the KOSIS API integration support write operations or data modification?โ–ผ

No, the KOSIS API integration provides read-only access exclusively. It uses strict HTTPS endpoints and proxy-based access to fetch statistics table metadata and filtered data cells without supporting any write or data modification operations.