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