yfinance

YFinance MCP 服务

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

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

返回：看涨期权和看跌期权的行权价、最新价格、买价、卖价、成交量、未平仓合约量、隐含波动率。列出可用的到期日期。

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 只股票的价格、涨跌幅、市值、市盈率、股息率、利润率、营收增长和分析师评级。股票代码可用逗号或空格分隔。

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 = $1B）
• max_pe_ratio：滚动市盈率上限（例如，25）
• min_dividend_yield：以小数表示（例如，0.03 = 3%）
• exchange：NMS（纳斯达克）、NYQ（纽约证券交易所）等

---

搜索与新闻（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

常见用法

投资研究

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 技能注册：

# 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

安装程序将：

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

环境变量

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

# 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

手动安装

# 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

验证

# 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