gadicc/yahoo-finance2

Unofficial API for Yahoo Finance with CLI, MCP and Agent Skill

What it solves

It provides an unofficial API wrapper for Yahoo Finance, allowing developers to programmatically access financial data such as stock quotes, historical prices, and company fundamentals without an official API from Yahoo.

How it works

The project acts as a client library that interfaces with Yahoo Finance's internal data sources. It offers a TypeScript-based API with various modules for searching symbols, retrieving quotes, and accessing detailed company summaries. It also includes a Command Line Interface (CLI) and supports multiple runtimes like Node.js, Bun, Deno, and Cloudflare Workers.

Who it’s for

Developers building financial applications, portfolio trackers, or AI agents that need real-time and historical market data.

Highlights

  • Broad Data Access: Supports modules for charts, historical data, options, and comprehensive quote summaries (including balance sheets and income statements).
  • AI Integration: Includes an MCP (Model Context Protocol) implementation to expose tools to AI clients like Claude and Cursor, and ships with a compatible Agent Skill.
  • CORS-Aware: Designed for server-side execution to bypass browser CORS and cookie restrictions.
  • TypeScript Support: Provides full type checking and auto-completion for financial data structures.

Related

  • Project
    ferdousbhai/investor-agent

    A financial research MCP server that provides AI agents with tools to fetch stock fundamentals, historical prices, and technical indicators for long-term investing.

  • Project
    zhangxiangliang/stock-api

    A zero-dependency TypeScript stock data tool that provides a unified API for A-share, HK, and US stock quotes with native support for AI agents via MCP.

  • Project
    chengzuopeng/stock-sdk

    A zero-dependency JavaScript/TypeScript SDK for accessing real-time and historical stock market data across multiple global markets, featuring built-in technical indicators and an MCP server for AI integration.

  • Project
    simonlin1212/global-stock-data

    A full-stack US and HK market data toolkit designed as a skill for AI coding assistants to fetch quotes, options Greeks, SEC filings, and macro data without API keys.

  • Project
    JerBouma/FinanceToolkit

    An open-source financial toolkit providing over 500 transparent calculation methods for financial metrics, eliminating reliance on inconsistent proprietary data sources.