{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md，而非此页面。 */}
股票
通过 Yahoo 获取股票报价、历史数据、搜索、比较和加密货币。
技能元数据
| 来源 | 可选 —— 使用 hermes skills install official/finance/stocks 安装 |
| 路径 | optional-skills/finance/stocks |
| 版本 | 0.1.0 |
| 作者 | Mibay（Mibayy），Hermes Agent |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | Stocks, Finance, Market, Crypto, Investing |
| 相关技能 | dcf-model, comps-analysis, lbo-model |
参考：完整 SKILL.md
:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::
股票技能
通过 Yahoo Finance 获取只读市场数据。五个命令：quote, search, history, compare, crypto。仅使用 Python 标准库 —— 无需 API 密钥，无需 pip 安装。Yahoo 的端点非官方，可能存在速率限制或变更。
使用时机
- 用户查询当前股票价格（AAPL, TSLA, MSFT, …）
- 用户想按公司名称查找股票代码
- 用户想要指定日期范围的 OHLCV 历史数据或表现
- 用户想并排比较多个股票代码
- 用户询问加密货币价格（BTC, ETH, SOL, …）
前提条件
需要 Python 3.8+ 标准库。可选：设置 ALPHA_VANTAGE_KEY 以在 Yahoo 的 crumb 保护字段返回空值时补充 market_cap、pe_ratio 和 52 周水平数据。免费密钥：https://www.alphavantage.co/support/#api-key
如何运行
通过 terminal 工具调用。安装后：
SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py
python3 $SCRIPT quote AAPL
所有输出为 stdout 上的 JSON —— 如需切片，可管道传输至 jq。
快速参考
python3 $SCRIPT quote AAPL
python3 $SCRIPT quote AAPL MSFT GOOGL TSLA
python3 $SCRIPT search "Tesla"
python3 $SCRIPT history NVDA --range 6mo
python3 $SCRIPT compare AAPL MSFT GOOGL
python3 $SCRIPT crypto BTC ETH SOL
命令
quote SYMBOL [SYMBOL2 ...]
当前价格、变动、变动百分比、交易量、52 周高/低。
search QUERY
按公司名称查找股票代码。返回前 5 个：代码、名称、交易所、类型。
history SYMBOL [--range RANGE]
每日 OHLCV 加上统计指标（最低、最高、平均、总回报百分比）。范围：1mo, 3mo, 6mo, 1y, 5y。默认：1mo。
compare SYMBOL1 SYMBOL2 [...]
并排比较：价格、变动百分比、52 周表现。
crypto SYMBOL [SYMBOL2 ...]
加密货币价格。传入 BTC（脚本自动附加 -USD）。
注意事项
- Yahoo Finance 的 API 非官方。端点可能在没有通知的情况下变更或实施速率限制 —— 如果请求开始失败，这就是原因。
market_cap和pe_ratio在quote中可能返回空值，当 Yahoo 的 crumb 会话未建立时。设置ALPHA_VANTAGE_KEY以回填。- 批量请求之间添加小延迟以避免速率限制。
- 此为只读 —— 不能下单，无账户集成。
验证
python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL
返回带 symbol: "AAPL" 和数字 price 字段的 JSON 对象。