How do I install the Krx Stock CLI skill?

Run npx skillmds@latest add knownasnaffy/krx-stock-cli-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Krx Stock CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Krx Stock CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Krx Stock CLI free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Krx Stock CLI?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Krx Stock CLI by knownasnaffy — Agent Skill

Name: Krx Stock CLI
Rating: 4.5 (4 reviews)
Author: knownasnaffy

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), and ticker↔name lookups for KOSPI/KOSDAQ/KONEX/ETF tickers. Use when a user asks for Korean stock prices, ticker resolution, or KRX market data in JSON or CSV. No API key required.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

KRX Stock CLI

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.

License

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

---name: krx-stock-cli-3description: Korean Exchange (KRX) stock market data CLI. Fetch daily OHLCV, latest-close snapshots, market-cap rankings, index histories (KOSPI/KOSDAQ/KOSPI200/KRX100), and ticker↔name lookups for KOSPI/KOSDAQ/KONEX/ETF tickers. Use when a user asks for Korean stock prices, ticker resolution, or KRX market data in JSON or CSV. No API key required.license: MIT---# KRX Stock CLIZero-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`](https://github.com/FinanceData/FinanceDataReader), which aggregates KRX, Naver Finance, and related public sources. No API key required.## When to useTrigger 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```bashpip install -r scripts/requirements.txt```Dependencies: `finance-datareader`, `pandas`.## UsageAll 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```bashpython scripts/krx.py ticker 005930 # → 삼성전자python scripts/krx.py ticker "SK하이닉스" # → 000660python scripts/krx.py search 카카오 --top 5 # substring search```### OHLCV```bashpython scripts/krx.py ohlcv 005930 --days 30python scripts/krx.py ohlcv 005930 --start 20260101 --end 20260420 --csv```### Latest-close snapshot```bashpython scripts/krx.py snapshot 005930```### Market-cap ranking```bashpython scripts/krx.py marketcap --market KRX --top 50python scripts/krx.py marketcap --market KOSDAQ --top 20 --csv````--market` accepts `KRX`, `KOSPI`, `KOSDAQ`, `KONEX`, `ETF/KR`.### List all tickers in a market```bashpython scripts/krx.py list --market KOSPI --top 100```### Index```bashpython scripts/krx.py index KS11 --days 90 # KOSPIpython scripts/krx.py index KS200 --days 30 # KOSPI 200python scripts/krx.py index IXIC --days 30 # NASDAQ Compositepython 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 limitsPublic 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## LicenseMIT. No warranty on data accuracy — always verify against the official KRX disclosure before trading.

Frequently asked questions