Agent skill

Yahoo Finance

by 24mlight in 24mlight/StockClaw

Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance.

MITAuto-check: notesBusiness, Finance & HR

Install Yahoo Finance

skills CLI
$ npx skills add 24mlight/StockClaw --skill yahoo-finance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 24mlight/StockClaw yahoo-finance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/24mlight/StockClaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/yahoo-finance .claude/skills/yahoo-finance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
yahoo-finance
GitHub stars
101
Used in
2 other repos
Token cost
~1.1k tokens
SKILL.md length
353 words
Files
3
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance.

  • Tasks that involve Stock and market analysis
  • SKILL.md covers Requirements, Installing uv, Installation and Commands, plus 4 more sections
  • Runs Python scripts from its folder; calls uv, curl and sh; reaches astral.sh

What it does

Yahoo Finance is an agent skill from 24mlight/StockClaw. Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `_meta.json` and `yf.py`).

It sits in Business, Finance & HR, covering Stock and market analysis. It works with yfinance and Python. The licence is MIT.

When your agent uses it

  • Tasks that involve Stock and market analysis

Example prompts

  • “/yahoo-finance”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 7872331. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • curl
    • sh
    • brew
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • astral.sh

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Yahoo Finance loads about 1.1k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 353 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePipes a well-known installer script into a shellSKILL.md:35
    curl -LsSf https://astral.sh/uv/install.sh | sh
  • NotePipes a well-known installer script into a shellSKILL.md:45
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 24mlight/StockClaw at commit 7872331, republished under its MIT licence (© 24mlight). 353 words, ~1,086 tokens.

Download SKILL.mdSave it as .claude/skills/yahoo-finance/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
yahoo-finance
description
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.

Yahoo Finance CLI

A Python CLI for fetching comprehensive stock data from Yahoo Finance using yfinance.

This repo ships a local executable script at {baseDir}/yf.py.

  • For historical backtest preparation, prefer: uv run {baseDir}/yf.py history AAPL.US MSFT.US --start 2026-03-09 --end 2026-03-12 --output json
  • For quick spot checks, prefer: uv run {baseDir}/yf.py price AAPL.US --output json
  • For broader multi-factor stock analysis, prefer the stock-analysis skill.

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:

bash
uv --version

If not installed, install it using one of these methods:

macOS / Linux
bash
curl -LsSf https://astral.sh/uv/install.sh | sh
macOS (Homebrew)
bash
brew install uv
Windows
powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
pip (any platform)
bash
pip install uv

After installation, restart your terminal or run:

bash
source ~/.bashrc  # or ~/.zshrc on macOS

Installation

The yf script uses PEP 723 inline script metadata - dependencies are auto-installed on first run.

bash
# 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)
bash
yf AAPL              # shorthand for price
yf price AAPL
Quote (detailed)
bash
yf quote MSFT
Fundamentals
bash
yf fundamentals NVDA

Shows: PE ratios, EPS, market cap, margins, ROE/ROA, analyst targets.

Earnings
bash
yf earnings TSLA

Shows: Next earnings date, EPS estimates, earnings history with surprises.

Company Profile
bash
yf profile GOOGL

Shows: Sector, industry, employees, website, address, business description.

Dividends
bash
yf dividends KO

Shows: Dividend rate/yield, ex-date, payout ratio, recent dividend history.

Analyst Ratings
bash
yf ratings AAPL

Shows: Buy/hold/sell distribution, mean rating, recent upgrades/downgrades.

Options Chain
bash
yf options SPY

Shows: Near-the-money calls and puts with strike, bid/ask, volume, OI, IV.

Show full SKILL.md (141 more words)Show less
History
bash
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
bash
yf compare AAPL,MSFT,GOOGL
yf compare RELIANCE.NS,TCS.NS,INFY.NS

Side-by-side comparison with price, change, 52W range, market cap.

bash
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

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

© 24mlight, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in skills/yahoo-finance of 24mlight/StockClaw.

  • SKILL.md
  • _meta.json
  • yf.py

Open the folder on GitHubat commit 7872331

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in 24mlight/StockClaw, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Yahoo Finance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Yahoo Finance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Yahoo Finance this skill24mlight/StockClaw1012 repos~1.1kAutomated safety check: NotesMIT
Stock Analysisliusai0820/Stock-Analysis-Skill141—~904Automated safety check: NotesNone
Yfinance Datahimself65/finance-skills3.4k—~1.3kAutomated safety check: PassMIT
Fin Yfinance Datacriptogus/agent-evolve-network288—~806Automated safety check: PassMIT
US Market Data ToolkitGeeksfino/finskills282—~1.2kAutomated safety check: PassApache-2.0
Market and Stock Deep Researchokikusan-public/stock_skills135—~739Automated safety check: PassNone

Similar skills

  • Stock Analysis

    liusai0820/Stock-Analysis-Skill

    股票智能分析技能。输入股票代码(A股/港股/美股),自动完成: 1. An agent skill from liusai0820/Stock-Analysis-Skill.

    141 GitHub stars~904 tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check: notes
  • Yfinance Data

    himself65/finance-skills

    Fetch financial and market data with the yfinance Python library (Yahoo Finance).

    3.4k GitHub stars~1.3k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed
  • Fin Yfinance Data

    criptogus/agent-evolve-network

    Fetch market and fundamental data via the yfinance Python library — quotes, OHLC history, financial statements, holders, dividends, options, and more.

    288 GitHub stars~806 tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • US Market Data Toolkit

    Geeksfino/finskills

    Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.

    282 GitHub stars~1.2k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Market and Stock Deep Research

    okikusan-public/stock_skills

    Produces deep-dive reports on a stock, industry, market or business model by combining yfinance data with Grok API searches of X and the web.

    135 GitHub stars~739 tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • Value Stock Screener

    okikusan-public/stock_skills

    Screens for undervalued stocks across about 60 regions with yfinance's EquityQuery, using ratios such as PER, PBR, dividend yield and ROE, with optional theme filters.

    135 GitHub stars~2.4k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed

More from 24mlight/StockClaw

  • Stock Analysis

    24mlight/StockClaw

    Analyze stocks and cryptocurrencies using Yahoo Finance data.

    101 GitHub starsUsed in 2 repos~2k tokens
    Auto-check: notes
  • Technical Indicators

    24mlight/StockClaw

    Calculate technical analysis indicators for stock market analysis

    101 GitHub stars~592 tokensUpdated 7 mo ago
    Auto-check passed

Works with

Questions about Yahoo Finance

What does Yahoo Finance do?

Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Yahoo Finance is an agent skill from 24mlight/StockClaw. Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance.

When should I use Yahoo Finance?

Yahoo Finance fits situations like: tasks that involve Stock and market analysis.

How do I install Yahoo Finance in Claude Code?

Run `npx skills add 24mlight/StockClaw --skill yahoo-finance -a claude-code`. Or copy the skill folder (skills/yahoo-finance in 24mlight/StockClaw) into .claude/skills/yahoo-finance in your project. Claude Code loads it when a task matches its description.

How do I install Yahoo Finance in Codex?

Run `npx skills add 24mlight/StockClaw --skill yahoo-finance -a codex`. Or copy the skill folder (skills/yahoo-finance in 24mlight/StockClaw) into .agents/skills/yahoo-finance in your project. Codex loads it when a task matches its description.

Can I use Yahoo Finance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 24mlight/StockClaw --skill yahoo-finance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yahoo-finance, .gemini/skills/yahoo-finance, .github/skills/yahoo-finance and .opencode/skills/yahoo-finance in your project.

What does Yahoo Finance need to run?

Going by SKILL.md and its folder, Yahoo Finance needs Python for the scripts in its folder and the command-line tools its instructions call (uv, curl, sh, brew and pip). Our summary lists: Python 3.

Does Yahoo Finance access the network?

SKILL.md names 1 domain. In commands or code: astral.sh; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Yahoo Finance safe to install?

Our automated static check of SKILL.md found notes only (pipes a well-known installer script into a shell), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Yahoo Finance use?

Yahoo Finance is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Yahoo Finance use?

About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Yahoo Finance?

Skills that share tags, products or a category with Yahoo Finance: Stock Analysis (liusai0820/Stock-Analysis-Skill, 141 stars), Yfinance Data (himself65/finance-skills, 3.4k stars), Fin Yfinance Data (criptogus/agent-evolve-network, 288 stars) and US Market Data Toolkit (Geeksfino/finskills, 282 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yahoo Finance?

24mlight (a GitHub user) maintains it in 24mlight/StockClaw, which has 101 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on March 15, 2026.

Source: 24mlight/StockClaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.