This wraps the yfinance Python library in a clean CLI that pulls stock data from Yahoo Finance without needing API keys. You get price checks, fundamentals, earnings dates, options chains, analyst ratings, and dividend info for US stocks, Indian markets, crypto, and forex. It uses uv for dependency management with PEP 723 inline metadata, so first run takes a few seconds to cache dependencies, then it's instant. The compare command is handy for putting multiple tickers side by side. Good for quick terminal lookups when you don't want to open a browser or deal with API rate limits and tokens.

skills.sh installs
4.7K
GitHub stars
49
last updated
Aug 21, 2026

Install

$ npx -y skills add gracefullight/stock-checker --skill yahoo-finance --agent claude-code

Installs into .claude/skills of the current project.

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 --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

Sponsors

Details

Repository
github.com/gracefullight/stock-checker
Categories
Backend & APIs, Finance & Trading

More from gracefullight/stock-checker

All 8
1grafana avatarapp-observabilitygrafana/skillsGet RED metrics + service maps + frontend RUM + AI/LLM monitoring out of Grafana Cloud — Application Observability (`traces_spanmetrics_*` from OTel traces, p504.7Kskills.sh installs
2mvanhorn avatarpp-flight-goatmvanhorn/printing-press-libraryPrinting Press CLI for Flight Goat. Search real Google Flights fares, cheapest dates, Kayak routes, and FlySoar price checks with no API key — plus optional Fli4.7Kskills.sh installs
3agents365-ai avatarexcalidrawagents365-ai/365-skillsUse when user requests diagrams, flowcharts, architecture charts, or visualizations. Also use proactively when explaining systems with 3+ components, complex da4.7Kskills.sh installs
4github avatarazure-pricinggithub/awesome-copilotFetches real-time Azure retail pricing using the Azure Retail Prices API (prices.azure.com) and estimates Copilot Studio agent credit consumption. Use when the 4.7Kskills.sh installs
5github avatarsecret-scanninggithub/awesome-copilotGuide for configuring and managing GitHub secret scanning, push protection, custom patterns, and secret alert remediation. For pre-commit secret scanning in AI 4.6Kskills.sh installs
6anthropics avatarsql-queriesanthropics/knowledge-work-pluginsWrite correct, performant SQL across all major data warehouse dialects (Snowflake, BigQuery, Databricks, PostgreSQL, etc.). Use when writing queries, optimizing4.6Kskills.sh installs