yfinance MCP 服务器 - 获取 Yahoo Finance 实时和历史金融数据 | 股票价格、期权、财报、新闻

yfinance by rizkydwicmt/yfinance-mcp-server

71 周安装量

1 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/rizkydwicmt/yfinance-mcp-server --skill yfinance

数据分析金融科技 API

🇨🇳中文介绍

YFinance MCP Server

从 Yahoo Finance 获取实时和历史金融数据。此 MCP 服务器提供 12 种工具，涵盖股票价格、公司基本面、分析师推荐、期权链、股息、市场波动股和新闻。

可用工具

股票数据 (7 种工具)

`tool_get_stock_price` — 当前价格与交易指标

tool_get_stock_price(symbol: "AAPL")
tool_get_stock_price(symbol: "BBCA.JK")

返回：当前价格、涨跌幅百分比、开盘价、当日最高/最低价、成交量、52周价格范围、市值、市盈率、股息收益率、方向指示（▲/▼）。

`tool_get_stock_info` — 公司详情

tool_get_stock_info(symbol: "MSFT")

返回：行业板块、细分行业、公司全名、市值、市盈率、市净率、利润率、收入增长率、分析师目标价、业务描述。

`tool_get_history` — 历史 OHLCV 数据

tool_get_history(symbol: "AAPL", period: "1mo", interval: "1d")
tool_get_history(symbol: "BBCA.JK", period: "1y", interval: "1wk")
tool_get_history(symbol: "BTC-USD", period: "5y", interval: "1mo")

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

市场分析 (3 种工具)

`tool_compare_stocks` — 并排比较

tool_compare_stocks(symbols: "AAPL,MSFT,GOOG")
tool_compare_stocks(symbols: "BBCA.JK BBRI.JK BMRI.JK")

最多比较 10 只股票，指标包括：价格、涨跌幅百分比、市值、市盈率、股息收益率、利润率、收入增长率、分析师评级。股票代码可以用逗号或空格分隔。

`tool_get_market_movers` — 热门波动股

tool_get_market_movers(mover_type: "gainers")
tool_get_market_movers(mover_type: "losers")
tool_get_market_movers(mover_type: "most_active")

`tool_screen_stocks` — 股票筛选器

tool_screen_stocks(sector: "Technology", min_market_cap: 1000000000)
tool_screen_stocks(max_pe_ratio: 15, min_dividend_yield: 0.03)
tool_screen_stocks(sector: "Healthcare", exchange: "NMS")

所有筛选条件均为可选且可组合使用：

sector : Technology, Healthcare, Financial Services, Energy 等。
min_market_cap : 以美元计（例如 1000000000 = 10亿美元）
max_pe_ratio : 最大追踪市盈率（例如 25）
min_dividend_yield : 以小数表示（例如 0.03 = 3%）
exchange : NMS (NASDAQ), NYQ (NYSE) 等。

搜索与新闻 (2 种工具)

`tool_search_stocks` — 查找股票代码

tool_search_stocks(query: "Apple", max_results: 5)
tool_search_stocks(query: "semiconductor ETF")
tool_search_stocks(query: "bank indonesia")

通过名称、股票代码或关键词搜索股票、ETF、共同基金、指数。

`tool_get_news` — 最新新闻

tool_get_news(symbol: "AAPL", max_items: 5)
tool_get_news(symbol: "TSLA")

返回：每篇文章的标题、发布者、链接、发布时间和缩略图。

此服务器适用于 Yahoo Finance 支持的任何股票代码：

市场	示例
美国股票	AAPL, MSFT, GOOG, TSLA, AMZN
印度尼西亚 (IDX)	BBCA.JK, BBRI.JK, TLKM.JK, BMRI.JK
日本 (TSE)	7203.T (丰田), 6758.T (索尼)
英国 (LSE)	SHEL.L, AZN.L, HSBA.L
香港 (HKEX)	0700.HK (腾讯), 9988.HK (阿里巴巴)
ETF	SPY, QQQ, VTI, VOO, ARKK
加密货币	BTC-USD, ETH-USD, SOL-USD
指数	^GSPC (标普500), ^IXIC (纳斯达克), ^JKSE (IDX)
外汇	USDIDR=X, EURUSD=X, GBPUSD=X

tool_search_stocks → 查找股票代码
tool_get_stock_info → 了解公司概况
tool_get_financials → 分析基本面
tool_get_recommendations → 查看分析师情绪
tool_get_history → 回顾价格趋势

tool_compare_stocks → 比较您的持仓
tool_get_stock_price → 检查当前价格
tool_get_news → 获取各持仓的最新动态

tool_get_market_movers → 寻找热门股票
tool_screen_stocks → 按条件筛选
tool_get_stock_info → 深入研究候选股票

快速安装 (install.sh)

包含的 install.sh 脚本可自动化所有步骤 — uv 设置、Python 3.12 虚拟环境、包安装、mcporter 配置以及 OpenClaw 技能注册：

# 在您的服务器上克隆仓库
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server

# 运行安装程序
chmod +x install.sh
./install.sh

✅ 检查项目目录中是否存在 pyproject.toml
✅ 如果尚未安装则安装 uv
✅ 创建 Python 3.12 虚拟环境
✅ 安装 yfinance-mcp-server 及其所有依赖项
✅ 验证所有 12 种工具是否正确加载
✅ 将 yfinance 添加到您的 mcporter 配置（自动检测）
✅ 将 SKILL.md 安装到 OpenClaw 技能目录

使用环境变量自定义安装程序行为：

# 更改项目位置
YFINANCE_PROJECT_DIR=/opt/mcp/yfinance ./install.sh

# 使用不同的 Python 版本
YFINANCE_PYTHON_VERSION=3.11 ./install.sh

# 自定义虚拟环境位置
YFINANCE_VENV_DIR=/opt/venvs/yfinance ./install.sh

# 指定 mcporter 配置文件路径
MCPORTER_CONFIG=/etc/clawd/mcporter.json ./install.sh

# 自定义 OpenClaw 目录
CLAWD_DIR=/opt/clawd ./install.sh

# 跳过 mcporter / 技能步骤
SKIP_MCPORTER=true ./install.sh
SKIP_SKILL=true ./install.sh

# 1. 克隆仓库
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server

# 2. 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. 创建虚拟环境并安装
uv venv .venv --python 3.12
uv pip install -e . --python .venv/bin/python

# 4. 添加到 mcporter.json
# {"mcpServers": {"yfinance": {"command": "/path/to/.venv/bin/yfin-mcp"}}}

# 5. 安装技能
mkdir -p ${CLAWD_DIR}/skills/yfinance
cp SKILL.md ${CLAWD_DIR}/skills/yfinance/SKILL.md

# 检查工具是否加载
mcporter --config ${CLAWD_DIR}/config/mcporter.json list yfinance --schema

# 实时测试
mcporter --config ${CLAWD_DIR}/config/mcporter.json call yfinance.tool_get_stock_price symbol=AAPL

🇺🇸English

YFinance MCP Server

Access real-time and historical financial data from Yahoo Finance. This MCP server provides 12 tools covering stock prices, company fundamentals, analyst recommendations, options chains, dividends, market movers, and news.

Available Tools

Stock Data (7 tools)

`tool_get_stock_price` — Current Price & Trading Metrics

tool_get_stock_price(symbol: "AAPL")
tool_get_stock_price(symbol: "BBCA.JK")

Returns: current price, change %, open, day high/low, volume, 52-week range, market cap, P/E, dividend yield, direction (▲/▼).

`tool_get_stock_info` — Company Details

tool_get_stock_info(symbol: "MSFT")

Returns: sector, industry, full name, market cap, P/E, P/B, profit margins, revenue growth, analyst price targets, business description.

`tool_get_history` — Historical OHLCV Data

tool_get_history(symbol: "AAPL", period: "1mo", interval: "1d")
tool_get_history(symbol: "BBCA.JK", period: "1y", interval: "1wk")
tool_get_history(symbol: "BTC-USD", period: "5y", interval: "1mo")

period : 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
interval : 1m, , , , , , , , , , , ,

`tool_get_financials` — Financial Statements

tool_get_financials(symbol: "AAPL", statement_type: "income", quarterly: false)
tool_get_financials(symbol: "MSFT", statement_type: "balance_sheet", quarterly: true)
tool_get_financials(symbol: "GOOG", statement_type: "all")

statement_type : income, balance_sheet, cash_flow, all

`tool_get_recommendations` — Analyst Ratings

tool_get_recommendations(symbol: "TSLA")

Returns: recommendation trends (strongBuy, buy, hold, sell, strongSell), price targets (low, mean, median, high), and recent upgrades/downgrades.

`tool_get_options` — Options Chain

tool_get_options(symbol: "AAPL")
tool_get_options(symbol: "TSLA", expiration: "2025-03-21")

Returns: calls and puts with strike, last price, bid, ask, volume, open interest, implied volatility. Lists available expiration dates.

`tool_get_dividends` — Dividend History

tool_get_dividends(symbol: "JNJ")
tool_get_dividends(symbol: "BBCA.JK")

Returns: current yield, ex-date, payment rate, and historical dividend payments.

Market Analysis (3 tools)

`tool_compare_stocks` — Side-by-Side Comparison

tool_compare_stocks(symbols: "AAPL,MSFT,GOOG")
tool_compare_stocks(symbols: "BBCA.JK BBRI.JK BMRI.JK")

Compares up to 10 stocks on: price, change %, market cap, P/E, dividend yield, margins, revenue growth, analyst rating. Symbols can be comma or space separated.

`tool_get_market_movers` — Top Movers

tool_get_market_movers(mover_type: "gainers")
tool_get_market_movers(mover_type: "losers")
tool_get_market_movers(mover_type: "most_active")

`tool_screen_stocks` — Stock Screener

tool_screen_stocks(sector: "Technology", min_market_cap: 1000000000)
tool_screen_stocks(max_pe_ratio: 15, min_dividend_yield: 0.03)
tool_screen_stocks(sector: "Healthcare", exchange: "NMS")

All filters are optional and combinable:

sector : Technology, Healthcare, Financial Services, Energy, etc.
min_market_cap : in USD (e.g., 1000000000 = $1B)
max_pe_ratio : max trailing P/E (e.g., 25)
min_dividend_yield : as decimal (e.g., 0.03 = 3%)
exchange : NMS (NASDAQ), NYQ (NYSE), etc.

Search & News (2 tools)

`tool_search_stocks` — Find Tickers

tool_search_stocks(query: "Apple", max_results: 5)
tool_search_stocks(query: "semiconductor ETF")
tool_search_stocks(query: "bank indonesia")

Searches stocks, ETFs, mutual funds, indices by name, ticker, or keyword.

`tool_get_news` — Latest News

tool_get_news(symbol: "AAPL", max_items: 5)
tool_get_news(symbol: "TSLA")

Returns: title, publisher, link, publish time, and thumbnail for each article.

Supported Markets

This server works with any ticker supported by Yahoo Finance :

Market	Examples
US Stocks	AAPL, MSFT, GOOG, TSLA, AMZN
Indonesia (IDX)	BBCA.JK, BBRI.JK, TLKM.JK, BMRI.JK
Japan (TSE)	7203.T (Toyota), 6758.T (Sony)
UK (LSE)	SHEL.L, AZN.L, HSBA.L
Hong Kong (HKEX)	0700.HK (Tencent), 9988.HK (Alibaba)
ETFs	SPY, QQQ, VTI, VOO, ARKK
Crypto	BTC-USD, ETH-USD, SOL-USD
Indices	^GSPC (S&P 500), ^IXIC (NASDAQ), ^JKSE (IDX)
Forex	USDIDR=X, EURUSD=X, GBPUSD=X

Common Usage Patterns

Investment Research

tool_search_stocks → find the ticker
tool_get_stock_info → understand the company
tool_get_financials → analyze fundamentals
tool_get_recommendations → check analyst sentiment
tool_get_history → review price trends

Portfolio Monitoring

tool_compare_stocks → compare your holdings
tool_get_stock_price → check current prices
tool_get_news → stay updated on each position

Market Discovery

tool_get_market_movers → find trending stocks
tool_screen_stocks → filter by criteria
tool_get_stock_info → deep dive on candidates

Installation

Quick Install (install.sh)

The included install.sh automates everything — uv setup, Python 3.12 venv, package install, mcporter config, and OpenClaw skill registration:

# Clone the repository on your server
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server

# Run the installer
chmod +x install.sh
./install.sh

The installer will:

✅ Check for pyproject.toml in the project directory
✅ Install uv if not already present
✅ Create a Python 3.12 virtual environment
✅ Install yfinance-mcp-server + all dependencies
✅ Verify all 12 tools load correctly
✅ Add yfinance to your mcporter config (auto-detected)
✅ Install SKILL.md to OpenClaw skills directory

Environment Variables

Customize the installer behavior with environment variables:

# Change project location
YFINANCE_PROJECT_DIR=/opt/mcp/yfinance ./install.sh

# Use a different Python version
YFINANCE_PYTHON_VERSION=3.11 ./install.sh

# Custom venv location
YFINANCE_VENV_DIR=/opt/venvs/yfinance ./install.sh

# Specify mcporter config path
MCPORTER_CONFIG=/etc/clawd/mcporter.json ./install.sh

# Custom OpenClaw directory
CLAWD_DIR=/opt/clawd ./install.sh

# Skip mcporter / skill steps
SKIP_MCPORTER=true ./install.sh
SKIP_SKILL=true ./install.sh

Manual Install

# 1. Clone repository
git clone https://github.com/rizkydwicmt/yfinance-mcp-server.git
cd yfinance-mcp-server

# 2. Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 3. Create venv + install
uv venv .venv --python 3.12
uv pip install -e . --python .venv/bin/python

# 4. Add to mcporter.json
# {"mcpServers": {"yfinance": {"command": "/path/to/.venv/bin/yfin-mcp"}}}

# 5. Install skill
mkdir -p ${CLAWD_DIR}/skills/yfinance
cp SKILL.md ${CLAWD_DIR}/skills/yfinance/SKILL.md

Verify

# Check tools load
mcporter --config ${CLAWD_DIR}/config/mcporter.json list yfinance --schema

# Live test
mcporter --config ${CLAWD_DIR}/config/mcporter.json call yfinance.tool_get_stock_price symbol=AAPL

Weekly Installs

Repository

rizkydwicmt/yfi…p-server

GitHub Stars

First Seen

Feb 24, 2026

Security Audits

Gen Agent Trust HubFail SocketPass SnykFail

Installed on

codex70

opencode70

kimi-cli69

gemini-cli69

amp69

github-copilot69

DOCX文件创建、编辑与分析完整指南 - 使用docx-js、Pandoc和Python脚本

51,800 周安装

yfinance MCP 服务器 - 获取 Yahoo Finance 实时和历史金融数据 | 股票价格、期权、财报、新闻

🇨🇳中文介绍

YFinance MCP Server

可用工具

股票数据 (7 种工具)

tool_get_stock_price — 当前价格与交易指标

tool_get_stock_info — 公司详情

tool_get_history — 历史 OHLCV 数据

相关 Skills

tool_get_financials — 财务报表

tool_get_recommendations — 分析师评级

tool_get_options — 期权链

tool_get_dividends — 股息历史

市场分析 (3 种工具)

tool_compare_stocks — 并排比较

tool_get_market_movers — 热门波动股

tool_screen_stocks — 股票筛选器

搜索与新闻 (2 种工具)

tool_search_stocks — 查找股票代码

tool_get_news — 最新新闻

支持的市场

常见使用模式

投资研究

投资组合监控

市场发现

安装

快速安装 (install.sh)

环境变量

手动安装

验证

🇺🇸English

YFinance MCP Server

Available Tools

Stock Data (7 tools)

tool_get_stock_price — Current Price & Trading Metrics

tool_get_stock_info — Company Details

tool_get_history — Historical OHLCV Data

tool_get_financials — Financial Statements

tool_get_recommendations — Analyst Ratings

tool_get_options — Options Chain

tool_get_dividends — Dividend History

Market Analysis (3 tools)

tool_compare_stocks — Side-by-Side Comparison

tool_get_market_movers — Top Movers

tool_screen_stocks — Stock Screener

Search & News (2 tools)

tool_search_stocks — Find Tickers

tool_get_news — Latest News

Supported Markets

Common Usage Patterns

Investment Research

Portfolio Monitoring

Market Discovery

Installation

Quick Install (install.sh)

Environment Variables

Manual Install

Verify

最新 Skills

`tool_get_stock_price` — 当前价格与交易指标

`tool_get_stock_info` — 公司详情

`tool_get_history` — 历史 OHLCV 数据

`tool_get_financials` — 财务报表

`tool_get_recommendations` — 分析师评级

`tool_get_options` — 期权链

`tool_get_dividends` — 股息历史

`tool_compare_stocks` — 并排比较

`tool_get_market_movers` — 热门波动股

`tool_screen_stocks` — 股票筛选器

`tool_search_stocks` — 查找股票代码

`tool_get_news` — 最新新闻

`tool_get_stock_price` — Current Price & Trading Metrics

`tool_get_stock_info` — Company Details

`tool_get_history` — Historical OHLCV Data

`tool_get_financials` — Financial Statements

`tool_get_recommendations` — Analyst Ratings

`tool_get_options` — Options Chain

`tool_get_dividends` — Dividend History

`tool_compare_stocks` — Side-by-Side Comparison

`tool_get_market_movers` — Top Movers

`tool_screen_stocks` — Stock Screener

`tool_search_stocks` — Find Tickers

`tool_get_news` — Latest News