yahoo-finance-cli_skill

This skill helps you retrieve stock prices and financial data from Yahoo Finance, empowering quick market insights and informed decisions.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

4 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill yahoo-finance-cli

_meta.json290 B
SKILL.md4.1 KB

Overview

This skill provides a command-line interface wrapper around Yahoo Finance data for fetching real-time quotes, fundamentals, earnings, charts, trending symbols, and search results. It outputs pure JSON so you can consume or pipe results into tools like jq. Use it when you need quick, scriptable access to stock market data from Yahoo Finance.

How this skill works

The skill calls Yahoo Finance endpoints (via the yahoo-finance2 client) to retrieve modules such as quote, quoteSummary, chart, insights, search, and trendingSymbols. It returns structured JSON for each command and saves session cookies to a local file for repeated queries. You can filter and format results with jq or incorporate them directly into automation and scripts.

When to use it

Check a stock's current price and percentage change
Lookup company fundamentals, analyst recommendations, or upcoming earnings
Fetch historical OHLCV or intraday chart data for analysis
Search for ticker symbols or crypto pairs
See trending stocks for a market (e.g., US trending symbols)
Build scripts or dashboards that require JSON-formatted market data

Best practices

Pipe output to jq for reliable parsing and human-readable filters
Prefer chart over deprecated historical for OHLCV data
Request only the modules you need with quoteSummary to reduce payload and latency
Use single quotes around JSON options in zsh/bash, and double quotes inside those JSON strings
If you encounter parsing or auth errors, delete the cookie file (~/.yf2-cookies.json) and retry

Example use cases

Quick price check in a shell script: retrieve regularMarketPrice for automation alerts
Get next earnings date for a symbol using quoteSummary calendarEvents
Pull analyst recommendation trends for portfolio research
Download daily OHLCV for backtesting using chart with period1/period2 and interval
Search tickers programmatically to resolve ambiguous company names or crypto pairs
Show trending US symbols for a market-watch dashboard

FAQ

JSON ensures machine-readable output so you can reliably parse, filter, and use the data in scripts, dashboards, or downstream tools like jq.

What if I get authentication or parsing errors?

Delete the cookie file (~/.yf2-cookies.json) and rerun the command; the tool will recreate cookies. Also ensure you use correct quoting for JSON arguments in your shell.