hermes-agent/optional-skills/finance/stocks/SKILL.md

name	description	version	author	license	metadata
stocks	Real-time stock quotes, price history, company search, multi-stock compare, and crypto prices via Yahoo Finance. No API key required.	1.0.0	Mibayy	MIT	hermes tags category requires_toolsets stocks finance market trading crypto yahoo-finance investing finance terminal

Stocks & Finance Skill

Real-time stock market data via Yahoo Finance. 5 commands: quote, search, history, compare, crypto.

No API key needed. Python stdlib only.

---

When to Use

• User asks for a stock price (AAPL, TSLA, MSFT...)
• User wants to look up a company by name
• User wants price history or performance over time
• User wants to compare multiple stocks side by side
• User asks for a crypto price (BTC, ETH, SOL...)

---

Prerequisites

Python 3.8+ stdlib only. No pip installs. Script path: ~/.hermes/skills/finance/scripts/stocks_client.py

---

Quick Reference

SCRIPT=~/.hermes/skills/finance/scripts/stocks_client.py
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

---

Commands

quote SYMBOL [SYMBOL2...]

Current price, change, change%, volume, 52-week high/low.

search QUERY

Find stocks by company name. Returns top 5: symbol, name, exchange, type.

history SYMBOL [--range RANGE]

Price history. Ranges: 1mo, 3mo, 6mo, 1y, 5y (default: 1mo). Returns OHLCV per day + stats (min, max, avg, total_return_pct).

compare SYMBOL1 SYMBOL2 [...]

Side-by-side: price, change%, 52w performance.

crypto SYMBOL [SYMBOL2...]

Crypto prices. Pass BTC not BTC-USD (appended automatically).

---

Pitfalls

• Yahoo Finance API is unofficial and may change without notice.
• market_cap and pe_ratio may return null (require session crumb).
• Rate limits: add delays between bulk requests.

---

Verification

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