mcpField
Y
yahoo-finance

yahoo-finance

github.com/0juanoData & databases0501 installsUpdated 17w ago
Repository

About yahoo-finance

Yahoo Finance CLI is a terminal skill for looking up market data and financials by ticker. It serves equity and ETF research, macro checks, and LatAm FX analysis through the `yf` script.

Key features

  1. 01Ticker prices, quotes, and comparisons
  2. 02Credit metrics and financial statements
  3. 03Macro and LatAm FX dashboards
  4. 04ETF holdings and fund data
  5. 05Price history, news, and ticker search
  6. 06Tables and machine-readable JSON output

Use cases

  1. 01Check daily market and macro indicators
  2. 02Compare equities for relative value
  3. 03Review a company’s credit and financial statements
  4. 04Research ETF holdings and LatAm exchange rates

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/0juano/agent-skills --skill yahoo-finance

After installing, type/yahoo-financein Claude Code to confirm it loaded.

Bundled filesscripts/yf

Details

From the project README

Yahoo Finance CLI

Financial data terminal powered by Yahoo Finance. All commands via the yf script.

Setup

The script is at {baseDir}/scripts/yf. It uses uv run --script with inline PEP 723 metadata — dependencies install automatically on first run.

chmod +x {baseDir}/scripts/yf

Commands

CommandPurposeExample
yf price TICKERQuick price + change + volumeyf price YPF
yf quote TICKERDetailed quote (52w, PE, yield)yf quote AAPL
yf compare T1,T2,T3Side-by-side comparison tableyf compare YPF,PAM,GGAL
yf credit TICKERCredit analysis: leverage, coverage, debt maturityyf credit YPF
yf macroMorning macro dashboard (UST, DXY, VIX, oil, gold, BTC, ARS)yf macro
yf fx [BASE]LatAm FX rates (ARS, BRL, CLP, MXN, COP)yf fx USD
yf flows ETFETF top holdings + fund datayf flows EMB
yf history TICKER [PERIOD]Price history (1d/5d/1mo/3mo/6mo/1y/ytd/max)yf history YPF 3mo
yf fundamentals TICKERFull financials (IS, BS, CF)yf fundamentals YPF
yf news TICKERRecent news headlinesyf news YPF
yf search QUERYFind tickersyf search "argentina bond"

All commands support --json for machine-readable output.

When to Use Which Command

  • Morning check: yf macro → get UST yields, DXY, VIX, commodities, BTC, ARS in one shot
  • Quick look: yf price TICKER → fast price/change/volume
  • Deep dive equity: yf quote → yf fundamentals → yf history
  • Credit analysis: yf credit TICKER → leverage ratios, interest coverage, debt breakdown
  • EM/LatAm FX: yf fx → all major LatAm pairs vs USD
  • ETF research: yf flows ETF → top holdings, AUM, expense ratio
  • Comparison: yf compare → side-by-side for relative value

Error Handling

The script handles bad tickers, missing data, and rate limits gracefully with clear error messages. If Yahoo Finance rate-limits, wait a moment and retry.

Output

By default, output uses Rich tables for clean terminal display. Add --json to any command for structured JSON output suitable for piping or further processing.

Comments

Markdown supported