yahoo-finance

Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.

By gracefullight · 4,599 installs

npx skills add gracefullight/stock-checker --skill yahoo-finance

Source repository · Upstream listing

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: If not installed, install it using one of these methods: macOS / Linux macOS (Homebrew) Windows pip (any platform) After installation, restart your terminal or run: Installation The yf script uses PEP 723 inline script metadata dependencies are auto installed on first run. First run will install dependencies (yfinance, rich) to uv's cache. Subsequent runs are instant. Commands Price (quick check) Quote (detailed) Fundamentals Shows: PE ratios, EPS, market cap, margins, ROE/ROA, analyst targets. Earnings Shows: Next earnings date, EPS estimates, earnings history with surprises. Company Profile Shows: Sector, industry, employees, website, address, business description. Dividends Shows: Dividend rate/yield, ex date, payout ratio, recent dividend history. Analyst Ratings Shows: Buy/hold/sell distribution, mean rating, recent upgrades/downgrades. Options Chain Shows: Near the money calls and puts with strike, bid/ask, volume, OI, IV. History Ranges: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max Compare Side by side comparison with price, change, 52W range, market cap. Search 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 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