OpenDART CLI

一款轻量级 Python 命令行工具，用于在终端中调用金融监督院电子公示系统（DART）提供的公开 OpenAPI。支持以 JSON 格式返回韩国上市及非上市法人的公示记录、企业概况、财务报表、大股东及高管持股情况等信息。默认采用标准输出（JSON），便于集成至 Agent 管道；同时提供韩文错误消息与本地缓存功能。

主要功能（v0.1.0）

• corp-code: 下载、解析并缓存公司唯一编号 XML 文件（缓存路径：~/.opendart-cli/corp_codes.json）
• find-corp: 通过公司名称或股票代码检索 corp_code
• list: 公示信息检索（支持 bgn_de、end_de、pblntf_ty、corp_cls 等过滤参数）
• company: 查询企业概况
• finance: 查询主要会计科目（fnlttSinglAcnt）或完整财务报表（fnlttSinglAcntAll）
• majorstock: 查询大股东持股情况
• elestock: 查询高管持股情况
• document: 下载并保存公示文件原始 ZIP 包

安装

pipx install opendart-cli      # 推荐方式
# 或者
uv tool install opendart-cli
# 或者（需 Python 3.9+）
pip install opendart-cli

开发模式：

git clone https://github.com/ChloePark85/opendart-cli
cd opendart-cli
pipx install -e .

环境变量

• OPENDART_API_KEY（必需）：从 opendart.fss.or.kr 获取的 40 位认证密钥
• OPENDART_CACHE_DIR（可选）：缓存目录，默认为 ~/.opendart-cli

快速使用示例

# 1) 获取 API 密钥后设置环境变量
export OPENDART_API_KEY="your_40_char_key"

# 2) 下载并缓存全部公司唯一编号
opendart corp-code --refresh

# 3) 按公司名称搜索（如“三星电子” → 00126380）
opendart find-corp "삼성전자"

# 4) 查询最近 30 天的定期公示列表
opendart list --corp-code 00126380 --pblntf-ty A --bgn 20260320 --end 20260420

# 5) 查询企业概况
opendart company --corp-code 00126380

# 6) 查询单体公司主要会计科目（2025 财年《事业报告书》）
opendart finance --corp-code 00126380 --bsns-year 2025 --reprt-code 11011

# 7) 查询完整财务报表
opendart finance --corp-code 00126380 --bsns-year 2025 --reprt-code 11011 --all

# 8) 查询大股东 / 高管持股情况
opendart majorstock --corp-code 00126380
opendart elestock  --corp-code 00126380

# 9) 下载公示文件原始 ZIP 包
opendart document --rcept-no 20260320000123 --out ./disclosure.zip

报告代码参考（--reprt-code）

• 11011：事业报告书（年度）
• 11012：半年度报告书
• 11013：第一季度报告书
• 11014：第三季度报告书

公示类型代码（--pblntf-ty）

A：定期公示，B：重大事项报告，C：发行公示，D：持股公示，E：其他公示，F：外部审计相关，G：基金公示，H：资产证券化，I：交易所公示，J：公平交易委员会公示。

安全性

• 仅通过环境变量传入认证密钥，CLI 参数与日志中均不记录密钥。
• 所有响应均通过 HTTPS 传输；缓存文件仅以当前用户主目录权限保存。

许可证与数据来源

MIT 许可证。本工具直接转发金融监督院电子公示系统（DART）官方 OpenAPI 的响应数据；本项目为 DART 的非官方客户端。

链接

• GitHub: https://github.com/ChloePark85/opendart-cli
• OpenDART: https://opendart.fss.or.kr