korean-stock-search

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Korean Stock Search

韩国股票搜索

What this skill does

本技能功能

기본적으로

https://k-skill-proxy.nomadamas.org/v1/korean-stock/...

로 요청해서 KRX 상장 종목 검색, 종목 기본정보, 일별 시세를 조회한다.

upstream 설계 참고는

jjlabsio/korea-stock-mcp

이지만, 사용자는

KRX_API_KEY

를 발급받거나 로컬 MCP 서버를 설치할 필요가 없다.

KRX_API_KEY

는 proxy 서버에서만 관리한다.

默认向

https://k-skill-proxy.nomadamas.org/v1/korean-stock/...

发起请求，可实现KRX上市股票搜索、个股基础信息查询、每日行情查询。

上游设计参考了

jjlabsio/korea-stock-mcp

，但用户无需申请

KRX_API_KEY

，也无需安装本地MCP服务器，

KRX_API_KEY

仅由代理服务器统一管理。

When to use

适用场景

"삼성전자 종목코드랑 시장구분 찾아줘"
"005930 기본정보 보여줘"
"SK하이닉스 20260404 종가/거래량 알려줘"
"KOSDAQ 에서 알테오젠 시세 확인해줘"

"帮我找三星电子的股票代码和所属市场"
"给我看005930的基础信息"
"告诉我SK海力士20260404的收盘价/交易量"
"帮我查KOSDAQ市场阿尔特制药的行情"

When not to use

不适用场景

미국/일본/가상자산 같은 비한국 주식 조회
실시간 체결/호가/분봉 조회
재무제표/공시 원문 분석 (이 스킬 범위 밖)
투자 자문/매수 추천

查询美国/日本/虚拟货币等非韩国股票资产
查询实时成交/报价/分钟K线
分析财务报表/公告原文（不属于本技能覆盖范围）
提供投资咨询/买入推荐

Inputs

输入参数

```
q
```
: 종목명 또는 종목코드 검색어 (
```
search
```
endpoint)
```
market
```
:
```
KOSPI
```
|
```
KOSDAQ
```
|
```
KONEX
```
```
code
```
: 종목코드 (보통 6자리 단축코드, 예:
```
005930
```
)
```
bas_dd
```
: 기준일
```
YYYYMMDD
```
(없으면 KST 오늘 날짜 기본값, 휴장일이면 최근 영업일로 다시 시도)
```
limit
```
: 검색 결과 수 (기본 10, 최대 20)

```
q
```
: 股票名称或股票代码搜索关键词（对应
```
search
```
接口）
```
market
```
:
```
KOSPI
```
|
```
KOSDAQ
```
|
```
KONEX
```
```
code
```
: 股票代码（通常为6位短代码，例如：
```
005930
```
）
```
bas_dd
```
: 基准日期
```
YYYYMMDD
```
（不传则默认使用KST当日日期，若为休市日则自动重试最近的交易日）
```
limit
```
: 搜索结果数量（默认10条，最大20条）

Prerequisites

前置要求

없음. 사용자는

KRX_API_KEY

를 준비할 필요가 없다. upstream key는 proxy 서버에서만 주입한다.

无。用户无需准备

KRX_API_KEY

，上游密钥仅由代理服务器统一注入。

Default path

默认路径

추가 client API 레이어는 불필요하다. 그냥 프록시 서버에 HTTP 요청만 넣으면 된다.

KSKILL_PROXY_BASE_URL

환경변수가 있으면 그 값을 사용하고, 없으면 기본 경로

https://k-skill-proxy.nomadamas.org

를 사용한다.

无需额外的客户端API层，直接向代理服务器发起HTTP请求即可。如果存在

KSKILL_PROXY_BASE_URL

环境变量则使用该值，否则使用默认路径

https://k-skill-proxy.nomadamas.org

。

Supported endpoints

支持的接口

종목 검색

股票搜索

http

GET /v1/korean-stock/search?q={검색어}&bas_dd={YYYYMMDD}

http

GET /v1/korean-stock/search?q={검색어}&bas_dd={YYYYMMDD}

종목 기본정보

股票基础信息

http

GET /v1/korean-stock/base-info?market={KOSPI|KOSDAQ|KONEX}&code={종목코드}&bas_dd={YYYYMMDD}

http

GET /v1/korean-stock/base-info?market={KOSPI|KOSDAQ|KONEX}&code={종목코드}&bas_dd={YYYYMMDD}

종목 일별 시세

股票每日行情

http

GET /v1/korean-stock/trade-info?market={KOSPI|KOSDAQ|KONEX}&code={종목코드}&bas_dd={YYYYMMDD}

http

GET /v1/korean-stock/trade-info?market={KOSPI|KOSDAQ|KONEX}&code={종목코드}&bas_dd={YYYYMMDD}

Example requests

请求示例

종목 검색:

bash

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

종목 기본정보:

bash

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=20260404'

종목 일별 시세:

bash

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=20260404'

股票搜索:

bash

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

股票基础信息:

bash

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=20260404'

股票每日行情:

bash

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=20260404'

Response shape

返回结构

검색 응답

搜索响应

json

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

json

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

기본정보 응답

基础信息响应

json

{
  "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": "20260404" },
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

json

{
  "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": "20260404" },
  "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } }
}

일별 시세 응답

每日行情响应

json

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

json

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

Response policy

返回规则

종목명이 모호하면 먼저
```
search
```
로 시장/종목코드를 좁힌 뒤
```
base-info
```
또는
```
trade-info
```
로 들어간다.
```
trade-info
```
결과는 일별 snapshot 이다. 실시간 호가/체결처럼 말하지 않는다.
휴장일/장마감 이전이면 해당
```
bas_dd
```
에 데이터가 없을 수 있으니 최근 영업일로 재시도한다.
숫자는 사람이 읽기 쉬운 단위(원, 주, 억/조)로 짧게 풀어주되 원본 숫자도 유지한다.
답변 말미에 "KRX 공식 데이터 기준 / 투자 조언 아님" 을 짧게 남긴다.

如果股票名称模糊，先通过
```
search
```
接口缩小所属市场/股票代码范围，再调用
```
base-info
```
或
```
trade-info
```
接口查询。
```
trade-info
```
返回的是每日快照数据，不得宣称为实时报价/成交数据。
如果对应
```
bas_dd
```
为休市日或未到收盘时间，可能无对应数据，需自动重试最近的交易日数据。
数值可转换为人类易读的单位（韩元、股、亿/兆韩元）简化展示，但需同时保留原始数值。
回答末尾需附带简短说明：「数据来源于KRX官方 / 不构成投资建议」。

Keep the answer compact

回答精简要求

종목명 / 시장 / 종목코드
기준일
종가 / 등락률 / 거래량 / 시가총액
필요할 때만 상장일 / 상장주식수 / 액면가
여러 후보가 나오면 상위 3~5개만 보여주고 사용자가 고르게 한다

股票名称 / 所属市场 / 股票代码
基准日期
收盘价 / 涨跌幅 / 交易量 / 总市值
仅在用户需要时展示上市日期 / 流通股数 / 面值
若返回多个匹配结果，仅展示前3~5个，引导用户选择所需标的。

Failure modes

错误场景

```
q
```
,
```
market
```
,
```
code
```
,
```
bas_dd
```
형식이 잘못되면 400 응답
프록시 서버에
```
KRX_API_KEY
```
가 없으면 503 응답
upstream KRX 응답 오류면 502 응답
해당 기준일/시장에 종목이 없으면 404
```
not_found
```

```
q
```
、
```
market
```
、
```
code
```
、
```
bas_dd
```
格式错误时返回400响应
代理服务器未配置
```
KRX_API_KEY
```
时返回503响应
上游KRX接口返回错误时返回502响应
对应基准日期/市场下无该股票时返回404
```
not_found
```

Done when

完成判定条件

검색어가 모호하면
```
search
```
로 후보를 먼저 좁혔다.
필요한 경우
```
base-info
```
와
```
trade-info
```
를 호출해 핵심 수치를 정리했다.
사용자가
```
KRX_API_KEY
```
없이도 조회 가능하다는 점을 유지했다.
KRX 공식 데이터 기준임을 짧게 남겼다.

搜索词模糊时，先通过
```
search
```
接口缩小候选范围
需要时调用
```
base-info
```
和
```
trade-info
```
接口，整理核心指标返回
保持用户无需
```
KRX_API_KEY
```
即可查询的特性
简短标注数据来源于KRX官方

Notes

备注

원본 참고:

https://github.com/jjlabsio/korea-stock-mcp

공식 데이터 출처: KRX Open API (

https://openapi.krx.co.kr/contents/OPP/MAIN/main/index.cmd

)

이 스킬은 read-only 조회 전용이다.

原始参考：

https://github.com/jjlabsio/korea-stock-mcp

官方数据来源：KRX Open API（

https://openapi.krx.co.kr/contents/OPP/MAIN/main/index.cmd

）

本技能仅支持只读查询操作。