Naver Stock

核心功能

Naver Stock 是一款基于 Node.js 的金融数据查询工具，通过调用 Naver Finance 接口实时获取韩国证券交易所(KRX)及海外市场股票行情。支持通过股票名称或代码查询，返回包含常规交易时段与 Nextrade 替代交易系统(ATS)的完整价格数据。

显著优点

• 双市场覆盖：同时提供 KRX 常规市场与 Nextrade 盘后交易数据，支持 08:00-08:50 盘前及 15:30-20:00 盘后时段交易参考
• 多市场支持：涵盖韩国本土股票、美股等海外市场及外汇汇率查询
• 结构化输出：返回标准化 JSON 格式，包含价格、涨跌幅、币种等 9 个核心字段，便于二次开发集成
• 轻量易用：单一 Node 脚本，无需复杂配置，支持中文/英文/韩文股票名称模糊查询

潜在局限

• 数据源依赖：完全依赖 Naver Finance 非官方接口，存在 API 变更或访问限制风险
• 无历史数据：仅支持实时快照查询，不提供 K 线、成交量等深度行情数据
• Nextrade 流动性风险：盘后交易数据与实际成交可能存在价差，且部分股票 Nextrade 流动性较低
• 无官方 SLA：作为第三方抓取工具，数据延迟与准确性无服务等级保障

适合人群

• 需要快速查询韩股/美股实时价格的个人投资者
• 开发自动化盯盘、价格提醒等轻量化金融工具的开发者
• 关注盘后交易机会、需要对比 Nextrade 与常规市场价差的短线交易者

常规风险提示

• 金融数据仅供参考，不构成投资建议
• 非官方 API 可能随时调整，建议实现本地缓存与降级机制
• 高频调用可能触发 Naver 反爬限制，需合理控制请求频率

核心用法

本 Skill 通过调用 Naver Finance 公开 API，为用户提供韩国 KRX 市场及海外市场的实时股票价格查询服务。使用时只需运行 Node.js 脚本并传入股票名称或代码即可，如 node index.cjs "삼성전자" 或 node index.cjs "AAPL"。支持中文、英文、韩文搜索及代码直接查询，同时覆盖汇率信息（如 USD、엔）。返回数据包含当前价格、涨跌幅、Nextrade 盘后交易价格等完整字段，满足实时金融数据需求。

显著优点

1. 数据源权威：直接对接 Naver Finance 官方 API，数据实时可靠，覆盖韩国本土及全球主要市场。
2. 零依赖安全架构：代码完全自包含，无外部 npm 依赖，node-cache 和 clone 库已内联打包，彻底规避供应链攻击风险。
3. 盘后交易支持：独家提供 Nextrade (NXT) 替代交易系统数据，支持早盘（08:00-08:50）和夜盘（15:30-20:00）交易时段价格查询。
4. 智能缓存机制：内置 20 秒 TTL 本地缓存，减少 API 调用频率，提升响应速度。
5. 多市场兼容：同时支持 KRX 韩股、纳斯达克/纽交所等海外股票及外汇汇率查询。

潜在缺点与局限性

1. 来源可信度受限：开发者为个人开发者（seungdols），属于 T3 级别来源，虽无恶意记录，但长期维护稳定性存疑。
2. 许可证未明确：当前未声明开源许可证，存在潜在的知识产权使用风险。
3. API 依赖风险：完全依赖 Naver Finance 公开 API，若官方调整接口策略或限制访问，功能将受影响。
4. 输入验证待加强：当前输入参数验证较为简单，缺乏长度限制和调用频率控制。
5. 地域服务侧重：主要优化韩国市场体验，海外股票数据的丰富度可能不及专业金融数据商。

适合的目标群体

• 需要快速查询韩股实时价格的投资者和交易员
• 关注三星、现代等韩国龙头企业股价的全球投资者
• 需要进行盘后交易时段价格监控的专业用户
• 希望集成金融数据到自动化工作流的开发者
• 对供应链安全敏感、偏好零依赖架构的技术用户

使用风险说明

1. API 可用性风险：Naver Finance 未承诺 API 稳定性，建议用户关注官方公告并做好降级预案。
2. 数据时效性：虽标注"实时"，但实际存在网络延迟和缓存机制带来的秒级滞后，不适用于高频交易决策。
3. 合规使用：请遵守 Naver 平台服务条款，避免高频调用导致 IP 限制。
4. 金融决策风险：本 Skill 仅提供数据查询，不构成投资建议，用户需自主判断投资风险。