k-skill 韩国股票信息查询指南基于 k-skill-proxy 的 KRX 行情 HTTP API 实战【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill本文以仓库中的 韩国股票信息查询功能文档 为骨架结合 k-skill-proxy 代理服务源码 与配套测试完整讲解如何通过k-skill-proxy完成 KRX 上市股票搜索、基础信息查询与日线行情快照获取。读完本文你将掌握三个 HTTP 端点的参数用法、推荐查询流程、响应字段语义与全部错误码分支并理解用户不持有KRX_API_KEY、密钥由代理服务端托管这一 proxy-first 设计的底层实现。功能概览这个能力能做什么k-skill仓库中的korean-stock-search技能详见 技能定义 与 技能指令元数据标注为category: finance、locale: ko-KR提供三个核心接口端点作用/v1/korean-stock/searchKRX 上市股票搜索按股票名称/代码关键词返回候选列表/v1/korean-stock/base-info单只股票的基础信息板块、证券类型、面值、上市股数等/v1/korean-stock/trade-info单只股票的日线行情快照收盘价、涨跌、成交量、市值等当股票名称存在歧义时先通过search缩小到具体的市场market与股票代码code候选再进入明细查询是这套接口的推荐用法。最重要的规则Proxy First用户不接触 KRX 密钥使用本功能有一条硬性约束基本路径固定为https://k-skill-proxy.nomadamas.org/v1/korean-stock/...用户不需要也不应该准备KRX_API_KEY。密钥只在代理服务器k-skill-proxy端管理与注入。从 代理服务实现 可以看到这一设计的落地方式每个端点首先检查config.krxApiKey若代理端未配置该密钥则直接返回503 upstream_not_configured错误消息为KRX_API_KEY is not configured on the proxy server.配置了就由代理端把密钥拼进对上游https://data-dbg.krx.co.kr/的请求中测试 server.test.js 验证了上游请求头携带AUTH_KEY: krx-key且 URL 携带basDd20260404。上游实现的参考原型是jjlabsio/korea-stock-mcp但本仓库的默认使用方式不是本地安装 MCP 服务器而是直接向代理服务器发 HTTP 请求。如果部署环境设置了KSKILL_PROXY_BASE_URL环境变量客户端应优先使用该值作为基础路径否则回退到默认路径https://k-skill-proxy.nomadamas.org。前置条件与输入参数前置条件无。只要设备能访问互联网即可无需注册 KRX 开放 API、无需申请密钥、无需安装本地 MCP 组件。各端点参数如下以 技能指令 为准参数取值/格式说明q股票名称或代码关键词仅用于search端点如삼성전자marketKOSPI/KOSDAQ/KONEX仅用于base-info/trade-info端点code通常为 6 位短代码如005930股票代码配合market使用bas_ddYYYYMMDD基准日期日线快照日期缺省时默认使用 KST 当天若为休市日则应改传最近营业日limit数字默认 10最大 20仅用于search端点控制返回候选数量推荐查询顺序从模糊到精确的工作流当用户给出的股票名称不明确同名股、多市场上市等情况时文档给出的推荐顺序是股票名称有歧义 → 先调/v1/korean-stock/search?q...找出候选列表从候选中确认market与code需要基础信息 → 调/v1/korean-stock/base-info需要价格/成交量 → 调/v1/korean-stock/trade-info若基准日恰好是休市日无当日快照将bas_dd改指最近营业日重试。三个端点的请求示例股票搜索curl -fsS --get https://k-skill-proxy.nomadamas.org/v1/korean-stock/search \ --data-urlencode q삼성전자 \ --data-urlencode bas_dd20260408对应 HTTP 形态GET /v1/korean-stock/search?q{검색어}bas_dd{YYYYMMDD}基础信息curl -fsS --get https://k-skill-proxy.nomadamas.org/v1/korean-stock/base-info \ --data-urlencode marketKOSPI \ --data-urlencode code005930 \ --data-urlencode bas_dd20260408对应 HTTP 形态GET /v1/korean-stock/base-info?market{KOSPI|KOSDAQ|KONEX}code{종목코드}bas_dd{YYYYMMDD}日线行情curl -fsS --get https://k-skill-proxy.nomadamas.org/v1/korean-stock/trade-info \ --data-urlencode marketKOSPI \ --data-urlencode code005930 \ --data-urlencode bas_dd20260408对应 HTTP 形态GET /v1/korean-stock/trade-info?market{KOSPI|KOSDAQ|KONEX}code{종목코드}bas_dd{YYYYMMDD}使用curl --get --data-urlencode是为了让查询参数自动做 URL 编码避免韩文关键词在 shell 与 URL 中出错。响应结构解读所有响应都包含业务数据、回显query与proxy元信息三部分proxy.cache字段标记本次响应是否命中代理缓存hit及缓存 TTLttl_ms示例中为 300000ms 5 分钟。搜索响应{ 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 } } }响应解析技巧code通常是 6 位短代码standard_code是 KRX 标准代码12 位形如KR7005930003close_price、trading_volume、market_cap等数值字段已由代理端规范化为纯数字可直接参与计算base_date/bas_dd表示该日线快照的基准日期休市日或收盘前请求对应bas_dd可能返回空结果或not_found此时应改取最近营业日重试部分市场上游查询失败时搜索响应仍可能返回200但会附带upstream.degradedtrue与failed_markets列表向用户说明存在部分市场数据缺失代理源码中degraded状态下的结果不会被写入缓存见 server.js。回答模板建议技能文档明确要求最终回答保持紧凑按固定模板组织股票名称 / 市场 / 股票代码基准日期收盘价 / 涨跌幅 / 成交量 / 市值仅在必要时补充上市日期 / 上市股数 / 面值若search返回多个候选只展示前 35 个交由用户选择确认数字按人易读的单位원、주、억/조简写同时保留原始数字最后必须附一行KRX 공식 데이터 기준이며 투자 자문은 아닙니다.基于 KRX 官方数据不构成投资建议。错误与约束对照表场景HTTP 状态响应特征q/market/code/bas_dd格式非法400error: bad_request代理服务器未配置KRX_API_KEY503error: upstream_not_configured搜索时部分市场上游失败200附带upstream.degradedtrue与failed_markets所有请求市场的上游 KRX 查询全部失败502上游错误基准日/市场内找不到该股票404not_found代理实现中的错误映射逻辑见 server.js上游返回的状态码 ≥400 时原样透传否则统一回退为502。源码级验证代理如何工作参数归一化与缓存键search端点先经normalizeKoreanStockSearchQuery归一化再以q小写、bas_dd、market、limit组成缓存键命中缓存时直接返回并标记cache.hittrueserver.js。密钥注入代理端读取config.krxApiKey注入上游请求测试断言上游请求落到data-dbg.krx.co.kr且携带AUTH_KEYserver.test.js。限流与客户端识别测试覆盖了多种部署形态包括直连时不信任伪造的cf-connecting-ip头、信任多级反向代理跳数KSKILL_PROXY_TRUST_PROXY_HOPS、Cloudflare Tunnel 场景按真实客户端限流等server.test.js。超出限流配额时返回429 rate_limited。适用边界什么时候不要用该技能明确只服务于韩国本土股票KRX 市场的只读查询以下场景不适用美国/日本股票或虚拟资产等非韩国股票查询实时成交/盘口/分时分钟级行情——trade-info是日线快照回答时不得表述为实时行情财报/公告原文分析超出本技能范围投资建议或买入推荐。技能本身是纯只读查询能力回答中应始终保留KRX 官方数据、非投资建议的免责尾注并遵守 SKILL.md 中关于不执行支付、不收集明文凭据、不绕过 CAPTCHA 等硬性规则。小结korean-stock-search把申请 KRX API 密钥 部署本地 MCP的成本收敛为直接调用一个 HTTP 代理服务是典型的 proxy-first 技能设计。配合 功能文档、技能指令 与 代理源码你可以快速在 Agent 工作流中接入韩国股票名称消歧、基础信息核验与日线行情快照查询并在每个回复中保持数据来源透明、免责声明完整。【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考