跳到主要内容

Stocks（股票）

通过 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​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。

Stocks Skill（股票技能）

通过 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 保护字段返回 null 时丰富 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 是非官方的。端点可能会在未通知的情况下变更或实施速率限制 — 如果请求开始失败，原因即在于此。
  • 当未建立 Yahoo 的 crumb 会话时，quote 命令中的 market_cap 和 pe_ratio 可能返回 null。设置 ALPHA_VANTAGE_KEY 可进行回填。
  • 在批量请求之间添加短暂延迟，以避免触发速率限制。
  • 此为只读操作 — 不支持下单，无账户集成。

验证​

python3 ~/.hermes/skills/finance/stocks/scripts/stocks_client.py quote AAPL

返回一个包含 symbol: "AAPL" 和数值型 price 字段的 JSON 对象。