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 週間の値幅、時価総額、P/E、配当利回り、方向（▲/▼）。

tool_get_stock_info — 企業情報

tool_get_stock_info(symbol: "MSFT")

返される情報：セクター、業種、正式名称、時価総額、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）、目標株価（low、mean、median、high）、最近の格上げ・格下げ。

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 銘柄を、株価、変動率、時価総額、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 = $1B）
• max_pe_ratio：予想 P/E の上限（例：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（Tencent）、9988.HK（Alibaba）
ETF	SPY, QQQ, VTI, VOO, ARKK
暗号資産	BTC-USD, ETH-USD, SOL-USD
指数	^GSPC（S&P 500）、^IXIC（NASDAQ）、^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. ✅ mcporter の設定に yfinance を追加します（自動検出）
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