用途:这是一个只读市场数据技能,通过 Yahoo Finance 获取股票与加密货币行情,适合查询当前股价、按公司名查找代码、查看历史 OHLCV、横向对比多个代码以及查询加密货币价格。
主要能力:提供五个命令。quote 返回当前价格、涨跌、涨跌幅、成交量与 52 周高低;search 按公司名查找代码,返回前 5 个结果的代码、名称、交易所与类型;history 返回每日 OHLCV 及最小值、最大值、平均值、总回报率,范围支持 1mo、3mo、6mo、1y、5y,默认 1mo;compare 并排显示价格、涨跌幅与 52 周表现;crypto 查询加密货币价格,传入 BTC 时脚本会自动补上 -USD。
使用方式:通过终端工具调用。安装后设置脚本路径并运行,例如 SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py,然后 python $SCRIPT quote AAPL。所有输出为 stdout 上的 JSON,可用 jq 处理。常用示例:python $SCRIPT quote AAPL MSFT GOOGL TSLA、python $SCRIPT search "Tesla"、python $SCRIPT history NVDA --range 6mo、python $SCRIPT compare AAPL MSFT GOOGL、python $SCRIPT crypto BTC ETH SOL。
前提与限制:仅需 Python 3.8+ 标准库,无需 API key、无需 pip 安装。可选设置 ALPHA_VANTAGE_KEY,在 Yahoo 受 crumb 保护的字段返回 null 时补充 market_cap、pe_ratio 和 52 周水平,免费 key 见 https://www.alphavantage.co/support/#api-key。Yahoo 接口为非官方,可能限流或变更,批量请求之间建议加小延迟。该技能为只读,不支持下单或账户集成。验证命令:python ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL,应返回含 symbol: "AAPL" 和数值 price 字段的 JSON 对象。