yahoo-finance

What This Skill Does

The yahoo-finance skill is a powerful command-line interface and AI agent tool that provides deep insights into financial markets. Powered by the robust 'yfinance' library, it fetches real-time and historical market data, company fundamentals, earnings reports, options chains, and analyst ratings without requiring any paid API keys. Whether you are tracking a stock price, analyzing long-term dividend yield, or comparing industry competitors, this tool acts as a high-speed terminal for stock market information directly within your terminal or AI-assisted workspace.

Installation

To integrate this skill, ensure you have Python 3.11+ and the 'uv' package manager installed. Use the OpenClaw CLI to install the package: clawhub install openclaw/skills/skills/ajanraj/yahoo-finance After installation, ensure the 'yf' binary is executable and symlinked to your PATH for global access. The script utilizes PEP 723 metadata to manage its own dependencies, ensuring that the first time you run it, the environment is automatically configured with required libraries like rich for elegant CLI output.

Use Cases

This skill is ideal for financial analysts, investors, and developers building trading tools. Common use cases include: quickly checking market sentiment via analyst ratings, comparing the historical growth of multiple assets, evaluating fundamental health through PE ratios and ROE, and checking near-the-term earnings schedules for portfolio management. It is particularly useful for users who need a lightweight, offline-feeling tool to access complex financial datasets instantly.

Example Prompts

1. "Check the current fundamentals for NVDA and compare its market cap with AAPL and MSFT."
2. "What is the upcoming earnings date for TSLA and how have their EPS estimates trended recently?"
3. "Show me the near-the-money options chain for SPY to help me evaluate short-term volatility."

Tips & Limitations

Note that while 'yfinance' is highly capable, it relies on scraping public data from Yahoo Finance; therefore, it should not be used for high-frequency algorithmic trading or mission-critical financial software where sub-second latency is required. Always verify data against brokerage platforms before making major investment decisions. For global assets, ensure you use the correct suffix (e.g., .NS for NSE, .BO for BSE) to ensure data accuracy. The compare function is limited to lists of tickers separated by commas without spaces.