KRX Stock CLI

Korean Exchange (KRX) stock market data CLI. Fetch daily OHLCV, latest-close snapshots, market-cap rankings, index histories (KOSPI/KOSDAQ/KOSPI200/KRX100),...

Security Scan

The skill's code, instructions, and dependencies are consistent with a zero‑config CLI for KRX data; it asks for no unrelated credentials or system access and behaves as described.

Purpose & Capability

Name/description match the provided code and SKILL.md. The CLI wraps FinanceDataReader and pandas to provide ticker lookups, OHLCV, market-cap rankings and index histories — all consistent with the stated purpose.

Instruction Scope

SKILL.md only instructs running the included Python CLI and installing its Python deps. The runtime code accesses network data only via FinanceDataReader (expected) and does not read environment variables, unrelated files, or exfiltrate data to unexpected endpoints.

Install Mechanism

No automated install spec is embedded; installation is a standard pip install -r scripts/requirements.txt. Dependencies are public Python packages (finance-datareader, pandas). No downloads from untrusted URLs or archive extraction are present in the skill bundle.

Credentials

The skill declares no required env vars, no primary credential, and the code does not reference secrets or other credentials. Requested resources are proportional to the functionality.

Persistence & Privilege

always:false and no code to modify other skills or system-wide settings. The skill runs as a normal CLI and does not request elevated persistence or privileges.

Assessment

This skill appears coherent and implements exactly what it advertises: a Python CLI that uses FinanceDataReader and pandas to fetch public KRX and related market data. Before installing, consider: (1) run pip install inside a virtual environment; (2) FinanceDataReader will make HTTP requests to public data sources (Naver Finance, KRX, etc.), so if you need strict data provenance verify those upstream sources yourself; (3) the package metadata lists no homepage/source in the registry, but the repository URL appears in README—if provenance matters, review the upstream GitHub repo and its release history; (4) no secrets are required by this skill, so it does not attempt to access credentials or system files.

Zero-config CLI for Korean Exchange (KRX) market data: daily OHLCV, latest-close snapshots, market-cap rankings, index histories, and ticker lookups for KOSPI / KOSDAQ / KONEX / ETF tickers.

Backed by FinanceDataReader, which aggregates KRX, Naver Finance, and related public sources. No API key required.

When to use

Trigger on:

• Korean stock price / OHLCV requests ("삼성전자 주가", "005930 price history")
• Market-cap ranking / latest close snapshots
• Index series (KOSPI, KOSDAQ, KOSPI 200, KRX 100)
• Ticker ↔ company-name resolution
• Company name substring search
• Global-index tagalong queries (S&P 500, Nasdaq, Nikkei, Shanghai)

Do not use for:

• Corporate filings / disclosures → use opendart-cli
• Fundamentals per day (PER/PBR/EPS) — not exposed; use DART financial statements instead
• Real-time ticks / order book (data is EOD; today's bar is available after market close)

Install

pip install -r scripts/requirements.txt

Dependencies: finance-datareader, pandas.

Usage

All commands are sub-commands of scripts/krx.py. JSON by default; pass --csv for CSV to stdout.

Dates accept either YYYYMMDD or YYYY-MM-DD.

Ticker lookup

python scripts/krx.py ticker 005930            # → 삼성전자
python scripts/krx.py ticker "SK하이닉스"       # → 000660
python scripts/krx.py search 카카오 --top 5     # substring search

OHLCV

python scripts/krx.py ohlcv 005930 --days 30
python scripts/krx.py ohlcv 005930 --start 20260101 --end 20260420 --csv

Latest-close snapshot

python scripts/krx.py snapshot 005930

Market-cap ranking

python scripts/krx.py marketcap --market KRX --top 50
python scripts/krx.py marketcap --market KOSDAQ --top 20 --csv

--market accepts KRX, KOSPI, KOSDAQ, KONEX, ETF/KR.

List all tickers in a market

python scripts/krx.py list --market KOSPI --top 100

Index

python scripts/krx.py index KS11 --days 90       # KOSPI
python scripts/krx.py index KS200 --days 30      # KOSPI 200
python scripts/krx.py index IXIC --days 30       # NASDAQ Composite
python scripts/krx.py index-list                 # common codes

Common codes: KS11 KOSPI · KQ11 KOSDAQ · KS200 KOSPI 200 · KRX100 KRX 100 · DJI Dow · IXIC Nasdaq · US500 S&P 500 · N225 Nikkei 225 · SSEC Shanghai.

Output format

• JSON (default): array of records, UTF-8, Korean preserved, dates as YYYY-MM-DD.
• CSV (--csv): Pandas-compatible; date is the first column on time-series output.

Error handling

• Invalid ticker → exit code 2, {"error":"ticker_not_found","input":"…"} on stderr.
• Upstream error (network, schema drift) → exit code 3, {"error":"upstream_error",…} on stderr.
• Empty date range (weekend / holiday) → empty array, exit code 0.

Rate limits

Public endpoints — keep multi-ticker jobs to ~1 req/sec and back off on 403.

See also

• opendart-cli — DART filings & financial statements
• toss-payments-cli — Toss Payments API
• naver-papago-translate — translate Korean disclosures

License

MIT. No warranty on data accuracy — always verify against the official KRX disclosure before trading.