首页 / 技能 / OpenDART

📦 OpenDART

v0.1.0

CLI韩国金融监督院DART OpenAPI终端查询与搜索工具，可输出企业信息及财务报表等为JSON。

0· 12·0 当前·0 累计
by @chloepark85 (Chloe Park)
API开发
下载技能包
最后更新
2026/4/20
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
安全
high confidence
该技能的代码、说明及所需环境变量均与非官方的 DART OpenAPI CLI 保持一致，仅需 DART API 密钥及可选的缓存目录。
评估建议
此技能如其名：一个非官方 OpenDART CLI，仅需你的 DART API key 并本地缓存。安装前请验证包来源（pyproject 与 SKILL.md 指向 GitHub 仓库 https://github.com/ChloePark85/opendart-cli），优先从可信 registry 或该 GitHub 安装，以防 typosquatting。务必将 OPENDART_API_KEY 保密，仅通过文档中的环境变量提供。工具会创建 ~/.opendart-cli（或 OPENDART_CACHE_DIR），并可能将下载的 ZIP 保存至你指定的路径；如有顾虑，请在隔离环境运行或先检视该 GitHub 仓库。...
详细分析 ▾
✓ 用途与能力
名称/描述与实现一致：已实现 corp-code、find-corp、list、company、finance、majorstock、elestock 和 document 命令。唯一必需的凭据是 OPENDART_API_KEY，符合所述用途。未请求无关服务或二进制文件。
✓ 指令范围
SKILL.md 中的指令直接映射到 CLI 行为。运行时指令仅指导代理通过 HTTPS 使用 DART API，管理本地缓存（默认 ~/.opendart-cli），并将下载的文档保存到用户指定的路径。未包含读取无关系统文件、使用其他环境密钥或向非 DART 端点发送数据的指令。
ℹ 安装机制
注册表未列出安装规范（仅提供说明），但软件包包含完整的 Python 源码和带安装说明的 pyproject（pipx / pip / GitHub）。这是个小不一致：SKILL.md 和 pyproject 指向 GitHub 仓库，而注册表元数据显示 source/homepage 为 unknown/none。提供的安装渠道（pipx/pip）和依赖（requests）对 CLI Python 包而言合理。
✓ 凭证需求
仅需 OPENDART_API_KEY（已声明为 primaryEnv）。可选的 OPENDART_CACHE_DIR 已支持并记录在文档中。代码仅访问这些环境变量，不会请求其他密钥或无关凭据。
✓ 持久化与权限
始终为 false，且该 skill 不会请求持久化的平台级权限。它在用户主目录下创建缓存目录，并将 corp_codes.json 及下载的 ZIP 文件写入用户指定的位置，与其功能一致。
安全有层次，运行前请审查代码。

运行时依赖

无特殊依赖

版本

latestv0.1.02026/4/20

初始版本：corp code cache、disclosure search、company overview、financials、major/exec shareholders、document download。

● 无害

安装命令

点击复制
官方npx clawhub@latest install opendart-cli
镜像加速npx clawhub@latest install opendart-cli --registry https://cn.longxiaskill.com

技能文档

金融监督院电子披露系统(DART)公开 OpenAPI 的轻量级 Python CLI。可在终端查询韩国上市/非上市公司的披露历史、企业概况、财务报表、大股东及高管持股，并以 JSON 输出。为便于接入 Agent 管道，默认标准输出(JSON)，提供韩语错误提示与缓存。

主要功能 (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)保存

安装

``bash pipx install opendart-cli # 推荐 # 或 uv tool install opendart-cli # 或 (Python 3.9+) pip install opendart-cli ` 开发模式： `bash 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

快速示例

`bash # 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
数据来源：ClawHub ↗ · 中文优化：龙虾技能库