Korea Finance Factcheck

korea-finance-factcheck

韓国の金融記事に書かれた数字を公式の原資料と照合するMCP サーバーです。記事を書く人がClaudeに「この記事の数字が正しいか確認して」と頼むと、サーバーがDARTの開示情報や韓国銀行ECOS、米国財務省の資料を直接取得し、間違いを指摘します。

作成した理由

私は、開示情報の解説や市場ブリーフィングを掲載するサイトmacromalt.comを運営しています。AIと一緒に記事を書いているうちに、数字が間違ったまま公開されることが何度かありました。文章は滑らかなのに数字だけが間違っていて、読む人も書いた人も気づきませんでした。実際に起きたことは次のとおりです。

• 4月に書いた記事で、ウリ金融持株と東洋生命の株式交換比率を逆に記載しました。開示情報には「東洋生命1株に対してウリ金融0.2521056株」とありますが、記事には「ウリ金融1株に対して東洋生命0.2521056株」と書きました。開示情報のウリ金融 : 東洋生命 = 1 : 0.2521056という表記を逆に読んだためです。
• 10月には、ウォン単位の金額に「百万ウォン」というラベルが付いて、売上高と営業利益が10倍、100倍に膨らみました。公開した記事8本にそのまま載っていました。
• 9月には、米国財務省の金利表を読む際に列がずれ、10年債の欄に7年債の金利を記載しました。

いずれもモデルは受け取ったとおりに書きました。そこで記事を書いた後に、機械が原資料と照合するようにし、その検査部分を切り出してこのリポジトリにまとめました。

できること

check_ratio_directionは、合併・株式交換比率に関する文章を確認します。本文の「X1株に対してY n株」という記述を開示情報の原文と比較し、株式を出す会社と受け取る会社が逆になっている記述を指摘します。本文に受付番号があればDARTから開示情報を取得し、なければ本文中に転記された開示情報の表記と比較します。

check_unit_errorsは、「サムスン電子（005930）」のように銘柄コードとともに記載された売上高、営業利益、純利益をDARTの事業報告書と照合します。10倍、100倍、1,000倍のずれだけを検出します。証券会社の予想値など、元の開示情報とは異なる数字まで検出すると警告が多くなりすぎるため、意図的に対象を絞っています。

check_market_numbersは、米国債の2・5・10・30年債利回りを米国財務省の資料と、KOSPI終値、韓国の政策金利、ウォン・ドル為替レートを韓国銀行ECOSと比較します。記事の末尾に**작성**: 2026-10-30のような行があれば、その日を基準に確認します。為替レートは、記事でよく使われる週間終値とECOSの売買基準率がもともと異なる数字なので、15ウォンを超える差がある場合にだけ知らせます。

check_stock_closesは、「サムスン電子（005930）」のように銘柄コードが記載された銘柄の終値を韓国取引所（KRX）の公式終値と照合します。同じ文に「終値」または「取引終了」があり、ウォン単位で記載された数字だけを確認します。目標株価などの数字まで終値として読み取らないようにするためです。騰落率は確認しません。「9月30日以降18.8％下落」のような期間収益率を1日の騰落率として誤って読み取ったことがあるためです。数字の前に日付がなければ、直近の取引日のいずれか1日と一致すれば合格とします。

check_allは、これらの検査をまとめて実行します。どれか1つが失敗しても、残りの結果はそのまま返します。

検査できなかった場合も、何も言わずに処理を続けることはありません。キーがない場合や照会に失敗した場合は、理由をskippedに記載します。

インストール

uvがあれば、インストールせずにすぐ実行できます。Claude Codeでは次のように登録します。

claude mcp add korea-finance-factcheck \
  -e DART_API_KEY=발급받은_키 -e ECOS_API_KEY=발급받은_키 -e KRX_API_KEY=발급받은_키 \
  -- uvx korea-finance-factcheck

Claude Desktopでは、設定ファイル（claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "korea-finance-factcheck": {
      "command": "uvx",
      "args": ["korea-finance-factcheck"],
      "env": { "DART_API_KEY": "발급받은_키", "ECOS_API_KEY": "발급받은_키", "KRX_API_KEY": "발급받은_키" }
    }
  }
}

キーの取得

キーは自分で取得して設定します。3機関の規約上、認証キーを他人と共有することはできないため、このサーバーでは誰かのキーを預かることはありません。

DARTキーはOpenDARTで会員登録後、認証キー申請メニューから取得します。比率検査と単位検査に使用します。

ECOSキーは韓国銀行ECOSから取得します。申請時に利用形態を選ぶ必要があるので、用途に合ったものを選んでください。KOSPI、政策金利、為替レートの検査に使用します。米国債利回りはキーなしで確認できます。

KRXキーはKRX Open APIから取得し、有価証券・KOSDAQの日次取引情報の利用申請も済ませておく必要があります。終値検査に使用します。KRX Open APIの規約では非商用目的に限って利用できるため、有料サービスにこの検査を組み込んではいけません。結果を転載する場合は、「KRX統計情報」と明記してください。

使用例

記事を貼り付けて、Claudeに次のように伝えます。

この原稿の数字をkorea-finance-factcheckで確認してください。

ウリ金融に関する文を入力すると、次のような結果が返ります。

{
  "ratio_direction": {
    "errors": [{"claim": "우리금융 1주당 동양생명 0.2521056주",
                "filing": "동양… 1주당 우리… 0.2521056주"}]
  }
}

対応しないこと

このサーバーは、数字が原資料と一致しているかどうかだけを確認します。銘柄の売買を勧めたり、株価の見通しを示したりすることはありません。結果を投資判断の根拠にしないでください。

開示情報や公式統計にない数字は判定できません。証券会社の推定値、取引時間中の相場、記事にしか載っていない数字などが該当します。こうした数字はunverifiedとして返すため、人が確認してください。

NAVERのデータは含めていません。規約上、利用できる範囲が限られているためです。

出典

このサーバーが取得する資料の著作権は各機関に帰属します。開示情報は金融監督院の電子開示システム（DART）、国内指標は韓国銀行経済統計システム（ECOS）、米国債利回りは米国財務省（U.S. Department of the Treasury）、銘柄の終値は韓国取引所（KRX統計情報）の資料です。結果を記事に転載する際は、出典も記載してください。

開発

uv venv && uv pip install -e ".[test]"
.venv/bin/python -m pytest

テストには、実際の開示情報の原文と、実際に間違っていた文章をそのまま含めています。手作業で作った数字だけを使うテストでは、実際のミスを検出できなかったためです。

English

韓国の金融記事の数字を公式ソースと照合するMCP サーバーです。DARTの開示情報（合併・株式交換比率の方向、売上高と利益の10倍・100倍の単位誤り）、韓国銀行ECOS（KOSPI終値、政策金利、KRW/USD）、米国財務省のパーイールド、KRX公式終値を確認します（KRX Open APIの規約により非商用利用に限ります）。DART_API_KEY、ECOS_API_KEY、KRX_API_KEYはご自身で用意してください。不一致を報告しますが、投資アドバイスは行いません。

ライセンス

MIT