kr-dart-events について
kr-dart-eventsは、AIエージェントや金融データ利用者向けに、韓国企業の開示イベントと政府調達データを構造化して提供します。開示を分類し英語ラベルを付け、x402によるUSDCの従量払いに対応し、APIキーは不要です。
主な機能
- 01カーソル差分対応のDART開示イベント
- 0231種類の開示分類と重要度スコア
- 03企業タイムラインと開示文書
- 04KONEPSの入札・落札・発注計画
- 05キーワード検索と企業情報照合
- 06x402によるUSDC従量払い
活用シーン
- 01韓国企業の重要開示を監視
- 02特定企業の開示履歴を追跡
- 03政府入札や落札結果を検索
- 04企業情報に合う入札公告を照合
MCP 対応
付属のMCPサーバーはAPIをラップし、重要開示、全開示、企業タイムライン、開示詳細のツールを提供します。利用にはウォレットを設定し、x402で支払う必要があります。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
docker run -i --rm -e X402_PRIVATE_KEY ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4X402_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4stdioツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
KR-DART Events — AI エージェント向け韓国企業開示情報
リアルタイムの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、支配権の変更、上場廃止リスク、M&A…) |
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..." }
}
}
}
一般的なエージェントのループ
韓国標準時の取引時間中は、60秒ごとに/v1/events/material?since_cursor=<last>をポーリングします。新しい届出は DART での公開から約15秒以内に表示されます。費用は1日あたり約2ドルです。
注意事項
- データソース:DART オープンデータ(出典を明記)。データのみであり、投資助言ではありません。
- イベントインデックスは2026-07-20から始まります。それ以前の届出はインデックス化されていません。
server/には、販売側の実装全体(FastAPI と独自実装の x402 ミドルウェア、JWT 認証を使用する CDP ファシリテーター)が含まれています。独自の x402 販売側を構築する際の参考にしてください。
ライセンス
MIT — LICENSEをご覧ください。運営:LJay AI Media Group · [email protected]
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。