yahoo-finance

What This Skill Does

The yahoo-finance skill for OpenClaw provides a powerful command-line interface (CLI) to fetch real-time and historical stock market data. Leveraging the yahoo-finance2 Node.js library, this tool enables the OpenClaw agent to retrieve comprehensive financial metrics, including current stock prices, earnings history, company profiles, analyst recommendations, and trending market symbols. By integrating jq for data processing, the skill allows the agent to parse complex financial JSON responses into precise, actionable insights for the user. It is the definitive bridge between terminal-based financial data fetching and automated agent workflows.

Installation

To integrate this skill into your OpenClaw environment, ensure you have Node.js installed along with the jq processor. Run the following commands:

1. Install dependencies: brew install jq and npm install yahoo-finance2.
2. Link the binary: sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf.
3. Install via OpenClaw: clawhub install openclaw/skills/skills/stuhorsman/yahoo-finance-cli.

Use Cases

• Investment Research: Retrieve detailed company profiles and financial health indicators to perform quick fundamental analysis.
• Market Tracking: Monitor real-time ticker performance and track how major indices or individual stocks like NVDA or AAPL move throughout the trading day.
• Earnings Monitoring: Automatically pull upcoming earnings release dates to prepare for volatility.
• Trend Analysis: Identify currently trending symbols in the US market to spot emerging opportunities.
• Portfolio Automation: Build custom shell scripts that utilize yf and jq to extract specific metrics like P/E ratios or dividend yields for custom reports.

Example Prompts

1. "What is the current stock price of Apple, and can you show me the percentage change today?"
2. "Get the earnings report calendar for Tesla (TSLA) to see when their next announcement is."
3. "Find out which stocks are currently trending in the US market right now."

Tips & Limitations

• Data Precision: Always use jq to filter results. The raw JSON output from Yahoo Finance can be extremely verbose; piping to jq ensures the agent only processes relevant data fields.
• Historical Data: The historical module is officially deprecated. Always prefer the chart module when requesting OHLCV data to ensure future compatibility.
• Symbol Accuracy: While yf search helps locate identifiers, always ensure you have the correct ticker symbol, as exchanges can differ (e.g., BTC-USD vs. BTC).
• Rate Limiting: Be mindful that massive, repeated calls to the Yahoo Finance API may trigger rate limits; cache your results when building automated monitoring loops.