dart-fss-cli

Access 83 Korea DART API endpoints from the terminal.
Built for humans. Designed for AI agents.

curl
npx
npm
curl -fsSL https://raw.githubusercontent.com/kiyeonjeon21/dart-fss-cli/main/install.sh | bash
# No install needed npx dart-fss-cli lookup "삼성전자"
npm install -g dart-fss-cli

Features

83 Endpoints
Every DART API — filings, financials, equity, major events, securities
--fields
Filter response fields to save context window for AI agents
--dry-run
Validate parameters without consuming API quota
Schema Introspection
Agents self-discover endpoints and parameters at runtime
Structured Errors
All output is JSON — errors included. Machine-parseable by default
Korean Names
Type "삼성전자" or "네이버" directly. English names auto-resolved

Quick Example

terminal
$ dart-fss financial single-account --corp "삼성전자" --year 2025 --quarter annual \
    --fields "account_nm,thstrm_amount,fs_div"

{"list":[
  {"account_nm":"매출액","thstrm_amount":"333,605,938,000,000","fs_div":"CFS"},
  {"account_nm":"영업이익","thstrm_amount":"43,601,051,000,000","fs_div":"CFS"},
  ...
]}

$ dart-fss schema employee

{"endpoint":"employee","pattern":"periodic","parameters":[...]}

Demo

Built for Agentic AI

dart-fss-cli follows the agentic CLI philosophy — schema introspection, field masks, dry-run validation, and structured JSON errors so AI agents can discover and call APIs without prior knowledge.

Point Claude Code, Codex, or any AI agent at this CLI and ask a question in plain language. The agent reads --help, discovers the schema, and composes the right calls.