kosis-stats
nomadamas/k-skill
Query official Korean statistics from KOSIS Open API—population, household, price, employment data.
What is kosis-stats?
Access Korea's official statistics portal (KOSIS) via Open API to search statistical tables and retrieve metadata, datasets, and bulk data. Use this when users need specific Korean government statistics figures; not for analysis or visualization.
- Search official Korean statistical tables by keyword or table ID
- Retrieve metadata about available statistics and their structure
- Query actual statistical data with filtering and parameters
- Download large datasets in bulk format
- Access population, household, price, employment, and other official statistics
How to install kosis-stats
npx skills add https://github.com/nomadamas/k-skill --skill kosis-stats- Node.js 18 or later
- KOSIS Open API key (obtain from kosis.kr)
How to use kosis-stats
- 1.Run `npx -y @nomadamas/k-skill@0 instruct kosis-stats` to get full runtime-specific instructions
- 2.Obtain your KOSIS Open API credentials from the official portal
- 3.Configure the skill with your API key following the CLI instructions
- 4.Use the skill to search for statistical tables by name or ID
- 5.Specify parameters (time period, region, etc.) to filter results
- 6.Retrieve and work with the returned metadata or data
Use cases
- Look up current unemployment rate or employment statistics for Korea
- Retrieve household income or consumption data from official sources
- Find population demographics by region or age group
- Query inflation or price index data from KOSIS
- Bulk download historical statistical datasets for further analysis
- Data analysts working with Korean government statistics
- Researchers needing official Korean demographic or economic data
- Business intelligence professionals tracking Korean market indicators
- Policy analysts requiring authoritative Korean statistical sources
kosis-stats FAQ
This skill only queries and retrieves official Korean statistics from KOSIS; it does not perform analysis, visualization, or interpretation of the data.
Yes, you need to register at kosis.kr and obtain an Open API key to authenticate requests.
KOSIS covers official Korean government statistics including population, households, prices, employment, national accounts, and many other economic and social indicators.
Yes, the skill supports bulk data retrieval for large statistical datasets.
Yes, it is designed for Korean statistics and the skill documentation is in Korean (ko-KR).
Full instructions (SKILL.md)
Source of truth, from nomadamas/k-skill.
name: kosis-stats description: 국가데이터처가 운영하는 KOSIS(국가통계포털, kosis.kr) Open API로 한국 공식 통계표를 검색하고 메타데이터·데이터·대용량 자료를 조회한다. Use when the user asks for 한국 공식 통계 (인구, 가구, 물가, 고용 등) 수치 조회, not for analysis or visualization. license: MIT metadata: category: data locale: ko-KR phase: v1
kosis-stats
<!-- k-skill:cli-stub — generated by scripts/generate-skill-stubs.js; edit skill.json / instruction.md instead -->Get the full instructions (required first step)
Run this and follow its output as the primary instructions for this skill:
npx -y @nomadamas/k-skill@0 instruct kosis-stats
The CLI detects the current runtime (Dolshoi vault/CloakBrowser vs generic) and prints only the applicable instructions, always up to date. Helper files bundled with the CLI are listed by:
npx -y @nomadamas/k-skill@0 files kosis-stats
Keep the CLI and every coding-agent skill install current (including Vercel Agent Skills) with:
npx -y @nomadamas/k-skill@0 update
If npx is unavailable, install Node.js 18+ or follow https://github.com/NomaDamas/k-skill#readme, or read the source instructions at https://github.com/NomaDamas/k-skill/blob/main/kosis-stats/instruction.md.
Hard rules even without the CLI
- Never execute payment, message/email delivery, final submission, cancellation, or public posting without the user's explicit approval immediately beforehand.
- Never ask for, print, or store plaintext credentials in chat, files, or shell arguments.
- Never bypass legal, physical-presence, CAPTCHA, identity-proofing, or electronic-signature boundaries.
Related skills
More from nomadamas/k-skill and the wider catalog.
kr-whois-lookup
Look up public WHOIS registration data for .kr/.한국 domains, IP addresses, and AS numbers.
kstartup-search
Search K-Startup public data for startup grants, business info, and content via Korean government API
ktx-booking
Read-only KTX train timetable lookup from official Korail public data—no login or booking.
lck-analytics
Query LCK League of Legends esports match results, standings, meta analysis, and team power ratings.
lh-notice-search
Search official Korea Land & Housing Corporation (LH) lease and subscription notices on apply.lh.or.kr.
library-book-search
Search Korean public library catalogs and check book availability across library networks.