yfinance-ai: Yahoo Finance

yfinance-ai MCP サーバー

世界初のAI搭載Yahoo Finance連携機能です。株式、ETF、投資信託、暗号資産、外国為替、コモディティに対応する68個のツールを、1つのPythonファイルで提供します。

🚀 ClawHubとOpenWebUIで数千回ダウンロードされています

価格と履歴、財務諸表、比率とバリュエーションの履歴、アナリスト予測と目標株価、決算、配当、オプション、保有者とインサイダー、ファンドとETF、市場の値上がり・値下がり銘柄、セクターと業種、決算、IPO、経済指標、株式分割のカレンダーに対応します。

使用先	インストール	リポジトリ
Claude、Cursor、VS Code、LangChain、Google ADK、Strands AgentsなどのMCPクライアント	uvx yfinance-ai@latest	yfinance-ai-mcp
OpenClaw向けClawHubスキル 🚀 数千回ダウンロードされています	openclaw skills install @lkcair/stocks	yfinance-ai-skill
OpenWebUIツール 🚀 数千回ダウンロードされています	openwebui.comで入手	yfinance-ai
Python	from yfinance_ai import Tools	yfinance-ai

インストール

uvが必要です。APIキーは不要です。

Claude Code：

claude mcp add yfinance-ai -- uvx yfinance-ai@latest

VS Code：

code --add-mcp '{"name":"yfinance-ai","type":"stdio","command":"uvx","args":["yfinance-ai@latest"]}'

Claude Desktop、Cursor、Windsurfなどのクライアントでは、クライアントのMCP設定ファイルに記述します：

{
  "mcpServers": {
    "yfinance-ai": {
      "command": "uvx",
      "args": [
        "yfinance-ai@latest"
      ]
    }
  }
}

@latestを使うと、クライアントの起動時に新しいリリースが取得されます。uvを使わない場合は、pip install yfinance-aiを実行し、引数なしで"command": "yfinance-ai"を指定してください。

MCP Registryにはio.github.lkcair/yfinance-aiとして登録されています。すべてのツールは読み取り専用です。

エージェントフレームワーク

このサーバーはuvx yfinance-ai@latestを使ってstdio経由で動作するため、MCPに対応する任意のフレームワークから、すべてのツールを読み込めます。

LangChain：pip install "langchain[mcp]" langchain-anthropic

import asyncio
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

async def main():
    config = {"mcpServers": {"yfinance-ai": {
        "command": "uvx", "args": ["yfinance-ai@latest"],
    }}}
    async with MCPAdapter(config) as adapter:
        tools = await adapter.list_tools()
        agent = create_agent("claude-sonnet-5", tools)
        result = await agent.ainvoke({"messages": [{"role": "user", "content": "What is Apple's P/E, and how does it compare with Microsoft and Google?"}]})
        print(result["messages"][-1].content)

asyncio.run(main())

Google ADK：pip install "google-adk[mcp]"

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = LlmAgent(
    model="gemini-flash-latest",
    name="yfinance_ai",
    instruction="Answer with the yfinance-ai tools.",
    tools=[McpToolset(connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(command="uvx", args=["yfinance-ai@latest"]),
        timeout=60,
    ))],
)

Strands Agents：pip install strands-agents

from mcp import stdio_client, StdioServerParameters
from strands import Agent
from strands.tools.mcp import MCPClient

yfinance_ai = MCPClient(lambda: stdio_client(StdioServerParameters(
    command="uvx", args=["yfinance-ai@latest"],
)))
agent = Agent(tools=[yfinance_ai])
agent("What is Apple's P/E, and how does it compare with Microsoft and Google?")

質問例

• AppleのP/Eはいくつですか？MicrosoftやGoogleと比べてどうですか？
• NVIDIAについてアナリストはどのような見解を示していますか？目標株価と最近の格上げについて教えてください。
• 今週、決算を発表するのはどの企業ですか？
• 今日のビットコイン価格、EUR/USDレート、金価格を教えてください。

MCPツール（68個）

株価と履歴

ツール	パラメーター	説明
get_stock_price	ticker	ティッカーシンボルの現在の株価と主要指標を取得します
get_stock_quote	ticker	買値・売値、日中の値幅、取引情報を含む詳細な株価情報を取得します
get_fast_info	ticker	ティッカーの情報をすばやく取得します（軽量で応答が速い）
get_historical_data	ticker, period="1y", interval="1d"	株式の過去の価格データを取得します
get_historical_price_on_date	ticker, date	指定日の過去の価格を取得します
download_multiple_tickers	tickers, period="1mo", interval="1d"	複数のティッカーの過去データを一度に取得します

企業

ツール	パラメーター	説明
get_company_info	ticker	企業の詳細情報と事業内容の説明を取得します
get_company_overview	ticker	各指標の背景情報を含む企業の概要を取得します
get_company_officers	ticker	企業の役員と主要な経営陣を取得します
get_isin	ticker	ティッカーの国際証券識別番号（ISIN）を取得します

財務情報

ツール	パラメーター	説明
get_income_statement	ticker, period="annual"	損益計算書データを取得します
get_balance_sheet	ticker, period="annual"	貸借対照表データを取得します
get_cash_flow	ticker, period="annual"	キャッシュフロー計算書データを取得します
get_ttm_financials	ticker	過去12か月（TTM）の損益計算書とキャッシュフローを取得します
get_key_ratios	ticker	主要な財務比率とバリュエーション指標を取得します
get_valuation_history	ticker	現在および直近の四半期のバリュエーション指標（時価総額、EV、P/E、PEG、P/S、P/B、EV/EBITDA）を取得します
get_financial_summary	ticker	銘柄の包括的な財務サマリーを1ページで取得します
get_shares_history	ticker, years=3	発行済み株式数の推移（希薄化または自社株買い）を取得します

決算と予想

ツール	パラメーター	説明
get_earnings_dates	ticker	予想を含む、今後および過去の決算発表日を取得します
get_earnings_history	ticker	年次および四半期の数値を含む、過去の決算データを取得します
get_earnings_calendar	ticker	次回の決算発表日と配当日を含む決算カレンダーを取得します
get_analyst_estimates	ticker	決算、売上高、EPSに関するアナリスト予想を取得します
get_growth_estimates	ticker	アナリストの成長予想を取得します
get_eps_trend	ticker	予想の変化を示すEPS（1株当たり利益）の推移データを取得します
get_eps_revisions	ticker	アナリスト予想の変更を示すEPS修正データを取得します

アナリスト

ツール	パラメーター	説明
get_analyst_recommendations	ticker	アナリストの推奨と評価を取得します
get_analyst_price_targets	ticker	銘柄の詳細なアナリスト目標株価を取得します
get_upgrades_downgrades	ticker, limit=20	アナリストによる格上げ・格下げの詳細な履歴を取得します

保有者とインサイダー

ツール	パラメーター	説明
get_institutional_holders	ticker	主要な機関投資家の保有者とその保有状況を取得します
get_major_holders	ticker	主要保有者の概要（機関投資家、インサイダー、浮動株）を取得します
get_mutualfund_holders	ticker	投資信託の保有者を取得します
get_insider_transactions	ticker	最近のインサイダー取引状況を取得します
get_insider_purchases	ticker	インサイダーによる購入のみを取得します（買いに絞り込み）
get_insider_roster_holders	ticker	インサイダー一覧（会社のインサイダーのリスト）を取得します

配当とコーポレートアクション

ツール	パラメーター	説明
get_dividends	ticker, period="5y"	配当の支払い履歴と現在の指標を取得します
get_stock_splits	ticker	株式分割の履歴を取得します
get_corporate_actions	ticker	すべてのコーポレートアクション（配当と株式分割を統合）を取得します
get_capital_gains	ticker	キャピタルゲインの分配（主にファンド／ETF）を取得します

オプション

ツール	パラメーター	説明
get_options_chain	ticker, expiration=""	オプションチェーンのデータ（コールとプット）を取得します
get_options_expirations	ticker	利用可能なすべてのオプション満期日を取得します

市場全体

ツール	パラメーター	説明
get_market_status		米国株式市場が現在開いているか確認します
get_market_summary	region="US"	地域の市場概要を取得します。開場・閉場状況に加え、主要指数、先物、債券、為替を確認できます
get_market_indices		主要な市場指数の現在価格を取得します
get_market_movers	category="day_gainers", count=10	Yahoo Finance のスクリーナーから、本日の市場で値動きの大きい銘柄を取得します
get_trending_tickers	count=10	本日の米国で最も取引が活発な（トレンドの）ティッカーを取得します
get_sector_performance		主要な市場セクターのパフォーマンスを取得します
get_sector_overview	sector="technology"	セクターの概要を取得します。規模、構成比、最大手企業、業種、セクター ETF を確認できます
get_industry_overview	industry="semiconductors"	業種の概要を取得します。最大手企業、パフォーマンス上位企業、成長が最も速い企業を確認できます

カレンダー

ツール	パラメーター	説明
get_upcoming_earnings	days=7, limit=25	市場全体の決算カレンダーを取得します（今後 N 日以内に決算を発表する企業）
get_ipo_calendar	days=14, limit=25	今後の IPO を取得します（取引所、予定日、価格帯、株式数）
get_economic_calendar	days=7, limit=30	今後の経済イベント（CPI、雇用、GDP、金利決定）を、予想値および前回値とともに取得します
get_splits_calendar	days=14, limit=25	今後の株式分割を取得します

ファンドと ETF

ツール	パラメーター	説明
get_fund_overview	ticker	ETF またはミューチュアルファンドの概要データを取得します
get_fund_holdings	ticker, limit=25	ETF またはミューチュアルファンドの上位保有銘柄を取得します
get_fund_sector_weights	ticker	ETF またはミューチュアルファンドのセクター配分・構成比を取得します

暗号資産、外国為替、コモディティ

ツール	パラメーター	説明
get_crypto_price	symbol	暗号資産の価格と市場データを取得します
get_forex_rate	pair	通貨ペアの外国為替レートを取得します
get_commodity_price	commodity	コモディティ・先物の価格データを取得します

比較

ツール	パラメーター	説明
compare_stocks	tickers	複数の株式の主要指標を比較します
get_peer_comparison	ticker, peers=null	株式を同業他社と主要指標で比較します
get_historical_comparison	tickers, period="1y"	複数の株式の過去の価格パフォーマンスを比較します
get_complete_analysis	ticker, peers=""	関連するすべてのツールを呼び出して、株式を包括的に分析します

ニュースと提出書類

ツール	パラメーター	説明
get_stock_news	ticker, limit=10	株式に関する最近のニュース記事を取得します
get_sec_filings	ticker	最近の SEC 提出書類（10-K、10-Q、8-K など）を取得します

ユーティリティ

ツール	パラメーター	説明
search_ticker	query	企業名またはキーワードからティッカーシンボルを検索します
validate_ticker	ticker	ティッカーシンボルが存在し、取引可能かどうかを検証します
get_api_status		API のステータスと使用状況を取得します
run_self_test	ticker="SPY"	yfinance-ai ツールの包括的なセルフテストを実行します（64 項目）

ライセンス

MIT。データは yfinance を通じて Yahoo Finance から取得しており、遅延する場合があります。Yahoo とは提携していません。調査および教育目的であり、投資助言ではありません。