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