Zentickr Yahoo Query Mcp Server

Zentickr — Yahoo Finance MCP サーバー

Zentickr は、yahooquery ライブラリを通じて、価格、ファンダメンタルズ、財務諸表、アナリスト調査、保有状況、イベント、銘柄検索を網羅する 23 個の Yahoo Finance ツールを AI アシスタントから利用できる、stdio ベースの Model Context Protocol（MCP）サーバーです。

⚠️ 重要な免責事項

このソフトウェアは、教育および情報提供のみを目的として提供されています。金融、投資、法律、税務に関する助言を提供するものではありません。市場データには遅延、不備、または不正確さが含まれる場合があります。投資判断はすべてご自身の責任で行ってください。本ソフトウェアの使用に起因する損失や損害について、作者は一切責任を負いません。

クイックスタート

git clone https://github.com/chintan-diwakar/zentickr-yahoo-query-mcp.git
cd zentickr-yahoo-query-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e .

stdio 経由でサーバーを実行します。

zentickr

または：

python -m zentickr

クライアントの設定

Claude Desktop

claude_desktop_config.json に以下を追加します。

{
  "mcpServers": {
    "zentickr": {
      "command": "/absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr"
    }
  }
}

Claude Code

claude mcp add zentickr -- /absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr

Cursor

.cursor/mcp.json を作成または更新します。

{
  "mcpServers": {
    "zentickr": {
      "command": "/absolute/path/to/zentickr-yahoo-query-mcp/.venv/bin/zentickr"
    }
  }
}

実際のユースケース

Apple と Microsoft のファンダメンタルズを比較する

プロンプト：「Apple と Microsoft のファンダメンタルズを比較してください。」

アシスタントは get_financial_data(symbols="AAPL,MSFT") と get_valuation_measures(symbols="AAPL,MSFT") を呼び出せます。

出力例：

Financial Data:
{
  "AAPL": {
    "currentPrice": 333.26,
    "targetHighPrice": 400.0,
    "targetLowPrice": 215.0,
    "targetMeanPrice": 315.78604,
    "recommendationKey": "buy",
    "numberOfAnalystOpinions": 43,
    "totalCash": 68507000832,
    "totalDebt": 84710998016,
    "totalRevenue": 451442016256,
    "earningsGrowth": 0.218,
    "revenueGrowth": 0.166
  }
}

Valuation Measures:
[
  {
    "symbol": "AAPL",
    "asOfDate": "2026-05-28 00:00:00",
    "periodType": "TTM",
    "ForwardPeRatio": 35.3357,
    "MarketCap": 4589945623560.0,
    "PbRatio": 43.101723,
    "PeRatio": 37.83414,
    "PegRatio": 2.7194
  }
]

AAPL の決算に備える

プロンプト：「AAPL の決算に備えてください。」

アシスタントは get_calendar_events(symbols="AAPL") と get_earnings_trend(symbols="AAPL") を呼び出せます。

出力例：

Calendar Events:
{
  "AAPL": {
    "earnings": {
      "earningsDate": [
        "2026-07-31 01:30:S"
      ],
      "earningsAverage": 1.89396,
      "earningsLow": 1.83,
      "earningsHigh": 1.99,
      "revenueAverage": 108890141050
    }
  }
}

Earnings Trend:
{
  "AAPL": {
    "trend": [
      {
        "period": "0q",
        "endDate": "2026-06-30",
        "growth": 0.20629999,
        "earningsEstimate": {
          "avg": 1.89396,
          "numberOfAnalysts": 31,
          "yearAgoEps": 1.57
        }
      }
    ]
  }
}

NVIDIA のティッカーと現在の株価を調べる

プロンプト：「NVIDIA のティッカーと現在の株価を調べてください。」

アシスタントは search_symbols(query="nvidia") を呼び出し、その後 get_price_data(symbols="NVDA") を呼び出せます。

出力例：

Search Results for 'nvidia':
[
  {
    "symbol": "NVDA",
    "name": "NVIDIA Corporation",
    "type": "EQUITY",
    "exchange": "NMS"
  }
]

Price Data:
{
  "NVDA": {
    "preMarketPrice": 202.155,
    "regularMarketPrice": 207.4,
    "regularMarketDayHigh": 211.08,
    "regularMarketDayLow": 205.85,
    "regularMarketVolume": 116253420,
    "regularMarketPreviousClose": 212.5,
    "exchangeName": "NasdaqGS",
    "marketState": "PRE",
    "symbol": "NVDA"
  }
}

ツール一覧

市場データ

ツール	引数	戻り値
get_price_data	symbols: str	現在の価格と取引データ
get_summary_detail	symbols: str	日中の値幅、出来高、配当、52 週の値幅
get_historical_prices	symbols: str, period: str | None = None, start_date: str | None = None, end_date: str | None = None, interval: str = "1d"	過去の OHLCV 価格データ
get_calendar_events	symbols: str	今後の決算日と配当イベント

財務諸表

ツール	引数	戻り値
get_financial_data	symbols: str	目標値、利益率、現金、負債、成長率などの主要な財務データ
get_balance_sheet	symbols: str, frequency: str = "annual"	貸借対照表データ
get_cash_flow	symbols: str, frequency: str = "annual"	キャッシュフロー計算書
get_income_statement	symbols: str, frequency: str = "annual"	損益計算書
get_valuation_measures	symbols: str	時価総額、P/E、EV、株価純資産倍率
get_earnings	symbols: str	決算データ
get_earnings_trend	symbols: str	決算トレンドの予測

分析・調査

ツール	引数	戻り値
get_recommendations	symbols: str	アナリストの推奨
get_recommendation_trend	symbols: str	強い買い、買い、保有、売り、強い売りの件数
get_technical_insights	symbols: str	テクニカル分析の知見
get_esg_scores	symbols: str	環境、社会、ガバナンスのスコア
get_company_profile	symbols: str	企業のセクター、業種、説明、住所

所有権とガバナンス

ツール	引数	戻り値
get_major_holders	symbols: str	主要保有者の内訳
get_institution_ownership	symbols: str	機関投資家の保有状況
get_insider_holders	symbols: str	インサイダーの保有者
get_insider_transactions	symbols: str	インサイダー取引
get_fund_ownership	symbols: str	投資信託およびETFの保有状況
get_company_officers	symbols: str	経営幹部、役職、報酬

検索

ツール	引数	戻り値
search_symbols	query: str	会社名またはティッカーの一部に一致する銘柄シンボル

symbols は、"AAPL,GOOGL,MSFT" のようなカンマ区切りの文字列です。財務諸表の頻度には "annual" または "quarterly" を指定できます。

開発

開発用の依存関係をインストールします。

pip install -e ".[dev]"

オフラインテストスイートとリンターを実行します。

pytest
ruff check .

貢献方法の詳細については、CONTRIBUTING.md をご覧ください。

データソース

データは、非公式の yahooquery ライブラリを通じて Yahoo Finance から取得しています。データは Yahoo の利用規約の対象となります。API キーは不要です。

ライセンス

MIT — LICENSE をご覧ください。

サポート

GitHub Issue を作成してください。