korean-stock-search Skill (NomaDamas) for Claude Code: What It Does and How to Install It

Makes Claude search Korean listed stocks and read their KRX base information and daily trading data through the k-skill proxy.

Installs: 9K; on skills.sh
Stars: 8.2K; on GitHub
Files: 4; besides SKILL.md
Updated: Nov 2026; last repo commit

This skill lets Claude find a stock on KOSPI, KOSDAQ or KONEX by name or code, show its base information, and fetch the daily snapshot for a date, such as close, change rate, volume and market cap. It is a lookup tool. instruction.md says it is read-only and not for real-time quotes, US or other foreign stocks, filings or investment advice. It is not made by KRX.

SKILL.md is a stub. Its first step has Claude run an npx command that prints the live instructions, and the repo copy is instruction.md. Requests go to a proxy server, so you do not need your own KRX API key. It needs Node.js 18 or newer for the npx step.

Good for

People who ask Claude for a Korean stock's code, market and base info
Anyone who wants a stock's close, volume or market cap on a given date
Users who want KRX data without getting their own KRX API key

Install korean-stock-search

Claude Code

Copy this prompt.

Install the korean-stock-search skill in Claude Code. Run this command:

/plugin marketplace add NomaDamas/k-skill
/plugin install k-skill@k-skill

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18 or newer.

Pick one route. The plugin route installs the k-skill plugin, which covers the whole repo: 135 top-level skill folders (counted from the repo tree), with no hooks or MCP config files in the tree. The skills CLI and folder routes install only korean-stock-search. The skill needs Node.js 18 or newer and runs npx at use time. There is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

Use k-skill-proxy to search Korean listed stocks, inspect KRX base information, and fetch daily trade snapshots without asking the user to issue a KRX API key.

Sections in SKILL.md

Get the full instructions (required first step)
Legal disclaimer (required)
Hard rules even without the CLI

Key facts

Author: NomaDamas (repo owner; k-skill collection for Korean users)
License: MIT
Installs on skills.sh: 8,956 (Nov 2, 2026)
GitHub stars: 8,232 for the whole nomadamas/k-skill repo (Nov 2, 2026)
Last repo commit: Nov 1, 2026
Audits on skills.sh: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn
What it includes: 5 files: SKILL.md, instruction.md, skill.json and 2 reference files (no scripts)
Needs: Node.js 18 or newer for the npx step; no KRX API key (the proxy holds it)
Data source: KRX Open API data via the k-skill proxy; not made by or affiliated with KRX
Part of: The k-skill plugin: 135 top-level skill folders in the repo tree

What it includes

SKILL.md tells Claude to run this first and follow its output
Fetches the current instructions from the k-skill npm package. The repo copy of those instructions is instruction.md.
Runs code · Bootstrap: npx -y @nomadamas/k-skill@0 instruct korean-stock-search
GET /v1/korean-stock/search finds stocks by name or code
Takes q (name or code), optional bas_dd (YYYYMMDD) and limit (default 10, max 20). Returns market, code, names and listing date.
Try: “삼성전자 종목코드랑 시장구분 찾아줘”
Network · Stock search
GET /v1/korean-stock/base-info for one stock
Takes market (KOSPI, KOSDAQ or KONEX), code and bas_dd. Returns security group, section type, par value and listed shares.
Try: “005930 기본정보 보여줘”
Network · Base info
GET /v1/korean-stock/trade-info gives one day's snapshot
Takes market, code and bas_dd. Returns open, high, low, close, change, volume, value and market cap. It is a daily snapshot, not a live quote.
Try: “SK하이닉스 20260408 종가/거래량 알려줘”
Network · Daily trade info
Narrow a vague name with search first; end with a KRX-data, not-advice note
instruction.md tells Claude to keep the answer compact, show only the top 3 to 5 candidates, retry the last business day on holidays and say when a market's upstream failed.
Read · Answer rules
Extra npx commands SKILL.md lists for helper files, the disclaimer and updates
SKILL.md lists npx -y @nomadamas/k-skill@0 files, read (for references/DISCLAIMER.md) and update, which it says keeps the CLI and every coding-agent skill install current.
Runs code · k-skill files, read and update commands

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Claude runs whatever the k-skill npm package prints
SKILL.md says to run npx -y @nomadamas/k-skill@0 instruct korean-stock-search and follow its output as the primary instructions. Claude therefore acts on text that comes from an npm package at run time, and the @0 tag floats across 0.x releases, so the instructions can change without any change to SKILL.md. Read the output before Claude acts on it. github.com
npx -y installs packages without asking
The bootstrap command and the files, read and update commands that SKILL.md lists all run through npx -y, which downloads and runs third-party code. The update command is described as keeping every coding-agent skill install current. github.com
Your queries go to a proxy server
The requests in instruction.md go to https://k-skill-proxy.nomadamas.org by default. The stock names and codes you ask about are part of those requests. Set KSKILL_PROXY_BASE_URL if you want a different base address. github.com
The plugin route installs the whole k-skill set
The k-skill plugin in the repo tree has 135 top-level skill folders, including skills that cover other services. The skills CLI route can install just this one. github.com
The k-skill CLI can send a usage event
docs/usage-analytics.md says the CLI can send a cli_invocation event to PostHog with a random local ID stored in ~/.config/k-skill/analytics-id, the command, skill name, CLI version, runtime mode and success. It says command arguments, input, file contents and credentials are not sent. Set KSKILL_ANALYTICS_DISABLED=1 to opt out. github.com
Personal lookups only, no bulk collection
The SKILL.md legal disclaimer limits automated collection of public information to personal, non-organizational lookups. It says not to use the skill for bulk crawling, database building or getting around access controls. github.com
Hard rules in SKILL.md
SKILL.md says never to run payment, message delivery, final submission, cancellation or public posting without explicit approval, and never to handle plaintext credentials in chat or files. github.com

Technical details

Turning on read-only	No separate mode. instruction.md says the skill is for read-only lookups.
Talks to	k-skill-proxy.nomadamas.org (default proxy; KSKILL_PROXY_BASE_URL overrides it). npm registry (@nomadamas/k-skill via npx). us.i.posthog.com (k-skill CLI usage event, unless you opt out)
Sign-in and keys	instruction.md says no KRX API key is needed from you because the proxy server holds it. SKILL.md says never to ask for or store plaintext credentials.
Scopes	Sends the stock names, codes and dates you ask about to the k-skill proxy Installs and runs npm packages through npx

Questions

What does the korean-stock-search skill do?

It makes Claude search Korean listed stocks, show KRX base information and fetch a stock's daily trading snapshot. It covers KOSPI, KOSDAQ and KONEX.

Does it need a KRX API key?

No key from you. instruction.md says the KRX_API_KEY is kept only on the proxy server, so you do not get one or install a local MCP server. Requests go to the proxy at k-skill-proxy.nomadamas.org unless you set KSKILL_PROXY_BASE_URL.

Does it give live prices or investment advice?

No. instruction.md lists real-time trades, order books and minute charts as out of scope, and says to describe trade-info as a daily snapshot. It also lists investment advice and buy recommendations as out of scope, and Claude is told to end answers with a note that the data is KRX official data and not advice.

Is it made by KRX?

No. The SKILL.md legal disclaimer says the skill is not an official feature of, supported by or affiliated with any third-party service operator it names. It is published by NomaDamas in the k-skill collection.

How do I install it?

Use the install box at the top of this page. The repo README documents a Claude Code plugin that installs the whole k-skill set and a skills CLI command that installs one skill. The npx step needs Node.js 18 or newer.

Can I use it in the Claude app?

There is no upload route on this page. The skill's first step runs an npx command, so it needs a client that can run Node.js on your machine, such as Claude Code or Codex.

Is it safe?

It runs npx with -y, which downloads and runs an npm package without asking, and Claude follows the instructions that package prints. Stock names and codes you ask about go to the proxy server. Read the printed instructions before Claude acts on them, and see the permissions section on this page.

What does it do when the market is closed?

instruction.md says a holiday or a time before close may have no data for that date, so Claude retries the latest business day. In that case trade-info can end with not_found instead of a 502 error.

Does it send usage data?

docs/usage-analytics.md says the k-skill CLI can send a usage event to PostHog (random local ID, command, skill name, CLI version, runtime mode, success). It says command arguments, input, file contents and credentials are not sent, and KSKILL_ANALYTICS_DISABLED=1 opts out.

Information

updated Nov 2, 2026

Repository: nomadamas/k-skill
Folder: korean-stock-search

nomadamas/k-skill skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

k-skill README · github.com
k-skill marketplace.json · github.com
korean-stock-search SKILL.md · github.com
korean-stock-search instruction.md · github.com
k-skill CLI usage analytics · github.com