Yahoo Finance CLI for Openclaw

A powerful terminal-based interface for fetching real-time market data, financial summaries, and historical stock charts.

stuhorsman
v1.0.0
Jan 30, 2026
9
8.4k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install yahoo-finance-cli

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install yahoo-finance-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Yahoo Finance CLI?

The Yahoo Finance CLI is a Node.js-powered tool designed for developers and financial analysts who need programmatic or terminal access to global market data. Leveraging the robust yahoo-finance2 library, this skill provides a seamless way to integrate financial intelligence into your workflows. By utilizing Openclaw Skills like this one, users can bypass manual web searches and retrieve structured JSON data for stocks, ETFs, and cryptocurrencies instantly.

This utility is built to work harmoniously with other command-line tools, allowing for sophisticated data piping and automation. Whether you are building a custom dashboard or performing quick sentiment analysis, this skill serves as a reliable bridge to the vast ecosystem of Yahoo Finance data.

Yahoo Finance CLI Use Cases

  • Monitoring real-time stock prices and market changes for specific tickers.
  • Retrieving detailed financial statements, including earnings reports and balance sheet summaries.
  • Analyzing historical price trends using OHLCV (Open, High, Low, Close, Volume) data.
  • Identifying trending symbols and market movers across different global regions.
  • Researching company profiles, sector information, and analyst recommendation trends.

How Yahoo Finance CLI Works

  1. The user executes the yf command followed by a specific module such as quote, search, or chart.
  2. The CLI communicates with the Yahoo Finance API using the underlying yahoo-finance2 library.
  3. Market data is retrieved and processed, handling authentication cookies automatically via a local storage file.
  4. The skill outputs structured JSON data to the standard output.
  5. Users can pipe this JSON to jq to filter, transform, or extract specific data points for further processing.

Yahoo Finance CLI Setup

To get started with this skill from the Openclaw Skills collection, follow these installation steps:

# Install prerequisite JSON processor
brew install jq

# Install the Yahoo Finance library globally via npm
npm install -g yahoo-finance2

# Create a symlink for easier yf command access (adjust path as needed)
sudo ln -s /opt/homebrew/bin/yahoo-finance /usr/local/bin/yf

Yahoo Finance CLI Data Schema & Taxonomy

The skill organizes market data into several logical modules, all returning JSON. Below is a breakdown of the primary data structures:

Module Output Type Key Data Points
quote JSON Object Price, Change Percent, Market Cap
quoteSummary JSON Object Earnings dates, Asset Profile, Financial Data
chart JSON Array Historical OHLCV, Timestamps
insights JSON Object Valuation metrics, Technical outlook
search JSON Array Symbols, Exchanges, Security types

Persistent Data:

  • ~/.yf2-cookies.json: This file is automatically generated to store session data and authentication cookies required for API access.

Yahoo Finance CLI Advanced Features

  • Modular data fetching via quoteSummary to reduce payload size by requesting only specific sub-modules like assetProfile or calendarEvents.
  • Deep integration with jq for creating custom terminal-based stock tickers and alerts.
  • Support for historical data analysis using the chart module with configurable intervals (1d, 1wk, etc.) and time ranges.
  • Automated cookie management to maintain session persistence without manual intervention.
  • Multi-region support for tracking trending symbols in various global markets via the trendingSymbols module.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*