← Back to Skills Marketplace
chloepark85

Bank of Korea ECOS CLI

by Chloe Park · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ⚠ suspicious
89
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install bank-of-korea-ecos-cli
Description
Command-line client for Bank of Korea ECOS API to list statistic tables and fetch time series data in JSON by code and frequency.
README (SKILL.md)

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) — kr or en (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: YYYY for A/S, YYYYQQ for Q (ECOS accepts YYYYQ# in some cases), YYYYMM for M, YYYYMMDD for 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}/
Usage Guidance
This skill appears to describe a legitimate ECOS CLI and only needs your ECOS API key, but the SKILL.md expects you to clone and install a local Python package yet provides no repository or packaged code. Before installing or providing your BOK_API_KEY: 1) Ask the skill author for the repository URL or a packaged release you can inspect. 2) If you clone/install code, review it locally (or in an isolated environment) before running pip install -e . 3) Confirm ecos-cli is a known tool or comes from a trusted source; do not paste your API key into unknown scripts. 4) If you only need to call ECOS, consider using curl or writing a small script yourself that calls the documented endpoints so you control the code that sees the key.
Capability Analysis
Type: OpenClaw Skill Name: bank-of-korea-ecos-cli Version: 0.1.0 The skill bundle contains metadata and documentation for a CLI tool designed to interface with the Bank of Korea Economic Statistics System (ECOS) API. The documentation in SKILL.md describes standard API usage, requires a legitimate environment variable (BOK_API_KEY), and points to official government API endpoints (ecos.bok.or.kr). No malicious instructions, prompt injection attempts, or suspicious behaviors were identified in the provided files.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The name/description (ECOS CLI) aligns with the single required env var (BOK_API_KEY). However, the installation instructions assume a local Python package (pip install -e .) and say "Clone and run" but do not provide a repository URL or any packaged binary — the skill bundle contains no code. That mismatch is unexplained.
Instruction Scope
SKILL.md only instructs using the ECOS API via an ecos-cli command and reading BOK_API_KEY/BOK_LANG. It does not request unrelated files, paths, or extra credentials. The scope is appropriate for the described function, but the runtime instructions assume a local project layout (venv, pip install -e .) that isn't present or linked.
Install Mechanism
There is no install spec in the registry (instruction-only skill), which is low-risk. The only install instructions are in SKILL.md and require cloning/packaging a local Python project — but no external download URL or package is provided by the skill itself.
Credentials
Only one credential is required (BOK_API_KEY) and that matches the API the CLI is meant to call. The optional BOK_LANG is reasonable. There are no other env vars or secrets requested.
Persistence & Privilege
The skill is not always-enabled and allows user invocation/autonomous invocation per platform defaults. It does not request persistent system-wide privileges or modify other skills' configs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install bank-of-korea-ecos-cli
  3. After installation, invoke the skill by name or use /bank-of-korea-ecos-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial release
Metadata
Slug bank-of-korea-ecos-cli
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments