# Skills Yahoo Finance

> Yahoo Finance CLI

- Skill: `urjuyaimon09/skills-yahoo-finance` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add urjuyaimon09/skills-yahoo-finance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/urjuyaimon09/skills-yahoo-finance/raw
- Safety review: WARNING
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: urjuyaimon09 (https://skillmd.com/u/urjuyaimon09)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/urjuyaimon09/skills-yahoo-finance

---

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