resolvelisted

# opendart — resolve a company to its corp_code Take a company handle (name, ticker, initials, or a typo) and print the matching OpenDART `corp_code`s. Most OpenDART lookups are keyed by an 8-digit `corp_code` nobody remembers; this turns a human handle into it. The matching lives in the opendart-client package (on PyPI); this skill is a thin wrapper that calls its CLI and relays the result. ## Prerequisite This plugin calls the `opendart` CLI, so install the package first: ``` pipx install opendart-client # or: pip install opendart-client ``` That puts the `opendart` command on PATH (also `python -m opendart_client`). It also needs a free OpenDART API key (get one at <https://opendart.fss.or.kr>). The simplest cross-platform way to supply it is a config file -- create `~/.config/opendart-client/credentials.json` with: ```json { "api_key": "..." } ``` (Alternatively set the `OPENDART_API_KEY` environment variable, or pass `--api-key`.) ## Running ``` opendart resolve "<QUERY>" [--json] ``` `<QUERY>` can be a name (`삼성전자`), a 6-digit ticker (`005930`), the initials (`ㅅㅅㅈㅈ`), a typo (`삼서전자`), or an 8-digit `corp_code` (passed through). `--json` returns the full candidate rows instead of the text list. The text output is one line per candidate, `corp_code ticker name`, best match first (listed companies before unlisted, then shorter names). An unlisted company shows `------` for the ticker. ## Procedure 1. **Get the query.** Find a company handle in the us