urjuyaimon09 Yahoo Finance CLI
A Python CLI for fetching comprehensive stock data from Yahoo Finance using yfinance.
Requirements Python 3.11+ uv (for inline script dependencies) Installing uv
The script requires uv - an extremely fast Python package manager. Check if it's installed:
uv --version
If not installed, install it using one of these methods:
macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh
macOS (Homebrew) brew install uv
Windows powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
pip (any platform) pip install uv
After installation, restart your terminal or run:
source ~/.bashrc # or ~/.zshrc on macOS
Installation
The yf script uses PEP 723 inline script metadata - dependencies are auto-installed on first run.
Make executable
chmod +x /path/to/skills/yahoo-finance/yf
Optionally symlink to PATH for global access
ln -sf /path/to/skills/yahoo-finance/yf /usr/local/bin/yf
First run will install dependencies (yfinance, rich) to uv's cache. Subsequent runs are instant.
Commands Price (quick check) yf AAPL # shorthand for price yf price AAPL
Quote (detailed) yf quote MSFT
Fundamentals yf fundamentals NVDA
Shows: PE ratios, EPS, market cap, margins, ROE/ROA, analyst targets.
Earnings yf earnings TSLA
Shows: Next earnings date, EPS estimates, earnings history with surprises.
Company Profile yf profile GOOGL
Shows: Sector, industry, employees, website, address, business description.
Dividends yf dividends KO
Shows: Dividend rate/yield, ex-date, payout ratio, recent dividend history.
Analyst Ratings yf ratings AAPL
Shows: Buy/hold/sell distribution, mean rating, recent upgrades/downgrades.
Options Chain yf options SPY
Shows: Near-the-money calls and puts with strike, bid/ask, volume, OI, IV.
History yf history GOOGL 1mo # 1 month history yf history TSLA 1y # 1 year yf history BTC-USD 5d # 5 days
Ranges: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
Compare yf compare AAPL,MSFT,GOOGL yf compare RELIANCE.NS,TCS.NS,INFY.NS
Side-by-side comparison with price, change, 52W range, market cap.
Search yf search "reliance industries" yf search "bitcoin" yf search "s&p 500 etf"
Symbol Format US stocks: AAPL, MSFT, GOOGL, TSLA Indian NSE: RELIANCE.NS, TCS.NS, INFY.NS Indian BSE: RELIANCE.BO, TCS.BO Crypto: BTC-USD, ETH-USD Forex: EURUSD=X, GBPUSD=X ETFs: SPY, QQQ, VOO Examples
Quick price check
yf AAPL
Get valuation metrics
yf fundamentals NVDA
Next earnings date + history
yf earnings TSLA
Options chain for SPY
yf options SPY
Compare tech giants
yf compare AAPL,MSFT,GOOGL,META,AMZN
Find Indian stocks
yf search "infosys"
Dividend info for Coca-Cola
yf dividends KO
Analyst ratings for Apple
yf ratings AAPL
Troubleshooting "command not found: uv"
Install uv using the instructions above.
Rate limiting / connection errors
Yahoo Finance may rate limit excessive requests. Wait a few minutes and try again.
"No data" for a symbol Verify the symbol exists: yf search "company name" Some data (options, dividends) isn't available for all securities Technical Notes Uses PEP 723 inline script metadata for uv dependencies Rich library provides colored, formatted tables First run installs deps to uv cache (~5 seconds) Subsequent runs are instant (cached environment) Handles NaN/None values gracefully with fallbacks