K-Data — Korean Sell-Side Research & Market Data

k-data-mcp

用于韩国股票研究和市场数据的 MCP 服务，通过 x402 按调用次数以 USDC 计费。无需钱包即可启动服务，查看目录并运行免费的带日期预览；只有在需要付费调用时，才添加专用钱包。

先试用，再为钱包充值

运行 npx k-data-mcp，无需设置环境变量即可使用以下免费工具：

• list_endpoints — 付费目录和价格。
• preview_research_coverage — 每只股票的实际报告／券商数量和存档日期范围。
• preview_research — 单只股票的实际存档深度；不会公开报告内容。
• preview_kimchi_premium — 实时、仅限 BTC 的双基准样本。

只有在准备启用付费工具时，才设置 K_DATA_PRIVATE_KEY 和 K_DATA_MAX_SPEND_USD。

你将获得

• 基于可交易价格的泡菜溢价。 所有人都以官方 USD/KRW 汇率报价溢价，但由于韩国的资本管制，KRW 平仓端实际会经由 USDT 交易，因此该数值无法用于交易。本服务同时返回这两种溢价，而且两者的符号经常相反：官方溢价可能为 −0.27%，而可实现的溢价为 +0.19%。
• 溢价历史和百分位背景。 持续记录的存档可回答“当前溢价是否异常？”——提供 1h–90d 的百分位、均值、标准差和 z 分数。没有免费的数据源会发布这些信息，而且事后无法还原。
• 翻译成英文的韩国新闻标题，来源包括韩联社、Maeil Business 和 Hankyung。翻译前会确定性地展开韩国的大数单位（억 / 조），因此“989억달러”会译为 $98.9 billion，而不是大模型在没有辅助时给出的差 10 倍的答案。
• 结构化的韩国卖方研究数据。 每个 KRX 股票代码的目标价、评级、券商和分析师信息，以及英文摘要，还有由这些数据构建的共识和评级调整历史——哪些机构上调了评级、哪些下调了，以及各机构的观点实际相差多大。仅出售每份报告中的事实，并以我们自己的措辞呈现，同时附上指向发布方的链接；报告 PDF 仍由撰写它的券商保管。列表数据源只提供近期滚动窗口，因此这组数据事后同样无法还原。
• Upbit KRW 报价和市场摘要、USD/KRW。

安装

npx k-data-mcp

Claude Desktop / Claude Code

{
  "mcpServers": {
    "k-data": {
      "command": "npx",
      "args": ["-y", "k-data-mcp"],
      "env": {
        "K_DATA_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "K_DATA_MAX_SPEND_USD": "1"
      }
    }
  }
}

钱包设置

每次工具调用都会消耗真实的 USDC，因此未设置密钥和预算时，服务不会启动。

1. 创建一个专用钱包，不要使用主钱包。密钥会存储在配置文件中，每次调用都会从该钱包扣款。
2. 为钱包充值你愿意在 Base 上花费的 USDC。无需 ETH：x402 使用链下 EIP-3009 签名完成结算，手续费由支付服务方承担。
3. 设置 K_DATA_MAX_SPEND_USD。如果某次调用会导致累计花费超过此上限，服务将拒绝该调用。

变量	必填	默认值	含义
K_DATA_PRIVATE_KEY	是	—	付款钱包的私钥（Base 上的 USDC）
K_DATA_MAX_SPEND_USD	否	1	本次会话累计花费的硬上限
K_DATA_BASE_URL	否	托管服务	指向不同的 K-Data 部署

工具

list_endpoints 免费——请先调用它，查看当前价格并决定哪些值得购买。

工具	价格	返回内容
list_endpoints	免费	目录、当前价格、钱包地址、剩余预算
kimchi_premium	$0.03	最多 10 种币的双基差溢价（官方 + USDT）
kimchi_premium_stats	$0.12	1h–90d 内溢价的百分位数、均值、标准差、z 分数
kimchi_premium_history	$0.08	溢价时间序列，含两种基差
korea_market_snapshot	$0.08	一次调用即可获取简报：溢价 + 市场 + 汇率 + 已翻译的头条
research_consensus_ticker	$0.12	一个 KRX 代码的分析师共识——目标价均值／中位数／区间及价差、评级分布，以及每家机构的修订历史
research_company_ticker	$0.05	一个代码的韩国券商存档报告，并以英文总结
research_latest	$0.02	覆盖的所有公司最新韩国股票研究报告
news_headlines_en	$0.05	附英文翻译的韩国头条
crypto_krw_markets	$0.01	所有 Upbit KRW 市场——成交量领先者、涨幅榜、跌幅榜
news_headlines	$0.01	未翻译的韩国头条
crypto_krw_ticker	$0.005	一个 Upbit KRW 报价
fx_usdkrw	$0.005	USD/KRW 汇率

价格在启动时从提供方的目录读取，因此此表反映的是服务当前收取的费用。

付款方式

每个付费端点都会以 HTTP 402 和 PAYMENT-REQUIRED 标头回应未付款请求，标头中说明价格、资产和收款方。此服务会为该笔确切金额签署 EIP-3009 授权并重试；由支付协调方在 Base 上完成结算。账户中不会预存资金——按调用付费，停止调用即停止付费。

许可证

MIT