mcpField
K
kr-dart-events

kr-dart-events

ローカル
dartapi.ljaysk.com金融データ014 週間前に更新

kr-dart-events について

kr-dart-eventsは、AIエージェントや金融データ利用者向けに、韓国企業の開示イベントと政府調達データを構造化して提供します。開示を分類し英語ラベルを付け、x402によるUSDCの従量払いに対応し、APIキーは不要です。

主な機能

  1. 01カーソル差分対応のDART開示イベント
  2. 0231種類の開示分類と重要度スコア
  3. 03企業タイムラインと開示文書
  4. 04KONEPSの入札・落札・発注計画
  5. 05キーワード検索と企業情報照合
  6. 06x402によるUSDC従量払い

活用シーン

  1. 01韓国企業の重要開示を監視
  2. 02特定企業の開示履歴を追跡
  3. 03政府入札や落札結果を検索
  4. 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.4

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

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.005KONEPS 政府調達の入札公告(物品/サービス/建設/海外)、カーソルによる差分
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]

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。