AI导哈

企业金融数据API工具

通过MCP工具提供韩国企业公告、财务报表和股权披露数据的API访问服务，支持LLM直接查询金融信息。

  • by RealYoungk
  • Dart
  • 本地部署
  • 更新于
在 GitHub 查看 RealYoungk/opendart_mcp

使用说明

opendart_mcp

提供OpenDART API作为MCP工具的服务器

LLM（Claude、GPT等）可以直接访问韩国企业的公示信息、财务报表、股权公示数据。

特性

83个 完全支持OpenDART API作为MCP工具。

组数工具说明 |------|:-------:|------| | DS001公告信息| 4 |公告搜索、企业概况、公告文件源、唯一编号| | DS002定期报告主要信息| 28 |增资/减持、分红、股东、高管、薪酬、审计、债务证券等 DS003财务信息7财务报表、主要账户、XBRL、财务指标 | DS004股份公告| 2大量持股情况报告，高管和主要股东持股报告 | DS005关键事项报告| 36 |增资/减持、并购、诉讼、发行公司债券、本公司股票等 DS006证券申报表6|股权证券、债务证券、合并、分割等

快速开始

1.发放API密钥

OpenDART请在注册会员后获得认证密钥。

  • 登录OpenDART后 颁发认证密钥 在页面上申请
  • 发放后立即可用（无需管理员批准）

2.安装

dart pub global activate opendart_mcp

安装后 opendart_mcp 可以使用命令。

3.MCP客户端设置

克劳德桌面版

claude_desktop_config.json 文件位置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %APPDATA%\Claude\claude_desktop_config.json

请添加以下设置：

{
  "mcpServers": {
    "opendart": {
      "command": "opendart_mcp",
      "env": {
        "OPENDART_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

重新启动Claude Desktop时，opendart服务器将连接。

克劳德代码

claude mcp add opendart -e OPENDART_API_KEY=여기에_API_키_입력 -- opendart_mcp

光标

设置>从MCP Server添加。 .cursor/mcp.json 直接编辑文件：

{
  "mcpServers": {
    "opendart": {
      "command": "opendart_mcp",
      "env": {
        "OPENDART_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

帆板运动

~/.codeium/windsurf/mcp_config.json 将以下设置添加到文件：

{
  "mcpServers": {
    "opendart": {
      "command": "opendart_mcp",
      "env": {
        "OPENDART_API_KEY": "여기에_API_키_입력"
      }
    }
  }
}

其他MCP客户端

可用于支持stdio transport的所有MCP客户端。

命令： opendart_mcp 环境变量： OPENDART_API_KEY

使用示例

连接到MCP客户端后，您可以问：

公示搜索

  • “请搜索三星电子最近的公告”
  • “帮我找找2024年1月提交的NAVER的事业报告”

财务信息

  • “请出示SK海力士2024年事业报告财务报表”
  • “请比较三星电子和SK海力士的主要财务指标”
  • “告诉我Kakao 2023年损益表的主要账户科目”

股东和股份信息

  • “NAVER的大量股东现状是？”
  • “展示三星电子最大股东变动情况”

关于定期报告

  • “告诉我三星电子2024年分红情况”
  • “让我看看LG能源解决方案的高管现状”
  • “Kakao的股票取得及处理情况如何？”

关键报告

  • “帮我查一下NAVER最近有偿增资的决定明细”
  • “让我看看三星生物制剂提起诉讼的情况”

API覆盖范围

전체 83개 API 상세 목록 보기

DS001-公告信息（4个）

|#API描述支持 |---|-----|------|:----:| |1|公示搜索按公示类型、公司、日期搜索公示报告 提供在DART上注册的企业概况信息 |3|公示文件源文件下载公示报告源文件 |4|唯一编号|查询公告对象公司的唯一编号、公司名称、项目代码

DS002-定期报告关键信息（28个）

|#API描述支持 |---|-----|------|:----:| |1|增资（减持）现状|资本金变动信息 关于分红的事项分红相关信息 |3|自己的股票取得和处置情况|公司股票交易情况| |4|最大股东情况|主要股东信息| |5|最大股东变动情况|股东构成变化 |6|小额股东现状|小股东信息 |7|管理人员现状|员工构成| |8|员工现状|员工规模信息 |9|董事、监事的个人报酬情况| 5亿韩元以上个人报酬| |10|董事、监事整体薪酬现状（薪酬支付金额）|董事、监事整体薪酬支付金额| 11|个人报酬支付金额（5亿以上前5名）前5名报酬详情 [12]其他法人出资情况投资情况 |13|股票总数现况发行股票信息 -14债务证券发行业绩债务证券发行明细 -15企业票据证券未偿还余额企业票据余额 |16|短期公司债未偿还余额短期公司债余额 17|公司债未偿还余额公司债余额 18新型资本证券未偿还余额新型资本证券余额 -19有条件资本证券未偿还余额有条件资本证券余额 |20|审计人员的名称和审计意见审计意见 |21|审计劳务签订情况|审计合同情况| |22|与审计人员签订非审计劳务合同情况|非审计劳务合同| 23|外部董事及其变动情况|外部董事现状| 24|未登记高管薪酬现状|未登记高管薪酬现状| |25|董事、监事整体报酬情况（股东大会批准金额）|股东大会批准报酬| 26|董事、监事整体薪酬情况（薪酬支付金额-类型）按类型薪酬 [27]公开募集资金的使用明细公开募集资金使用 |28|私募资金的使用明细|私募资金的使用

DS003-定期报告财务信息（7个）

|#API描述支持 |---|-----|------|:----:| |1|单一公司主要账户XBRL财务报表的主要账户科目（财务状态表，损益表） |2|多公司主要账号|多个对象法人主要账号比较查询 | 3 |财务报表源文件（XBRL）| XBRL格式财务报表源文件| |4|单一公司整体财务报表XBRL财务报表中的所有账户科目| |5XBRL TAXOMI财务报表格式基于IFRS的标准账户科目体系| 6|单一公司主要财务指标主要财务指标信息 7|多公司主要财务指标多目标法人主要财务指标

DS004-股份公告综合信息（2个）

|#API描述支持 |---|-----|------|:----:| |1|大量持有情况报告股票等大量持有（5%+）情况报告 |2|高管、主要股东持股报告高管、主要股东特定证券等持股情况|

DS005-关键问题报告关键信息（36个）

|#API描述支持 |---|-----|------|:----:| |1|资产转让（其他），Footback选项资产转让和Footback选项信息 |2|破产发生主要信息 |3|停业主要信息 |4|回生程序启动申请回生程序启动申请信息 |5|发生解散事由|解散事由发生信息| |6|有偿增资决定|有偿增资决定信息 |7|无偿增资决定|无偿增资决定信息 |8|有偿增资决定|有偿增资决定信息| |9|土豆结晶|土豆结晶信息 启动债权银行等的管理程序债权银行管理程序启动信息 |11|诉讼等的提起诉讼信息 [12]海外证券市场股票等上市决定海外市场上市决定 |13|海外证券市场主权等退市决定|海外市场退市决定 14|海外证券市场股票等上市海外市场上市 |15|海外证券市场股票等退市海外市场退市 |16|可转换公司债券发行决定|可转换公司债券发行决定信息 |17|决定发行新股认购权附属债券决定发行新股认购权附属债券 |18|兑换公司债券发行决定|兑换公司债券发行决定 |19债权银行等的管理程序中断债权银行管理程序中断信息 |20|决定发行相角型有条件资本证券决定发行有条件资本证券 |21|决定购买自己的股票|决定购买本公司股票信息 |22|决定处置自己的股票|公司股票处置决定信息 |23|决定签订自己的股份取得信托合同|决定签订本公司股票信托| |24|决定解除自己的股份取得信托合同|决定解除本公司股票信托| |25|营业受让决定|营业受让决定信息 26|营业转让决定营业转让决定信息 |27|有形资产受让决定|有形资产受让决定| |28|有形资产转让决策|有形资产转让决策| 29|其他法人股份及出资证券受让决定 |30|其他法人股份及出资证券转让决定|其他法人股份转让决定| |31|股权相关公司债权受让决定|股权相关公司债受让决定| |32|决定转让股权相关公司的债券决定转让股权相关公司的债券决定 33|公司合并决策公司合并决策信息 公司分割决策公司分割决策信息 公司分拆合并决策公司分拆合并决策信息 36|换股·搬迁决定股份交换·搬迁决定信息

DS006-证券申报表主要信息（6个）

|#API描述支持 |---|-----|------|:----:| |1|股权证券证券申报表（股权证券）摘要信息 |2|债务证券证券申报表（债务证券）摘要信息 |3|证券存托证券证券申报表（证券存托证券）摘要信息 合并证券申报表（合并）摘要信息 |5|股票的全面兑换、转让证券申报单（股票的全面兑换、转让）摘要信息 |6|分割证券申报单（分割）摘要信息

发展

设置项目开发环境：

# 의존성 설치
dart pub get

# 개발 모드 실행
OPENDART_API_KEY=your_key dart run bin/opendart_mcp.dart

# 테스트 실행
dart test

# 정적 분석
dart analyze

# 컴파일 (단일 실행파일)
dart compile exe bin/opendart_mcp.dart -o bin/opendart_mcp

许可证

CC BY-ND 4.0——见 许可证 了解详情。

相关 MCP