kosis-cli

Minimal command-line wrapper for KOSIS — 국가통계포털 (Korean Statistical Information Service) OpenAPI.

KOSIS is the central registry for Korean national statistics maintained by Statistics Korea (통계청), aggregating ~1,000 datasets from 100+ government agencies. This wrapper exposes five operations:

1. search — keyword search across statistic titles (e.g. "소비자물가", "출생").
2. list — browse the statistics tree by topic/agency (참조 ID listing).
3. meta — fetch metadata for a specific table: classification items, period type, last updated.
4. data — pull actual numeric data for a (orgId, tblId) with item/dimension/period filters.
5. bulk — pull a large pre-saved userStatsId slice (saved on kosis.kr OpenAPI 활용신청).

All output is compact JSON (format=json&jsonVD=Y), one row per line (JSONL) so it pipes directly into jq.

When to use this skill