Name: korean-stock-search
Author: nomadamas

韓國股票搜尋

此技能的功能

基本上透過 https://k-skill-proxy.nomadamas.org/v1/korean-stock/... 發送請求，查詢 KRX 上市股票、基本資訊及每日行情。

上游設計參考 jjlabsio/korea-stock-mcp，但使用者無需申請 KRX_API_KEY 或安裝本地 MCP 伺服器。KRX_API_KEY 僅由代理伺服器管理。

使用時機

"幫我查三星電子的股票代碼和市場分類"
"顯示 005930 的基本資訊"
"告訴我 SK 海力士 20260408 的收盤價和成交量"
"查詢 KOSDAQ 中 Alteogen 的行情"

不適用時機

查詢非韓國股票（如美國、日本、加密貨幣）
查詢即時成交、報價、分時線
分析財務報表或公告原文（超出此技能範圍）
提供投資建議或買入推薦

輸入參數

q：股票名稱或代碼的搜尋關鍵字（用於 search 端點）
market：KOSPI | KOSDAQ | KONEX
code：股票代碼（通常為 6 位縮寫，例如 005930）
bas_dd：基準日期 YYYYMMDD（若未提供，預設為韓國時間當天日期；若為休市日，則自動重試最近交易日）
limit：搜尋結果數量（預設 10，最大 20）

前置需求

無。使用者無需準備 KRX_API_KEY。上游金鑰僅由代理伺服器注入。

預設路徑

無需額外的客戶端 API 層。只需向代理伺服器發送 HTTP 請求即可。

若設有 KSKILL_PROXY_BASE_URL 環境變數，則使用該值；否則使用預設路徑 https://k-skill-proxy.nomadamas.org。

支援的端點

股票搜尋

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}

範例請求

股票搜尋：

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'

回應格式

搜尋回應

{
  "items": [
    {
      "market": "KOSPI",
      "code": "005930",
      "standard_code": "KR7005930003",
      "name": "삼성전자",
      "short_name": "삼성전자",
      "english_name": "Samsung Electronics",
      "listed_at": "1975-06-11"
    }
  ],
  "query": { "q": "삼성전자", "bas_dd": "20260408", "limit": 10 },
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

基本資訊回應

{
  "item": {
    "market": "KOSPI",
    "code": "005930",
    "standard_code": "KR7005930003",
    "name": "삼성전자",
    "short_name": "삼성전자",
    "english_name": "Samsung Electronics",
    "security_group": "주권",
    "section_type": "대형주",
    "stock_certificate_type": "보통주",
    "par_value": 100,
    "listed_shares": 5969782550
  },
  "query": { "market": "KOSPI", "code": "005930", "bas_dd": "20260408" },
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

每日行情回應

{
  "item": {
    "market": "KOSPI",
    "code": "005930",
    "standard_code": "KR7005930003",
    "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
  },
  "query": { "market": "KOSPI", "code": "005930", "bas_dd": "20260408" },
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

回應策略

若股票名稱不明確，先使用 search 縮小市場/股票代碼範圍，再查詢 base-info 或 trade-info。
若部分市場的上游服務失敗，則回傳 upstream.degraded=true 及 failed_markets，並說明部分服務異常。
trade-info 結果為每日快照，請勿將其描述為即時報價或成交。
若基準日為休市日或收盤前，可能無資料，請重試最近交易日。此時 trade-info 可能回傳 not_found 而非 502。
數字應以易讀單位（元、股、億/兆）簡短呈現，同時保留原始數值。
回應結尾簡短備註「資料來源：KRX 官方數據 / 非投資建議」。

保持回答簡潔

股票名稱 / 市場 / 股票代碼
基準日期
收盤價 / 漲跌幅 / 成交量 / 市值
必要時才顯示上市日期 / 上市股數 / 面額
若有多個候選，僅顯示前 3~5 個，讓使用者選擇

失敗模式

若 q、market、code、bas_dd 格式錯誤，回傳 400
若代理伺服器缺少 KRX_API_KEY，回傳 503
若搜尋時部分市場上游服務失敗，仍回傳 200，但可能包含 upstream.degraded=true 及 failed_markets
若所有請求市場的上游 KRX 查詢均失敗，回傳 502
若在指定基準日/市場中找不到股票，回傳 404 not_found

完成條件

若搜尋關鍵字不明確，已先透過 search 縮小候選範圍。
必要時已呼叫 base-info 及 trade-info，整理出核心數據。
確保使用者無需 KRX_API_KEY 即可查詢。
簡短備註資料來源為 KRX 官方數據。

備註

原始參考：https://github.com/jjlabsio/korea-stock-mcp
官方資料來源：KRX Open API (https://openapi.krx.co.kr/contents/OPP/MAIN/main/index.cmd)
此技能僅供唯讀查詢使用。

korean-stock-search

相關技能