---
id: sm-yahoo-finance
name: "yahoo-finance"
url: https://skills.yangsir.net/skill/sm-yahoo-finance
author: gracefullight
domain: investment
tags: ["yahoo-finance-api", "stock-market-data", "financial-data", "python", "investment-research"]
install_count: 3600
rating: 4.40 (20 reviews)
github: https://github.com/gracefullight/stock-checker
---

# yahoo-finance

> 掌握Yahoo Finance数据获取，能抓取多个股票代码数据，并计算关键财务指标进行分析和预测。

**Stats**: 3,600 installs · 4.4/5 (20 reviews)

## Before / After 对比

### 快速获取股票数据，智能分析指标

## Readme

# 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

Weekly Installs1.9KRepository[gracefullight/s…-checker](https://github.com/gracefullight/stock-checker)GitHub Stars10First SeenJan 27, 2026Security Audits[Gen Agent Trust HubFail](/gracefullight/stock-checker/yahoo-finance/security/agent-trust-hub)[SocketPass](/gracefullight/stock-checker/yahoo-finance/security/socket)[SnykFail](/gracefullight/stock-checker/yahoo-finance/security/snyk)Installed onopencode1.8Kgemini-cli1.7Kcodex1.7Kgithub-copilot1.7Kcursor1.7Kkimi-cli1.7K

---
*Source: https://skills.yangsir.net/skill/sm-yahoo-finance*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-yahoo-finance/markdown*