How do I install the Yahoo Finance skill?

Run npx skillmds@latest add modbender/yahoo-finance-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Yahoo Finance safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Yahoo Finance?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Yahoo Finance free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Yahoo Finance?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Yahoo Finance by modbender — Agent Skill

Name: Yahoo Finance
Author: modbender

File contents

Yahoo Finance CLI

A Node.js CLI for fetching comprehensive stock data from Yahoo Finance using the yahoo-finance2 library.

Requirements

Node.js
yahoo-finance2 installed globally or available as yf
jq

Install

brew install jq
npm install yahoo-finance2
sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf

Usage

The tool is available as yf. It outputs JSON, which can be piped to jq for filtering.

yf <module> <symbol> [queryOptions]

Modules

Quote (Real-time Price & Data)

Get real-time price, change, and basic data.

yf quote AAPL
yf quote AAPL | jq '.regularMarketPrice'

Quote Summary (Fundamentals & More)

Get detailed modules like earnings, financial data, and profiles.

# Get specific sub-modules
yf quoteSummary AAPL '{"modules":["assetProfile", "financialData", "defaultKeyStatistics"]}'

# Common modules to request:
# - assetProfile (Company info, sector)
# - financialData (Target price, margins, cash)
# - defaultKeyStatistics (Enterprise value, float, shares)
# - calendarEvents (Earnings dates)
# - earnings (History and trend)
# - recommendationTrend (Analyst ratings)
# - upgradeDowngradeHistory

Insights

Get technical and fundamental insights (valuation, outlook).

yf insights AAPL

Search

Search for symbols.

yf search "Apple"
yf search "BTC-USD"

Historical Data (Deprecated)

Get historical OHLCV data. Note: historical is deprecated; use chart instead.

# Deprecated - use chart instead
yf historical AAPL '{"period1":"2024-01-01","period2":"2024-12-31"}'

# Recommended: use chart
yf chart AAPL '{"period1":"2024-01-01","period2":"2024-12-31"}'

Examples

Quick Price Check

# Full JSON then filter with jq
yf quote NVDA | jq '{symbol: .symbol, price: .regularMarketPrice, changePct: .regularMarketChangePercent}'

Next Earnings Date

# Use single quotes around the JSON option in zsh/bash
yf quoteSummary TSLA '{"modules":["calendarEvents"]}' | jq '.calendarEvents.earnings.earningsDate'

Analyst Recommendations

yf quoteSummary AAPL '{"modules":["recommendationTrend"]}'

Company Profile

yf quoteSummary MSFT '{"modules":["assetProfile"]}'

Historical OHLCV

# Using chart (recommended)
yf chart AAPL '{"period1":"2024-01-01","period2":"2024-12-31","interval":"1d"}' | jq '.quotes[0:5]'

# Using historical (deprecated, but still works)
yf historical AAPL '{"period1":"2024-01-01","period2":"2024-12-31","interval":"1d"}' | jq '.[0:5]'

Search for Symbols

yf search 'Apple'
yf search 'BTC-USD'

Trending Symbols (US)

yf trendingSymbols US

Insights (valuation, outlook)

yf insights AAPL

Troubleshooting

Cookies: The tool automatically handles cookies (stored in ~/.yf2-cookies.json). If you encounter issues, try deleting this file.
JSON Output: The output is pure JSON. Use jq to parse it for scripts or readability.

Additional tips:

If you see authentication or parsing errors, delete the cookie file and retry:

rm -f ~/.yf2-cookies.json
yf quote AAPL

On macOS with zsh, prefer single quotes around JSON option arguments and use double quotes inside (see examples above).
If you want a compact numeric value only (no jq), use a short jq filter, e.g.:

yf quote AAPL | jq -r '.regularMarketPrice'

---name: yahoo-finance-2description: This skill should be used when the user asks to "get stock prices", "check stock quotes", "look up earnings", "get financial data", "find trending stocks", or needs stock market data from Yahoo Finance.---# Yahoo Finance CLIA Node.js CLI for fetching comprehensive stock data from Yahoo Finance using the `yahoo-finance2` library.## Requirements- Node.js- `yahoo-finance2` installed globally or available as `yf`- `jq`## Install```bashbrew install jqnpm install yahoo-finance2sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf```## UsageThe tool is available as `yf`. It outputs JSON, which can be piped to `jq` for filtering.```bashyf <module> <symbol> [queryOptions]```## Modules### Quote (Real-time Price & Data)Get real-time price, change, and basic data.```bashyf quote AAPLyf quote AAPL | jq '.regularMarketPrice'```### Quote Summary (Fundamentals & More)Get detailed modules like earnings, financial data, and profiles.```bash# Get specific sub-modulesyf quoteSummary AAPL '{"modules":["assetProfile", "financialData", "defaultKeyStatistics"]}'# Common modules to request:# - assetProfile (Company info, sector)# - financialData (Target price, margins, cash)# - defaultKeyStatistics (Enterprise value, float, shares)# - calendarEvents (Earnings dates)# - earnings (History and trend)# - recommendationTrend (Analyst ratings)# - upgradeDowngradeHistory```### InsightsGet technical and fundamental insights (valuation, outlook).```bashyf insights AAPL```### SearchSearch for symbols.```bashyf search "Apple"yf search "BTC-USD"```### Historical Data (Deprecated)Get historical OHLCV data. Note: `historical` is deprecated; use `chart` instead.```bash# Deprecated - use chart insteadyf historical AAPL '{"period1":"2024-01-01","period2":"2024-12-31"}'# Recommended: use chartyf chart AAPL '{"period1":"2024-01-01","period2":"2024-12-31"}'```### TrendingSee what's trending.```bashyf trendingSymbols US```## Examples**Quick Price Check**```bash# Full JSON then filter with jqyf quote NVDA | jq '{symbol: .symbol, price: .regularMarketPrice, changePct: .regularMarketChangePercent}'```**Next Earnings Date**```bash# Use single quotes around the JSON option in zsh/bashyf quoteSummary TSLA '{"modules":["calendarEvents"]}' | jq '.calendarEvents.earnings.earningsDate'```**Analyst Recommendations**```bashyf quoteSummary AAPL '{"modules":["recommendationTrend"]}'```**Company Profile**```bashyf quoteSummary MSFT '{"modules":["assetProfile"]}'```**Historical OHLCV**```bash# Using chart (recommended)yf chart AAPL '{"period1":"2024-01-01","period2":"2024-12-31","interval":"1d"}' | jq '.quotes[0:5]'# Using historical (deprecated, but still works)yf historical AAPL '{"period1":"2024-01-01","period2":"2024-12-31","interval":"1d"}' | jq '.[0:5]'```**Search for Symbols**```bashyf search 'Apple'yf search 'BTC-USD'```**Trending Symbols (US)**```bashyf trendingSymbols US```**Insights (valuation, outlook)**```bashyf insights AAPL```## Troubleshooting- **Cookies:** The tool automatically handles cookies (stored in `~/.yf2-cookies.json`). If you encounter issues, try deleting this file.- **JSON Output:** The output is pure JSON. Use `jq` to parse it for scripts or readability.Additional tips:- If you see authentication or parsing errors, delete the cookie file and retry:```bashrm -f ~/.yf2-cookies.jsonyf quote AAPL```- On macOS with zsh, prefer single quotes around JSON option arguments and use double quotes inside (see examples above).- If you want a compact numeric value only (no jq), use a short jq filter, e.g.:```bashyf quote AAPL | jq -r '.regularMarketPrice'```

Frequently asked questions

Yahoo Finance