stocks

# Stocks Skill Read-only market data via Yahoo Finance. Five commands: `quote`, `search`, `history`, `compare`, `crypto`. Python stdlib only — no API key, no pip installs. Yahoo's endpoint is unofficial and may rate-limit or change. ## When to Use - User asks for a current stock price (AAPL, TSLA, MSFT, ...) - User wants to look up a ticker by company name - User wants OHLCV history or performance over a date range - User wants to compare several tickers side by side - User asks for a crypto price (BTC, ETH, SOL, ...) ## Prerequisites Python 3.8+ stdlib only. Optional: set `ALPHA_VANTAGE_KEY` to enrich `market_cap`, `pe_ratio`, and 52-week levels when Yahoo's crumb-protected fields come back null. Free key: https://www.alphavantage.co/support/#api-key ## How to Run Invoke through the `terminal` tool. Once installed: ``` SCRIPT=~/.hermes/skills/finance/stocks/scripts/stocks_client.py python3 $SCRIPT quote AAPL ``` All output is JSON on stdout — pipe through `jq` if you want to slice it. ## Quick Reference ``` 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 tickers by company name. Returns top 5: symbol, name, exchange, type. ### `history SYMBOL [--range RANGE]` Dai...