Korean Stock Search
Look up KRX-listed Korean tickers, base company fields, and daily trade snapshots via the hosted k-skill-proxy without obtaining your own KRX API key.
Overview
Korean-stock-search is an agent skill for the Idea phase that searches KRX-listed stocks and returns base info and daily trade snapshots through a managed proxy without a user-held KRX API key.
Install
npx skills add https://github.com/nomadamas/k-skill --skill korean-stock-searchWhat is this skill?
- Hosted proxy at k-skill-proxy.nomadamas.org so end users never supply KRX_API_KEY
- Three flows: stock search, base-info by market and code, and daily trade snapshot by bas_dd
- Markets KOSPI, KOSDAQ, and KONEX with bas_dd defaulting to KST today and retry on non-trading days
- Search limit default 10 and maximum 20 results per query
- Search limit defaults to 10 results with a maximum of 20
- Three documented proxy flows: search, base-info, and daily trade snapshot
Adoption & trust: 2.3k installs on skills.sh; 5.4k GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need Samsung or SK hynix codes and recent KRX daily prices in chat but do not want to register for KRX_API_KEY or run a local MCP server.
Who is it for?
Solo builders doing Korean equity name lookup, ticker confirmation, or end-of-day price checks during research and scoping.
Skip if: US or crypto quotes, real-time order books, financial statement deep dives, or buy/sell recommendations.
When should I use this skill?
User asks for Korean listed stock search, 종목 기본정보, or 일별 시세 by code and date using examples like 삼성전자, 005930, or SK하이닉스.
What do I get? / Deliverables
Your agent returns search hits, base listing fields, and daily OHLC-style trade fields from the documented proxy endpoints using q, market, code, and bas_dd inputs.
- Search results with market and short codes
- Base listing metadata for a chosen KOSPI, KOSDAQ, or KONEX symbol
- Daily trade snapshot fields for the requested bas_dd
Recommended Skills
Journey fit
Builders typically pull listed-company and price context while researching opportunities or validating ideas about Korean equities, before committing to a trading or analytics build. The skill is search-and-snapshot research over public market listings, not backend implementation or live operations monitoring.
How it compares
Use this HTTP proxy skill for KRX daily research snapshots, not a full brokerage integration or a generic web scrape.
Common Questions / FAQ
Who is korean-stock-search for?
Indie builders and researchers who work with Korean listed stocks and want their agent to call documented k-skill-proxy endpoints without managing KRX_API_KEY themselves.
When should I use korean-stock-search?
Use it in Idea → Research when you need 종목코드 lookup, KOSPI/KOSDAQ/KONEX base info, or a specific bas_dd daily close and volume—matching the skill’s listed example prompts.
Is korean-stock-search safe to install?
Calls go to a third-party proxy; review the Security Audits panel on this page, avoid sending secrets in queries, and remember the skill is data lookup only—not trading execution.
SKILL.md
READMESKILL.md - Korean Stock Search
# Korean Stock Search ## What this skill does 기본적으로 `https://k-skill-proxy.nomadamas.org/v1/korean-stock/...` 로 요청해서 KRX 상장 종목 검색, 종목 기본정보, 일별 시세를 조회한다. upstream 설계 참고는 [`jjlabsio/korea-stock-mcp`](https://github.com/jjlabsio/korea-stock-mcp) 이지만, 사용자는 `KRX_API_KEY` 를 발급받거나 로컬 MCP 서버를 설치할 필요가 없다. `KRX_API_KEY` 는 proxy 서버에서만 관리한다. ## When to use - "삼성전자 종목코드랑 시장구분 찾아줘" - "005930 기본정보 보여줘" - "SK하이닉스 20260408 종가/거래량 알려줘" - "KOSDAQ 에서 알테오젠 시세 확인해줘" ## When not to use - 미국/일본/가상자산 같은 비한국 주식 조회 - 실시간 체결/호가/분봉 조회 - 재무제표/공시 원문 분석 (이 스킬 범위 밖) - 투자 자문/매수 추천 ## Inputs - `q`: 종목명 또는 종목코드 검색어 (`search` endpoint) - `market`: `KOSPI` | `KOSDAQ` | `KONEX` - `code`: 종목코드 (보통 6자리 단축코드, 예: `005930`) - `bas_dd`: 기준일 `YYYYMMDD` (없으면 KST 오늘 날짜 기본값, 휴장일이면 최근 영업일로 다시 시도) - `limit`: 검색 결과 수 (기본 10, 최대 20) ## Prerequisites 없음. 사용자는 `KRX_API_KEY` 를 준비할 필요가 없다. upstream key는 proxy 서버에서만 주입한다. ## Default path 추가 client 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/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} ``` ## Example requests 종목 검색: ```bash curl -fsS --get 'https://k-skill-proxy.nomadamas.org/v1/korean-stock/search' \ --data-urlencode 'q=삼성전자' \ --data-urlencode 'bas_dd=20260408' ``` 종목 기본정보: ```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=20260408' ``` 종목 일별 시세: ```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=20260408' ``` ## 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": "20260408", "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": "20260408" }, "proxy": { "name": "k-skill-proxy", "cache": { "hit": false, "ttl_ms": 300000 } } } ``` ### 일별 시세 응답 ```json { "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 } } } ``` ## Response policy - 종목명이 모호하면 먼저 `search` 로 시장/종목코드를 좁힌 뒤 `base-info` 또는 `trade-info` 로 들어간다. - 일부 시장 upstream 이 실패하면 `upstream.degraded=true` 와 `fail