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

io.github.juh5ng由 GitHub 账号 juh5ng 发布v0.3.0更新于 Oct 24, 2026

Korean equity research, analyst revisions, kimchi premium and news via x402.

已验证Streamable HTTP可网页运行网页搜索与抓取金融

概览

AI 生成的概览

韩国市场数据 MCP 服务器：按次付费获取 KRX 卖方研报、泡菜溢价、Upbit 韩元行情与翻译后的新闻标题。

可以做什么
免费预览研报与泡菜溢价的覆盖范围和存档深度，并列出付费目录、价格与剩余预算。获取韩国券商研报：最新研报、单只股票研报，以及含目标价与评级调整记录的分析师共识。获取官方汇率与 USDT 两种基准的泡菜溢价，以及百分位统计和时间序列历史。读取 Upbit 韩元市场快照与单币报价，以及美元兑韩元汇率。获取韩联社、每日经济与韩国经济的新闻标题（可附英文翻译），以及一次调用完成的韩国市场简报。
适用场景
适合需要韩国股票研报事实、分析师共识与调整、泡菜溢价背景，或英文版韩国市场与新闻数据的场景。建议先用免费预览判断存档覆盖度，再决定是否付费调用。
运行要求
以远程托管端点运行，或通过 npx k-data-mcp 在本地运行（需 Node.js）。付费工具需要 K_DATA_PRIVATE_KEY，即持有 Base 链上 USDC 的专用钱包私钥，可选 K_DATA_MAX_SPEND_USD（默认 1）。K_DATA_BASE_URL 可指向其他部署。免费预览工具无需钱包。需要网络访问。
安装前请注意
付费工具每次调用都会花费真实 USDC，从 0.005 到 0.12 美元不等，历史数据每翻一页都是一次单独付费请求。钱包私钥通过 K_DATA_PRIVATE_KEY 提供并保存在配置文件中，应使用专用钱包而非主钱包。请设置 K_DATA_MAX_SPEND_USD 作为硬性上限。研报内容为摘要事实并附发布方链接，而非研报 PDF 原文。

安装

在 SourceWeft 中

  1. 打开 控制台中的 K-Data — Korean Sell-Side Research & Market Data，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.juh5ng%2Fkorea-stock-research-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "k-data-korean-sell-side-research-market": {
      "type": "http",
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp"
    }
  }
}

README

k-data-mcp

MCP server for Korean equity research and market data, metered per call in USDC over x402. Start it without a wallet to inspect the catalog and run free, date-stamped previews; add a dedicated wallet only when you want paid calls.

Try before funding a wallet

Run npx k-data-mcp with no environment variables to use these free tools:

  • list_endpoints — paid catalog and prices.
  • preview_research_coverage — real per-ticker report/brokerage counts and archive date ranges.
  • preview_research — a single ticker's actual archive depth; this does not disclose report content.
  • preview_kimchi_premium — live BTC-only dual-basis sample.

Set K_DATA_PRIVATE_KEY and K_DATA_MAX_SPEND_USD only when you are ready to enable paid tools.

What you get

  • Kimchi premium on a tradeable basis. Everyone quotes the premium against the official USD/KRW rate, but Korean capital controls mean the KRW exit leg actually goes through USDT — so that number is not something you can trade on. This returns both, and they routinely disagree in sign: official can read −0.27% while the realizable basis is +0.19%.
  • Premium history and percentile context. A continuously recorded archive answers "is this premium unusual right now?" — percentile, mean, stdev, z-score over 1h–90d. No free source publishes this, and it cannot be reconstructed after the fact.
  • Korean headlines translated to English, from Yonhap, Maeil Business and Hankyung. Korean myriad units (억 / 조) are expanded deterministically before translation, so "989억달러" comes back as $98.9 billion rather than the 10×-off answer language models produce unaided.
  • Korean sell-side research as structured data. Target prices, ratings, brokerage and analyst per KRX ticker, each with an English summary, plus the consensus and revision history built from them — who raised, who cut, and how far apart the houses actually are. Only the facts of each report are sold, in our own words, with a link back to the publisher; the report PDF stays with the brokerage that wrote it. The listing source shows a rolling recent window only, so this series cannot be reconstructed after the fact either.
  • Upbit KRW quotes and market summaries, USD/KRW.

Install

bash
npx k-data-mcp

Claude Desktop / Claude Code

json
{  "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"      }    }  }}

Wallet setup

Each tool call spends real USDC, so the server will not start without a key and a budget.

  1. Create a dedicated wallet — not your main one. The key sits in a config file and every call spends from it.
  2. Fund it with the USDC you're willing to spend on Base. No ETH needed: x402 settles with an off-chain EIP-3009 signature and the facilitator pays the gas.
  3. Set K_DATA_MAX_SPEND_USD. The server refuses any call that would push cumulative spend past it.
VariableRequiredDefaultMeaning
K_DATA_PRIVATE_KEYyes—Private key of the paying wallet (USDC on Base)
K_DATA_MAX_SPEND_USDno1Hard cap on cumulative spend for the session
K_DATA_BASE_URLnohosted servicePoint at a different K-Data deployment

Tools

list_endpoints is free — call it first to see current prices and decide what's worth buying.

ToolPriceReturns
list_endpointsfreeCatalog, current prices, wallet address, remaining budget
kimchi_premium$0.03Dual-basis premium (official + USDT) for up to 10 coins
kimchi_premium_stats$0.12Percentile, mean, stdev, z-score of the premium over 1h–90d
kimchi_premium_history$0.08Premium time series, both bases
korea_market_snapshot$0.08One-call briefing: premium + markets + FX + translated headlines
research_consensus_ticker$0.12Analyst consensus for one KRX ticker — target price mean/median/range and spread, rating mix, and every house's revision history
research_company_ticker$0.05Archived Korean brokerage reports for one ticker, summarised in English
research_latest$0.02Latest Korean equity research across all covered companies
news_headlines_en$0.05Korean headlines with English translations
crypto_krw_markets$0.01All Upbit KRW markets — volume leaders, gainers, losers
news_headlines$0.01Korean headlines, untranslated
crypto_krw_ticker$0.005One Upbit KRW quote
fx_usdkrw$0.005USD/KRW rate

Prices are read from the provider's catalog at startup, so this table reflects whatever the service currently charges.

How payment works

Every paid endpoint answers an unpaid request with HTTP 402 and a PAYMENT-REQUIRED header describing the price, asset and recipient. This server signs an EIP-3009 authorization for that exact amount and retries; the facilitator settles it on Base. Nothing is held on account — you pay per call, and stop paying when you stop calling.

License

MIT

来源：README.md，提交 091c376

工具

16

preview_premium_coverage

Free archive coverage and freshness for each recorded coin. Check sample count, first and latest timestamps, and stale flag before buying premium statistics or history.

无需输入参数。

preview_research_coverage

Free, date-stamped KRX research coverage. Lists the most-covered tickers with report count, brokerage count, and archive date range; it does not reveal report content.

输入参数limit

preview_research

Free, date-stamped archive-depth check for one 6-digit KRX ticker. Shows report and brokerage counts, not report content or consensus.

输入参数ticker必填

preview_kimchi_premium

Free live BTC-only sample of the dual-basis kimchi premium. Use the paid endpoint for up to 10 symbols.

无需输入参数。

kimchi_premium

Kimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — a gross spot-price comparison using KRW/USDT conversion, before spreads, fees, liquidity and transfer constraints). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10). Costs $0.03 in USDC per call, settled via x402.

输入参数symbols

kimchi_premium_stats

Where the current kimchi premium sits inside its own recent distribution: percentile, mean, stdev, z-score, min/max/median, and a plain-language read. Answers 'is this premium unusual right now?' in one call. Built from the recorded archive; inspect actual dates and freshness with the free coverage endpoint. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official. Costs $0.12 in USDC per call, settled via x402.

输入参数basissymbolwindow

kimchi_premium_history

Time series of the kimchi premium from the recorded archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000) &before=<next_before>. Each page is a separate paid request. Continue while has_more is true using next_before. Inspect actual archive depth and freshness through /api/preview/premium-coverage before buying. Costs $0.08 in USDC per call, settled via x402.

输入参数beforepointssymbolwindow

research_consensus_ticker

Analyst consensus for one KRX ticker, built from the archived research history: mean/median/min/max target price across brokerages, the spread between them, the rating distribution, and a revision log of every target-price and rating change each house has made. Consensus uses each house's latest view, so a weekly publisher does not outvote a quarterly one. Params: ?window=30d|90d|180d|365d (default 90d). Costs $0.12 in USDC per call, settled via x402.

输入参数ticker必填window

research_company_ticker

Every archived Korean brokerage report for one KRX ticker, newest first: target price, rating, brokerage, analyst, the Korean title with its English translation, and a one-line English summary. Params: ?limit=20 (max 50). Costs $0.05 in USDC per call, settled via x402.

输入参数limitticker必填

research_latest

Latest Korean brokerage equity research across all covered companies, newest first — company and KRX ticker, target price, rating, brokerage, analyst, and a one-line English summary of each report. Facts and summaries only; the report PDF stays with its publisher and source_url links back to it. Optional ?limit=20 (max 50). Costs $0.02 in USDC per call, settled via x402.

输入参数limit

news_headlines_en

Latest Korean headlines with English translations attached (title_en), from Yonhap, Maeil Business and Hankyung — deduplicated, newest first. Use this instead of the Korean-only route when the consuming agent does not read Korean. Optional ?category=top|economy|tech|politics and ?limit=20 (max 50). Costs $0.05 in USDC per call, settled via x402.

输入参数limitcategory

korea_market_snapshot

One-call Korea briefing: dual-basis kimchi premium + top Upbit KRW markets + USD/KRW + latest economy headlines translated to English. Everything needed for a Korea market read in a single paid request. Costs $0.08 in USDC per call, settled via x402.

无需输入参数。

crypto_krw_markets

Snapshot of all Upbit KRW crypto markets: top by 24h traded value, top gainers, top losers. Optional ?limit=30 (max 100) for the volume ranking. Costs $0.01 in USDC per call, settled via x402.

输入参数limit

news_headlines

Latest Korean headlines from Yonhap, Maeil Business and Hankyung, deduplicated and newest-first. Titles stay in Korean — use /api/news/headlines/en for English. Optional ?category=top|economy|tech|politics and ?limit=30 (max 100). Costs $0.01 in USDC per call, settled via x402.

输入参数limitcategory

crypto_krw_ticker

Live quote for one Upbit KRW market by ticker symbol (e.g. BTC, ETH, XRP): price, 24h change, 24h high/low, 24h traded value in KRW. Costs $0.005 in USDC per call, settled via x402.

输入参数ticker必填

fx_usdkrw

Current USD/KRW exchange rate (ECB reference via Frankfurter, fallback open.er-api.com). Costs $0.005 in USDC per call, settled via x402.

无需输入参数。

版本历史

1
  1. v0.3.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分