跳到主要內容

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 對象。