searchlisted

# kosis -- search (keyword) Discover the codes a KOSIS statistic is stored under by keyword. KOSIS keys every table by an organization code (`org_id`) plus a table code (`tbl_id`), and `kosis search` returns every table whose name matches a keyword, ranked. The searching and parsing live in the pykosis package (on PyPI); this skill is a thin wrapper that calls its CLI and relays the result. To walk the classification tree instead of searching, use the **list** 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 search "<검색어>" [--sort rank|date] [--page-size N] [--page N] [--org ORG_ID] [--json] ``` - `kosis search "<검색어>"` finds tables whose name matches the keyword; each hit carries its `org_id` and `tbl_id` -- the codes the **data** skill needs. - A keyword can match tables across many subjects (e.g. `생명` hits both 생명표 and 생명보험 tables). Each row also carries `full_path_id` / `mt_atitle`, its classification path -- use `--json` to see