Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Get Started Free →

KRX 한국 주식 검색·시세 · modu-ai | DecimalAI

modu-ai/korean-stock-search

SkillScore95Maintained

이 스킬은 `moai-public-data:korean-stock-search`로 이전되었습니다. KRX 상장 종목 검색·기본정보·일별 시세 조회는 moai-public-data 플러그인을 사용하세요.

financeby modu-ai

Links this skill to your agents and keeps it current with the author’s updates.

Automatic

Finance & Accounting pack

1 · One-time — install the CLI (docs ↗)

pip install decimalai

2 · Get the skill — writes .claude/skills/modu-ai-korean-stock-search/SKILL.md

decimalai skills pull modu-ai-korean-stock-search --out .claude/skills/

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/modu-ai-korean-stock-search/SKILL.md https://app.decimal.ai/s/modu-ai-korean-stock-search/SKILL.md

Raw file: /s/modu-ai-korean-stock-search/SKILL.md ↗ · machine-readable summary at /s/modu-ai-korean-stock-search.json ↗

In productionGlobal

how this skill behaves on real traffic · last 30 days

No production data for this skill yet — usage numbers appear here once agents start running it.

Anonymized aggregate across every org using this skill — proof from real production use, not a demo.

Does this skill help? · Benchmark: with vs. withoutsign in to run this on your agents

22 test cases from the publisher’s eval.yaml · each run twice on gemini-3.6-flash — with the skill injected, then without · last run 8d ago

—+38% tokens0% turns95% of whole cases pass with skill (21/22)

Test case	Without → With	Effect	Δ tokens	Δ turns
case-04	✗→✓	▲ Improved	50%	0%
case-05	✗→✓	▲ Improved	87%	0%
case-07	✗→✓	▲ Improved	89%	0%
case-09	✗→✓	▲ Improved	56%	0%
case-13	✗→✓	▲ Improved	14%	0%

Showing 5 of 22 cases

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

modu-ai / cowork-plugins

moai-finance/skills/korean-stock-search/SKILL.md

View on GitHub ↗

License NOASSERTIONImported 8/3/2026Version v2

Skill contents

SKILL.md

KRX 한국 주식 검색·시세

KRX(한국거래소) 상장 종목 검색, 종목 기본정보, 일별 시세를 조회합니다. moai-business의 DART(공시)를 보완하는 시세 데이터로 활용합니다.

> 본 스킬은 NomaDamas k-skill korean-stock-search (MIT) 기반이며, upstream 설계 참고는 jjlabsio/korea-stock-mcp입니다. KRX_API_KEY는 프록시 서버에서만 관리하므로 사용자 발급 불필요.

When to use / When not to use

사용: 종목 검색(이름·코드), 종목 기본정보, 일별 종가·거래량·시가총액, KRX 공식 데이터 기반 단순 시세 조회.

사용 금지: 미국·일본·가상자산 등 비한국 주식, 실시간 체결·호가·분봉, 재무제표·공시 원문(→ DART MCP 사용), 투자 자문·매수 추천.

Inputs

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

Prerequisites

사용자 측 필수 시크릿 없음.

KSKILL_PROXY_BASE_URL (선택): self-host 시
운영 측 KRX_API_KEY는 프록시 서버 환경에만 둡니다

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

bash
# 종목 검색
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

검색:

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

일별 시세:

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

종목명이 모호하면 먼저 search로 시장/종목코드를 좁힌 뒤 base-info/trade-info 호출.
일부 시장 upstream이 실패하면 upstream.degraded=true + failed_markets를 보고 부분 장애를 함께 설명합니다.
trade-info는 일별 snapshot이며 실시간 호가·체결처럼 말하지 않습니다.
휴장일·장마감 이전이면 해당 bas_dd에 데이터 없을 수 있어 최근 영업일로 재시도합니다.
숫자는 사람이 읽기 쉬운 단위(원, 주, 억/조)로 풀어주되 원본 숫자도 유지합니다.
답변 말미에 "KRX 공식 데이터 기준 / 투자 조언 아님"을 짧게 남깁니다.

응답 컴팩트 규칙

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

Failure modes

q/market/code/bas_dd 형식 오류 → 400
프록시에 KRX_API_KEY 없음 → 503
일부 시장 upstream 실패 → 200 + upstream.degraded=true + failed_markets
모든 시장 upstream 실패 → 502
해당 기준일·시장에 종목 없음 → 404 not_found

관련 스킬 체이닝

before: moai-business:investor-relations — IR 자료 작성 시 KRX 공식 시세 필요
before: DART MCP (moai-business/.mcp.json) — 공시·재무 분석과 결합
after: moai-finance:variance-analysis — 시세 변동 분석
after: moai-office:xlsx-creator — 시세 데이터 엑셀화
after: moai-bi:executive-summary — 경영진 1pager에 시세 요약

Done when

검색어가 모호하면 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 조회 전용입니다.

Want to see if modu-ai/korean-stock-search would activate on your phrasing? Try it before you install — no LLM call, no signup.

Latest benchmark · publisher runVerified

8/22/2026, 15:03 UTC · 22 cases

Measured on 21 comparable cases — below the 22 needed to publish a lift, so this result is shown here but not on the registry card or leaderboard.

Lift

+55%

95% vs 41%

Agent turns

0%

1.0 vs 1.0

Tokens

+38%

2,912.29 vs 2,111.24

fail → pass · 12pass → pass · 9fail → fail · 1

Per-case results (22)

Case	Status	Duration (ms)			Turns			Tokens			Tool calls
Case	Status	Without	With	Δ	Without	With	Δ	Without	With	Δ	Without	With	Δ
case-01 2026년 4월 8일 자 카카오의 종가, 등락률, 거래량, 시가총액 정보가 궁금합니다. 관련 주요 지표를 요약해서 정리해 주세요.	fail→fail	7,532	7,475	-1%	1	1	0%	1,218	2,293	+88%	0	0	—
case-02 국내 증시에 상장된 'SK' 관련 종목들을 찾아서 시장구분과 종목코드를 나열해 주시고, 대표 종목의 최근 일별 시세 정보를 확인해 주세요.	pass→pass	15,150	19,036	+26%	1	1	0%	3,103	3,658	+18%	0	0	—
case-03 삼성전자(005930)의 상장 정보와 2026년 4월 8일 기준 일별 시세(종가, 거래량, 거래대금, 시가총액)를 읽기 쉬운 단위로 정돈해서 보여주세요.	pass→pass	12,519	6,291	-50%	1	1	0%	2,258	3,040	+35%	0	0	—
case-04 나스닥에 상장된 애플(AAPL)의 어제 종가와 주가 이동평균선을 알려주세요.	fail→pass	9,854	3,737	-62%	1	1	0%	1,549	2,327	+50%	0	0	—
case-05 업비트 기준 비트코인(BTC)의 현재 실시간 시세와 24시간 거래량을 조회해 주세요.	fail→pass	8,109	2,887	-64%	1	1	0%	1,226	2,289	+87%	0	0	—
case-06 내일 당장 10% 이상 상승할 가능성이 높은 코스닥 급등 유망주 3개를 추천하고 매수 시점을 자문해 주세요.	pass→pass	14,341	5,803	-60%	1	1	0%	2,015	2,780	+38%	0	0	—
case-07 삼성전자의 최근 분기 사업보고서 전문과 감사보고서 주석 내용을 원문 그대로 모두 출력해 주세요.	fail→pass	10,152	6,795	-33%	1	1	0%	1,613	3,041	+89%	0	0	—
case-08 네이버 종목의 주가 정보를 확인하려고 하는데, 시장구분이나 정확한 6자리 코드를 모르겠습니다. 어떤 절차로 확인해야 하나요?	pass→pass	8,605	6,272	-27%	1	1	0%	1,499	2,982	+99%	0	0	—
case-09 이름에 '현대'가 들어간 상장 종목이 너무 많을 때 검색 결과를 유저에게 전달하는 정리 방식 가이드를 제시해 주세요.	fail→pass	16,614	14,537	-13%	1	1	0%	2,786	4,344	+56%	0	0	—
case-10 삼성전자의 기본 정보(/v1/korean-stock/base-info)를 조회할 때 code 파라미터 값으로 종목명인 '삼성전자'나 숫자 '5930'을 직접 입력해도 되나요?	pass→pass	10,079	6,582	-35%	1	1	0%	1,535	3,009	+96%	0	0	—
case-11 일반 사용자가 KOSPI 종목 시세를 조회하기 위해서 개인 KRX API Key를 직접 발급받아서 설정해야 하나요?	pass→pass	11,386	2,494	-78%	1	1	0%	1,870	2,178	+16%	0	0	—
case-12 일요일이나 공휴일처럼 장이 열리지 않은 날짜를 기준일(bas_dd)로 설정해 일별 시세를 조회하면 결과가 어떻게 처리되나요?	pass→pass	14,175	6,115	-57%	1	1	0%	2,232	2,896	+30%	0	0	—
case-13 특정 시장의 외부 서버 응답 장애로 인해 partial degradation이 발생했을 때 시스템이 반환하는 응답 구조와 처리 방법을 설명해 주세요.	fail→pass	18,025	7,798	-57%	1	1	0%	2,790	3,181	+14%	0	0	—
case-14 카카오 종목의 실시간 1분봉 차트 및 매도/매수 10호가 체결 잔량을 보여줄 수 있나요?	fail→pass	9,453	5,439	-42%	1	1	0%	1,631	2,664	+63%	0	0	—
case-15 한국거래소 상장 종목을 검색어로 찾기 위해 GET 요청을 보낼 때 사용하는 엔드포인트 경로와 필수/선택 쿼리 파라미터는 무엇인가요?	fail→pass	15,335	2,891	-81%	1	1	0%	2,660	2,331	-12%	0	0	—
case-16 현대자동차(KOSPI 시장)의 종목 기본정보를 조회하는 REST GET 요청 경로와 파라미터 구성을 작성해 주세요.	fail→pass	12,735	4,295	-66%	1	1	0%	2,409	2,672	+11%	0	0	—
case-17 특정 종목의 일별 시세(종가, 거래량 등)를 조회할 때 쓰이는 엔드포인트 경로와 기준일 날짜 포맷 요구사항을 설명해 주세요.	fail→pass	12,334	5,211	-58%	1	1	0%	2,282	2,804	+23%	0	0	—
case-18 주식 시세 요약 응답을 컴팩트하게 구성할 때 반드시 포함해야 하는 핵심 항목 4가지를 나열해 주세요.	fail→pass	9,074	5,730	-37%	1	1	0%	1,611	2,879	+79%	0	0	—
case-19 시가총액이 400000000000000원이고 거래량이 15000000주일 때, 유저에게 전달할 답변 표현 양식 가이드는 무엇인가요?	pass→pass	12,254	8,060	-34%	1	1	0%	2,267	3,382	+49%	0	0	—
case-20 KONEX 시장에 상장된 벤처기업 종목 시세를 조회하려 합니다. market 파라미터에 들어갈 수 있는 허용 값들을 나열해 주세요.	pass→pass	12,218	3,350	-73%	1	1	0%	2,213	2,439	+10%	0	0	—
case-21 종목 검색 API 호출 시 limit 파라미터의 기본값과 설정 가능한 최대 제한 숫자는 각각 얼마인가요?	fail→pass	9,475	1,593	-83%	1	1	0%	1,554	1,976	+27%	0	0	—
case-22 경영진을 위한 IR(기업설명회) 발표 자료를 준비할 때, KRX 시세 조회 기능과 함께 연계하기 적합한 사전/사후 모듈 체이닝 예시를 기술해 주세요.	fail→pass	19,162	13,346	-30%	1	1	0%	3,233	4,286	+33%	0	0	—

These cases were also screened by the skill’s intent / safety pass.See the Trust review ↗Reproduce this benchmark in Colab ↗

How this skill was measured

DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted, and 21 counted toward the lift figure. The other 1 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +55 percentage points is the difference between those two pass rates over the 21 comparable cases.

Model measured: gemini-3.6-flash
Graded by: gemini-3.6-flash
Grading method: judged
Verification: verified
Pass rate without the skill: 40.9%
Pass rate with the skill: 95.5%
Cases attempted: 22
Cases counted toward lift: 21
Cases that regressed: 0
Skill version measured: v2
Run completed: 8/22/2026, 15:03 UTC

Measured example — same prompt, with vs. without the skill · from the benchmark run · case case-04

Prompt

나스닥에 상장된 애플(AAPL)의 어제 종가와 주가 이동평균선을 알려주세요.

Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.

Show both answers

SkillScore blends 4 signals1 of 4 complete

BenchmarkPass rate WITH skill on a verified run95

Live evalNeeds ≥20 evaluated traces in 30 days

AI ratingNeeds ≥10 rated traces

AdoptionNeeds ≥10 serves across ≥2 orgs in 30 days

Efficiency · separate axis (at equal correctness)+0% turns+39% tokens

Shown for transparency; not credited unless a verified run shows no correctness regression.

Backed by 1 of 4 signals — each added signal makes the score more robust.

Verified on gemini-3.6-flash · re-tested 7 days ago

Other measured skills in the registry, with their headline benchmark lift.