kr-dart-events

Name: kr-dart-events
Author: LJaysk

本地服务

dartapi.ljaysk.com金融数据014 周前更新

代码仓库访问官网

关于 kr-dart-events

kr-dart-events 为 AI Agent 和金融数据用户提供结构化的韩国企业披露事件与政府采购数据。它对公告分类并提供英文标签，支持通过 x402 按次用 USDC 付款，无需 API 密钥。

主要功能

01支持游标增量的 DART 公告流
0231 类公告及重要性评分
03公司时间线与公告文件
04KONEPS 招标、中标和采购计划
05关键词搜索与公司资料匹配
06通过 x402 按次用 USDC 付款

适用场景

01监控重要的韩国企业公告
02跟踪特定公司的披露记录
03搜索政府招标和中标结果
04按公司资料匹配招标公告

MCP 相关

附带的 MCP 服务通过工具封装 API，提供重要公告、全部公告、公司时间线和公告详情。访问需配置钱包并通过 x402 付款。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ljaysk-kr-dart-events": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "X402_PRIVATE_KEY",
        "ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}

启动命令docker run -i --rm -e X402_PRIVATE_KEY ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4

需要配置的环境变量

X402_PRIVATE_KEY密钥EVM private key (0x...) of a wallet holding a few cents of USDC on Base. Used to sign x402 micro-payments. Gas is not needed.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocighcr.io/ljaysk/kr-dart-events-mcp:0.1.4stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

KR-DART Events — 面向 AI Agent 的韩国企业披露信息

实时获取 DART（韩国版 SEC EDGAR）的申报事件，采用机器可读的结构化格式。通过 x402 使用 USDC 按次付费 — 无需账户、API 密钥或订阅。

Base URL: https://dartapi.ljaysk.com          (machine docs: /llms.txt, /openapi.json)

韩国交易所每个交易日都会以韩语发布约 2,500 份企业申报文件。本服务每 15 秒轮询一次 DART，将每份申报归类到 31 个机器可读类别中，评估重要性（0–1 分），并提供带有英文标签和英文公司名称的结构化 JSON。

端点

端点	价格	可获取内容
`GET /v1/events`	$0.002	完整申报流，基于游标获取增量数据
`GET /v1/events/material`	$0.005	仅重要申报（供应合同、融资、CB/BW、控制权变更、退市风险、并购……）
`GET /v1/events/{rcept_no}`	$0.01	单份申报详情
`GET /v1/events/{rcept_no}/document`	$0.02	完整原文，解析为简洁纯文本（检索失败不收费）
`GET /v1/company/{code}/events`	$0.005	单家公司时间线（6 位股票代码）
`GET /v1/bids`	$0.005	KONEPS 政府采购招标公告（货物/服务/工程/境外），基于游标获取增量数据
`GET /v1/bids/search`	$0.005	按关键词、类型和最低预算（KRW）搜索招标
`GET /v1/bids/{bid_ntce_no}`	$0.01	招标公告完整详情（所有原始 KONEPS 字段）
`GET /v1/awards`	$0.005	中标结果 — 中标方及金额
`GET /v1/prespecs`	$0.01	早期信号：招标公告发布前的预规格公告
`GET /v1/orderplans`	$0.01	最早信号：机构的本财年采购计划
`GET /v1/match/{bizno}`	$0.05	个性化匹配 — 公司资料 + 可投标公告，并附评分
`GET /v1/company-awards/{bizno}`	$0.02	公司中标历史 — 竞争对手情报

免费：/v1/health、/、/llms.txt、/openapi.json。

付款：x402 exact 方案，使用 Base 或 Solana 上的 USDC（Solana 手续费由支付协调方代付 — 买方钱包无需持有 SOL）。

快速开始（查看 402 响应）

curl https://dartapi.ljaysk.com/v1/events/material
# -> HTTP 402 with payment requirements (accepts: base / solana)

Python 客户端（约 60 行代码完成支付和获取数据）

请参阅 client_example.py。为任意 EVM 钱包充值几美分的 Base 上的 USDC，然后：

X402_PRIVATE_KEY=0x... python client_example.py /v1/events/material

标准 x402 SDK（x402-fetch、x402-axios、x402 python）均可直接使用。

MCP 服务（通过 Claude / 任意 MCP 客户端使用）

mcp_server.py 将 API 封装为 MCP 工具（kr_dart_material_events、kr_dart_all_events、kr_dart_company_timeline、 kr_dart_filing_detail）。

{
  "mcpServers": {
    "kr-dart-events": {
      "command": "uv",
      "args": ["run", "--with", "mcp,eth-account", "python", "/path/to/mcp_server.py"],
      "env": { "X402_PRIVATE_KEY": "0x..." }
    }
  }
}

典型 Agent 工作循环

在韩国标准时间（KST）交易时段，每 60 秒轮询一次 /v1/events/material?since_cursor=<last>。DART 发布申报后约 15 秒内即可获取。费用约为每天 $2。

备注

来源：DART 开放数据（注明出处）。仅提供数据 — 不构成投资建议。
事件索引始于 2026-07-20；更早的申报尚未编入索引。
server/ 包含完整的服务端实现（FastAPI + 手工编写的 x402 中间件、带 JWT 身份验证的 CDP 支付协调方）— 可作为构建自有 x402 卖方服务的参考。