核心用法
naver-stock 是一个基于 Node.js 的命令行工具，通过调用 Naver Finance 官方 API 获取实时股票行情。用户只需输入股票名称（如"삼성전자"、"Tesla"）或代码（如 005930、AAPL），即可返回包含当前价格、涨跌额、涨跌幅、盘后价格及货币单位的结构化 JSON 数据。该技能同时支持 KRX 韩国交易所的本土股票、纳斯达克/纽交所等海外市场股票，以及 USD、JPY 等主要货币汇率查询。
使用方式极为简洁，通过 node index.cjs 命令直接调用，无需复杂配置。内置的自动补全功能允许模糊搜索——输入"삼성"即可匹配三星系列股票，输入"Tesla"即可定位美股代码，大幅降低用户记忆负担。返回数据包含 nxtPrice 等盘后交易信息，对关注美股盘后市场或韩国股市时间外交易的投资者具有实用价值。
显著优点
数据权威性：直接对接 Naver Finance 官方数据源，非第三方抓取或爬虫方案，数据延迟低、准确性有保障。Naver 作为韩国最大的互联网门户，其金融数据服务具有高度可信度。
覆盖全面性：同时覆盖韩国 KOSPI/KOSDAQ 市场与全球主要交易所（美、日、欧等），并支持实时汇率换算，满足跨境投资者的多元化需求。
性能优化设计：采用 node-cache 实现智能缓存策略——股票价格缓存 20 秒以平衡实时性与 API 调用频率，股票代码缓存 24 小时以减少重复搜索开销。这种设计既保证了数据新鲜度，又避免了对 Naver 服务器的过度请求。
安全合规性：代码层面无任何危险函数调用（无 eval/exec/system），依赖库均为成熟开源项目且无已知漏洞。隐私层面严格遵循数据最小化原则，不收集用户 PII，仅基于公开金融数据进行查询。
输出结构化：返回标准 JSON 格式，便于程序化接入自动化工作流、投资分析脚本或机器人通知系统。
潜在缺点与局限性
地域依赖性：核心数据源为 Naver Finance，对韩国本土股票的支持最为完善，美股等海外市场数据虽可获取，但在股票名称的韩英双语匹配上可能存在边缘 case。非韩国用户若使用英文简称搜索，自动补全的准确性可能略有下降。
功能单一性：该技能定位为轻量数据获取工具，仅提供实时价格快照，不具备历史 K 线、财务指标、新闻资讯等深度分析功能。需要完整投研能力的用户需配合其他工具使用。
运行时依赖：需预装 Node.js 环境，且依赖 node-cache 和 clone 两个 npm 包。虽然依赖量极小，但在严格管控的离线环境或容器化部署中仍需额外配置。
API 稳定性风险：作为非官方授权 API 的调用方案（Naver Finance 未公开提供正式 API 文档），存在未来接口变更或限流策略调整的可能性。虽当前运行稳定，但长期维护存在一定不确定性。
无可视化能力：纯文本/JSON 输出，对需要图表展示、趋势分析的用户需自行接入可视化组件。
适合的目标群体
- 个人投资者与交易者：需要快速查询持仓或关注股票的实时价格，尤其是同时操作韩股与美股市场的跨境投资者。
- 自动化交易开发者：可将该技能作为数据输入源，接入自有的量化交易脚本、价格监控机器人或通知推送系统。
- 金融分析师与研究员：需要批量获取实时行情数据进行二次分析，JSON 输出便于与 Python/R 等分析工具链整合。
- 开发者与极客用户：偏好命令行工具、追求轻量解决方案的技术用户，可快速集成到 Shell 脚本或 CI/CD 流程中。
常规使用风险
网络延迟与超时：作为外部 API 调用工具，受网络环境和 Naver 服务器响应影响，高峰期可能出现延迟。当前版本未内置请求超时机制，极端情况下可能导致调用挂起。
缓存数据时效性：20 秒的价格缓存虽提升了性能，但在极端波动行情中可能引入短暂的数据滞后。高频交易者需注意此设计权衡。
API 限流与可用性：Naver Finance 未公开服务等级协议，大规模高频调用可能触发限流。建议用户合理控制请求频率，或配合缓存策略使用。
Node.js 版本兼容性：使用 .cjs 后缀表明 CommonJS 模块格式，在极新版本的 Node.js 默认 ESM 环境中可能需要额外配置。
维护状态：由个人开发者（seungdols）维护，MIT 许可证开源，长期更新节奏取决于社区贡献。关键业务场景建议 fork 后自行维护。