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 分