Stock Quote 是一个专为获取实时股价和基本面数据而设计的技能工具，能够快速响应用户对当前股价或报价的查询需求。它通过集成 yfinance 库作为主要数据源，并在必要时自动切换到网页抓取模式，确保在主流市场开放时段内提供高可靠性的行情信息。该工具不仅支持单只或多只股票的价格查询，还能输出结构化数据，方便开发者将其嵌入到投资组合管理、交易规则校验等自动化流程中。无论是个人投资者还是量化团队，都可以利用其 API 接口轻松实现持仓价值的动态更新与风险监控。 该工具的核心优势在于其灵活的数据输出格式与强大的容错机制。默认情况下，它优先使用 yfinance 提供的标准化字段，包括价格变动、市盈率、市值、成交量以及 52 周区间等关键指标。若网络环境不支持 yfinance，系统会自动降级为基于 requests 的网页解析方式，保证基本功能可用。此外，所有返回结果均包含明确的错误标识字段，便于调用方判断数据有效性，避免因市场休市或股票代码无效导致的程序中断。这种设计使其既能满足终端用户的即时问答场景，也能支撑后台定时任务（如每日心跳更新）对最新市值的持续追踪。
核心功能特点
- 支持单只或多只股票实时价格查询，兼容 NVDA、TSLA 等常见标的
- 自动选择最优数据源（yfinance 优先，web 抓取为备选），提升稳定性
- 输出丰富的基本面字段，包括 PE 比率、市值、52 周区间及股息率
- 支持 JSON 格式输出，便于程序化调用与系统集成
- 内置完善的错误处理机制，标记网络异常、无效代码或闭市状态
- 可集成至自动化流程，用于投资组合估值更新与交易规则合规检查
适用场景
Stock Quote 最典型的应用场景是用户主动询问某只股票的当前报价或涨跌幅情况，例如‘现在 NVIDIA 多少钱？’或‘特斯拉今天跌了多少？’。此时工具能立即返回带颜色标识的价格变动信息，并附上关键财务指标，帮助用户做出快速决策。另一个高频使用场景是在投资组合管理中，系统可通过定时任务调用该技能，批量获取持有的多只股票（如 NVDA、TSLA、BABA 等）的最新价格，并据此更新 MEMORY.md 中的持仓价值表，实现资产规模的动态跟踪。 在企业级风控系统中，Stock Quote 还可作为合规检查的前置模块。例如，当交易策略要求禁止买入市盈率超过 35 的股票时，该工具可在下单前自动拉取目标股的 PE 值进行比对；同样，若设定止损线为 5%，则每日心跳脚本会持续监控各仓位是否接近预设阈值，一旦 TSLA 价格逼近 $385.90 就触发预警通知。这些场景都依赖于 Stock Quote 提供的精确、及时且结构化的市场数据，使其成为连接自然语言交互与量化逻辑的关键桥梁。