listlisted

# kosis -- list (catalog tree) Discover the codes a KOSIS statistic is stored under by browsing its catalog tree. KOSIS keys every table by an organization code (`org_id`) plus a table code (`tbl_id`), and `kosis list` walks the classification tree one level at a time until it reaches the tables. The listing and parsing live in the pykosis package (on PyPI); this skill is a thin wrapper that calls its CLI and relays the result. To find a table by keyword instead, use the **search** skill. ## Prerequisite This plugin calls the `kosis` CLI, so the package must be installed and an API key set: ``` pipx install pykosis # or: pip install pykosis export KOSIS_API_KEY=... # a free key from https://kosis.kr/openapi/ ``` The key can also be stored in `~/.config/pykosis/credentials.json` as `{"KOSIS_API_KEY": "..."}`. Without a key the CLI exits with `kosis: no KOSIS API key ...`; relay that and point the user at the KOSIS site. **Never print, log, quote, or echo the `KOSIS_API_KEY` value itself** -- confirm only that a key is set. ## Running ``` kosis list [--view VIEW] [--parent LIST_ID] [--json] ``` - With no `--parent`, `kosis list` lists the top of a view; pass a returned `list_id` as `--parent` to descend one level. The KOSIS tree is deep, so drill down one step at a time. - A row with a `tbl_id` is a table you can hand to the **data** skill; a row with only a `list_id` is a folder to descend into. - `--view` picks a classification view (`subject`, `or