data-stock

KRX Korean stock search·quotes

Search KRX (Korea Exchange) listed stocks, look up basic stock information, and daily quotes. Used as quote data that complements moai-coworker's DART (disclosures).

This skill is based on NomaDamas k-skill korean-stock-search (MIT), and upstream design reference is jjlabsio/korea-stock-mcp. KRX_API_KEYis managed only on the proxy server, so no user issuance is required.

When to use / When not to use

Usage: Stock search (name·code), basic stock information, daily closing price·trading volume·market capitalization, simple quote lookup based on official KRX data.

Do not use: Non-Korean stocks such as US·Japan·virtual assets, real-time executions·quotes·minute charts, financial statements·original disclosure texts (→ use DART MCP), investment advice·buy recommendations.

Inputs

q: Stock name/stock code search term (search endpoint)
market: KOSPI | KOSDAQ | KONEX
code: Stock code (usually 6 digits, e.g. 005930)
bas_dd: Base date YYYYMMDD (if absent, KST today. If a holiday, retry with the most recent business day)
limit: Number of search results (default 10, max 20)

Prerequisites

Required user-side secret None.

KSKILL_PROXY_BASE_URL (optional): when self-hosting
Operations side KRX_API_KEYis kept only in the proxy server environment

Endpoints

GET /v1/korean-stock/search?q={검색어}&bas_dd={YYYYMMDD}
GET /v1/korean-stock/base-info?market={KOSPI|KOSDAQ|KONEX}&code={코드}&bas_dd={YYYYMMDD}
GET /v1/korean-stock/trade-info?market={KOSPI|KOSDAQ|KONEX}&code={코드}&bas_dd={YYYYMMDD}

Examples

# 종목 검색
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/search' \
  --data-urlencode 'q=삼성전자' --data-urlencode 'bas_dd=20260408'

# 종목 기본정보
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/base-info' \
  --data-urlencode 'market=KOSPI' --data-urlencode 'code=005930' \
  --data-urlencode 'bas_dd=20260408'

# 일별 시세
curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/trade-info' \
  --data-urlencode 'market=KOSPI' --data-urlencode 'code=005930' \
  --data-urlencode 'bas_dd=20260408'

Response shape

Search:

{
  "items": [
    {
      "market": "KOSPI",
      "code": "005930",
      "standard_code": "KR7005930003",
      "name": "삼성전자",
      "english_name": "Samsung Electronics",
      "listed_at": "1975-06-11"
    }
  ]
}

Daily quotes:

{
  "item": {
    "market": "KOSPI",
    "code": "005930",
    "base_date": "20260408",
    "name": "삼성전자",
    "close_price": 84000,
    "change_price": 1000,
    "fluctuation_rate": 1.2,
    "open_price": 83000,
    "high_price": 84500,
    "low_price": 82800,
    "trading_volume": 12345678,
    "trading_value": 1030000000000,
    "market_cap": 500000000000000
  }
}

Response policy

If the stock name is ambiguous, first searchnarrow down the market/stock code with base-info/trade-info call.
If some market upstreams fail, upstream.degraded=true + failed_marketsand explain the partial outage together.
trade-infois a daily snapshot and do not describe it as real-time quotes·executions.
On a holiday or before market close, the relevant bas_ddmay have no data, so retry with the most recent business day.
Express numbers in human-readable units (won, shares, hundred million/trillion) while also preserving the original numbers.
At the end of the answer, briefly leave **"Based on official KRX data / Not investment advice"**.

Response compact rules

Stock name / market / stock code
Base date
Closing price / change rate / trading volume / market capitalization
Listing date / number of listed shares / par value only when needed
If there are multiple candidates, show only the top 3-5 and let the user choose

Failure modes

q/market/code/bas_dd format error → 400
On the proxy, KRX_API_KEY absent → 503
Some market upstreams fail → 200 + upstream.degraded=true + failed_markets
All market upstreams fail → 502
No stocks for the relevant base date·market → 404 not_found

Related skill chaining

before: moai-accountant:finance-investor-relations — When writing IR materials, official KRX quotes are needed
before: DART MCP (moai-coworker/.mcp.json) — Combine with disclosure·financial analysis
after: moai-accountant:finance-variance-analysis — Quote fluctuation analysis
after: moai-officer:doc-xlsx — Turn quote data into Excel
after: moai-coworker:collab-exec-summary — Market price summary in the executive 1-pager

Done when

If the search term is ambiguous, searchcandidates were narrowed down first using
If needed, base-info와 trade-infothe key figures were organized using
It was maintained that the user, KRX_API_KEY without
"Based on official KRX data / Not investment advice" was left at the end of the response.

Notes

Original reference: https://github.com/jjlabsio/korea-stock-mcp
Official data source: KRX Open API (https://openapi.krx.co.kr/contents/OPP/MAIN/main/index.cmd)
This skill is for read-only lookup only.