YFinance MCP Server

从 Yahoo Finance 获取实时及历史金融数据。该 MCP Server 提供 12 个工具，覆盖股票价格、公司基本面、分析师评级、期权链、股息、市场涨跌幅榜以及财经新闻等功能。

可用工具

股票数据（7 个工具）

tool_get_stock_price — 当前股价与交易指标

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

返回：当前价格、涨跌幅、开盘价、当日最高/最低价、成交量、52 周价格区间、市值、市盈率（P/E）、股息收益率、涨跌方向（▲/▼）。

tool_get_stock_info — 公司详情

tool_get_stock_info(symbol: "MSFT")

返回：所属行业（sector）、细分行业（industry）、公司全称、市值、市盈率（P/E）、市净率（P/B）、利润率、营收增长率、分析师目标价、业务简介。

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")

• period（时间范围）：1d、5d、1mo、3mo、6mo、1y、2y、5y、10y、ytd、max
• interval（采样间隔）：1m、2m、5m、15m、30m、60m、90m、1h、1d、5d、1wk、1mo、3mo

tool_get_financials — 财务报表

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 — 分析师评级

tool_get_recommendations(symbol: "TSLA")

返回：评级趋势（strongBuy、buy、hold、sell、strongSell）、目标价（最低、平均、中位、最高）以及近期的上调/下调记录。

tool_get_options — 期权链

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

返回：认购（calls）与认沽（puts）期权列表，含行权价、最新成交价、买一价、卖一价、成交量、未平仓合约数、隐含波动率；同时列出所有可选到期日。

tool_get_dividends — 股息历史

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

返回：当前股息收益率、除息日、每股派息金额，以及历史股息发放记录。

市场分析（3 个工具）

tool_compare_stocks — 并排对比

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

最多支持 10 只股票横向对比，涵盖：股价、涨跌幅、市值、市盈率（P/E）、股息收益率、利润率、营收增长率、分析师评级。股票代码之间可用逗号或空格分隔。

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")

返回：每条新闻的标题、发布机构、链接、发布时间及缩略图。

支持的市场

本 Server 支持 Yahoo Finance 所有已覆盖的交易代码（ticker）：

常见使用模式

投资研究

1. tool_search_stocks → 查找对应股票代码
2. tool_get_stock_info → 了解公司基本情况
3. tool_get_financials → 分析财务基本面
4. tool_get_recommendations → 查看分析师情绪倾向
5. tool_get_history → 复盘价格走势

投资组合监控

1. tool_compare_stocks → 对比持仓标的
2. tool_get_stock_price → 查询当前价格
3. tool_get_news → 跟踪各持仓标的最新动态

市场机会挖掘

1. tool_get_market_movers → 发现热门上涨/下跌标的
2. tool_screen_stocks → 按条件筛选潜在标的
3. 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

安装脚本将执行以下操作：

1. ✅ 检查项目目录下是否存在 pyproject.toml
2. ✅ 若未安装 uv，则自动安装
3. ✅ 创建 Python 3.12 虚拟环境
4. ✅ 安装 yfinance-mcp-server 及全部依赖项
5. ✅ 验证全部 12 个工具是否加载成功
6. ✅ 将 yfinance 自动添加至 mcporter 配置（自动检测路径）
7. ✅ 将 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