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 月，我在读取美国财政部利率表时看错了列，把 7 年期利率写成了 10 年期利率。

这三次都是模型照单全收。因此，我让机器在文章写完后重新对照原始资料检查，并把这项检查单独整理到了这个存储库中。

可以做什么

check_ratio_direction会检查合并、换股比例相关的句子，将正文中的“X 每 1 股换 Y n 股”与公示原文进行比较，并指出换出公司和换入公司写反的情况。如果正文中有受理编号，就会从 DART 调取公示；如果没有，就会与正文中转录的公示表述进行比较。

check_unit_errors会将附有股票代码的营收、营业利润和净利润（例如“三星电子（005930）”）与 DART 年度报告进行核对。它只识别相差 10 倍、100 倍或 1000 倍的数字。若连证券公司预测等与原始公示不同的数字也一并检查，会产生太多警告，因此特意缩小了检查范围。

check_market_numbers会将美国国债 2 年期、5 年期、10 年期和 30 年期利率与财政部资料进行比较，并将 KOSPI 收盘价、韩国基准利率和韩元兑美元汇率与韩国银行 ECOS 进行比较。如果文章末尾有类似 **작성**: 2026-10-30 的行，就以该日为基准。新闻报道中常用的每周收盘汇率与 ECOS 的基准汇率本来就不同，因此只有差异超过 15 韩元时才会提示。

check_stock_closes会将正文中出现股票代码的股票（例如“三星电子（005930）”）的收盘价与韩国交易所（KRX）的官方收盘价进行核对。它只检查同一句中出现“收盘价”或“收盘”字样的韩元金额。这样可以避免把目标价等数字误认成收盘价。它不检查涨跌幅。因为曾经把“截至 9 月 30 日下跌 18.8%”这样的期间收益率误读成单日涨跌幅。如果数字前没有日期，只要与最近一个交易日中的某一天吻合，就会通过检查。

check_all会一次性运行所有检查。即使其中一项失败，也会照常返回其余检查结果。

即使无法执行检查，也不会悄悄跳过。如果缺少密钥或查询失败，服务会在 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": "발급받은_키" }
    }
  }
}

获取密钥

请自行申请并填写密钥。根据这三家机构的条款，认证密钥不可与他人共用，因此本服务不会代为保管任何人的密钥。

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 收盘价、基准利率、韩元／美元汇率）、美国财政部平价收益率，以及 KRX 官方股票收盘价（根据 KRX Open API 条款，仅限非商业用途）。请自行提供 DART_API_KEY、ECOS_API_KEY 和 KRX_API_KEY。本服务会报告不一致之处，且不会提供投资建议。

许可证

MIT