Yahoo Finance
- 4.4k installs
- 39 repo stars
- Updated July 27, 2026
- gracefullight/stock-checker
yahoo-finance is an agent skill for Yahoo Finance market data via the yf CLI: quotes, fundamentals, earnings, options, and search without an API key.
About
The yahoo-finance skill provides a Python CLI for comprehensive market data from Yahoo Finance using the yfinance library and uv-managed inline dependencies. The yf script supports price, quote, fundamentals, earnings, company profile, dividends, analyst ratings, options chains, historical ranges, multi-symbol compare, and fuzzy search across US equities, Indian NSE and BSE tickers, crypto, forex, and ETFs. PEP 723 metadata auto-installs yfinance and rich on first run. Output uses Rich tables with NaN fallbacks. Prerequisites are Python 3.11 plus uv, with install paths for macOS, Linux, and Windows. Agents use it for quick valuation checks, earnings dates, options snapshots, peer compare tables, and symbol resolution when no paid market data API is configured. Troubleshooting covers rate limits, missing symbols, and uv PATH setup after install on new machines or fresh terminal shells.
- No API key required; yfinance plus uv PEP 723 inline deps install on first run.
- Commands span price, quote, fundamentals, earnings, dividends, ratings, options, history, compare, and search.
- Supports US, Indian NSE and BSE, crypto, forex, and ETF symbol formats.
- Rich formatted tables with graceful NaN and None handling in output.
- Install via chmod plus optional symlink; documents rate-limit and missing-data recovery.
Yahoo Finance by the numbers
- 4,386 all-time installs (skills.sh)
- +57 installs in the week ending Jul 28, 2026 (Skillselion tracking)
- Ranked #17 of 1,136 Finance & Trading skills by installs in the Skillselion catalog
- Security screen: CRITICAL risk (skills.sh audit)
- Data as of Jul 28, 2026 (Skillselion catalog sync)
yahoo-finance capabilities & compatibility
- Capabilities
- quick price and detailed quote lookup · fundamentals earnings dividends and analyst rati · options chain and historical price ranges · multi symbol compare and fuzzy search · pep 723 uv auto dependency install
- Works with
- tradingview
- Use cases
- trading · research · data analysis
What yahoo-finance says it does
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance.
Uses yfinance library - no API key required.
npx skills add https://github.com/gracefullight/stock-checker --skill yahoo-financeAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 4.4k |
|---|---|
| repo stars | ★ 39 |
| Security audit | 1 / 3 scanners passed |
| Last updated | July 27, 2026 |
| Repository | gracefullight/stock-checker ↗ |
How do I let an agent fetch stock quotes, fundamentals, or earnings from Yahoo Finance without configuring a paid market data API?
Fetch stock quotes, fundamentals, earnings, options, dividends, and symbol search from Yahoo Finance via the yf CLI without an API key.
Who is it for?
Developers who need quick Yahoo Finance lookups through a uv-managed CLI with no API key.
Skip if: Skip when you need authenticated brokerage trading, order placement, or real-time exchange feeds beyond Yahoo Finance.
When should I use this skill?
User asks for stock price, fundamentals, earnings date, options chain, dividend info, or symbol search via yf or yahoo-finance.
What you get
Correct yf commands with formatted tables for prices, fundamentals, earnings, options, history, and symbol search.
- Formatted market data tables
- Symbol search results
- Historical and options output
By the numbers
- No API key required
- PEP 723 uv auto dependency install
- Supports US Indian crypto forex ETF symbols
Files
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 --versionIf not installed, install it using one of these methods:
macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | shmacOS (Homebrew)
brew install uvWindows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"pip (any platform)
pip install uvAfter installation, restart your terminal or run:
source ~/.bashrc # or ~/.zshrc on macOSInstallation
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/yfFirst 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 AAPLQuote (detailed)
yf quote MSFTFundamentals
yf fundamentals NVDAShows: PE ratios, EPS, market cap, margins, ROE/ROA, analyst targets.
Earnings
yf earnings TSLAShows: Next earnings date, EPS estimates, earnings history with surprises.
Company Profile
yf profile GOOGLShows: Sector, industry, employees, website, address, business description.
Dividends
yf dividends KOShows: Dividend rate/yield, ex-date, payout ratio, recent dividend history.
Analyst Ratings
yf ratings AAPLShows: Buy/hold/sell distribution, mean rating, recent upgrades/downgrades.
Options Chain
yf options SPYShows: 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 daysRanges: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
Compare
yf compare AAPL,MSFT,GOOGL
yf compare RELIANCE.NS,TCS.NS,INFY.NSSide-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 AAPLTroubleshooting
"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
{
"owner": "ajanraj",
"slug": "yahoo-finance",
"displayName": "Yahoo Finance",
"latest": {
"version": "1.0.0",
"publishedAt": 1767817868261,
"commit": "https://github.com/clawdbot/skills/commit/b4075a97b83899c6b532214f561d07c3ab282584"
},
"history": []
}
Related skills
Wind Mcp SkillGive their AI coding agent instant access to comprehensive Chinese and global equity, fund, bond, and macroeconomic data from Wind.56.4k67
Upgrade StripeSafely upgrade their Stripe API version and SDKs without introducing breaking changes.51.9k1.7k
Recipe Create Expense TrackerInstantly create a ready-to-use Google Sheets expense tracker with headers, sample data, and sharing permissions.23.9k30k
Backtesting FrameworksCreate realistic event-driven backtesters that simulate order execution, slippage, commissions, and position tracking before committing capital to a trading strategy.13.2k38.2k
Grimoire PolymarketQuery live Polymarket odds, search events, and manage conditional order flow directly from Claude or Cursor without leaving the IDE.11.9k6
CoinglassGive their AI coding agents real-time access to crypto derivatives market data such as funding rates, open interest, long/short ratios, liquidations, and futures OHLC h11.3k18Forks & variants (1)
Yahoo Finance has 1 known copy in the catalog totaling 30 installs. They canonicalize to this original listing.
- kirkluokun - 30 installs
How it compares
yahoo-finance is an agent skill for Yahoo Finance market data via the yf CLI, not a generic alternative.
FAQ
Who is yahoo-finance for?
Developers and analysts automating Yahoo Finance lookups through the yf CLI with uv-managed dependencies.
When should I use yahoo-finance?
When fetching quotes, fundamentals, earnings, options, dividends, or searching symbols without a paid API.
Is yahoo-finance safe to install?
Review the Security Audits panel on this page before installing in production.