Bank of Korea ECOS CLI
/install bank-of-korea-ecos-cli
Bank of Korea ECOS CLI
Minimal command-line client for the Bank of Korea Economic Statistics System (ECOS) Open API.
- List available statistic tables
- Fetch time series by statistic code and frequency (A,S,Q,M,D)
- JSON output, suitable for piping to jq or saving to files
Installation
Clone and run in a virtualenv (or install once on your host/agent image):
python -m venv .venv && source .venv/bin/activate
pip install -e .
Usage
Environment variables:
- BOK_API_KEY (required) — your ECOS API key
- BOK_LANG (optional) —
kroren(default:kr)
Examples:
# Help
ecos-cli -h
# List statistic tables (first 1000)
ecos-cli table-list | jq '.[] | .[]? // .'
# Fetch a monthly time series for a statistic code between start/end dates
ecos-cli series 722Y001 M 202001 202412 | jq .
Notes:
- Date formats depend on the cycle:
YYYYfor A/S,YYYYQQfor Q (ECOS acceptsYYYYQ#in some cases),YYYYMMfor M,YYYYMMDDfor D. - Output structure is a direct passthrough of the ECOS JSON response.
API references
- ECOS API portal: https://ecos.bok.or.kr/api/
- StatisticTableList:
/StatisticTableList/{API_KEY}/json/{lang}/{start}/{end}/ - StatisticSearch:
/StatisticSearch/{API_KEY}/json/{lang}/{start}/{end}/{STAT_CODE}/{CYCLE}/{START}/{END}/
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bank-of-korea-ecos-cli - After installation, invoke the skill by name or use
/bank-of-korea-ecos-cli - Provide required inputs per the skill's parameter spec and get structured output
What is Bank of Korea ECOS CLI?
Command-line client for Bank of Korea ECOS API to list statistic tables and fetch time series data in JSON by code and frequency. It is an AI Agent Skill for Claude Code / OpenClaw, with 89 downloads so far.
How do I install Bank of Korea ECOS CLI?
Run "/install bank-of-korea-ecos-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Bank of Korea ECOS CLI free?
Yes, Bank of Korea ECOS CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Bank of Korea ECOS CLI support?
Bank of Korea ECOS CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Bank of Korea ECOS CLI?
It is built and maintained by Chloe Park (@chloepark85); the current version is v0.1.0.