krx-cli

[](https://www.npmjs.com/package/krx-cli) [](https://www.npmjs.com/package/krx-cli) [](https://github.com/kyo504/krx-cli/blob/main/LICENSE)

AI 에이전트를 위한 KRX(한국거래소) Open API CLI & MCP 서버입니다.

Claude Code, GPT, Cursor 등의 AI 에이전트가 Bash tool 또는 MCP를 통해 한국 주식시장 데이터(KOSPI, KOSDAQ, ETF, 채권, 파생상품)를 조회할 수 있습니다.

• Agent-Native: JSON 출력 기본, 시맨틱 exit code, 스키마 인트로스펙션
• 전체 시장 커버리지: 지수, 주식, ETF/ETN/ELW, 채권, 파생상품, 일반상품, ESG (31개 엔드포인트)
• 종목 검색: 종목명으로 검색 후 코드 조회 (krx stock search)
• 시장 요약: 한 번의 호출로 지수/상승·하락/Top movers 확인 (krx market summary)
• 워치리스트: 관심 종목 저장 및 일괄 시세 조회 (krx watchlist)
• 기간 조회: --from/--to로 여러 날짜 데이터 병렬 조회
• 데이터 파이프라인: --sort, --limit, --code 로 서버 사이드 필터링
• 파일 캐싱: 과거 데이터 자동 캐싱으로 rate limit 절약
• 안전한 사용: 입력 검증, rate limit 추적, dry-run 지원
• 서비스 승인 관리: API별 승인 상태 자동 확인

npm install -g krx-cli
# 또는
pnpm add -g krx-cli
# 또는
yarn global add krx-cli

KRX Open API 포털에서 회원가입 후 API 키를 발급받습니다.

krx auth set <your-api-key>

# 또는 환경변수 사용
export KRX_API_KEY=<your-api-key>

KRX Open API는 카테고리별로 별도 승인이 필요합니다.

krx auth status

{
  "api_key_set": true,
  "services": {
    "index": { "approved": true },
    "stock": { "approved": true },
    "etp": { "approved": true },
    "bond": { "approved": true },
    "derivative": { "approved": true },
    "commodity": { "approved": true },
    "esg": { "approved": false, "error": "Unauthorized API Call" }
  }
}

krx index list --date 20260310 --market kospi
krx index list --date 20260310 --market kosdaq

krx stock list --date 20260310 --market kospi
krx stock list --date 20260310 --market kosdaq
krx stock info --marke