Finnhub

Finnhub — 株式、暗号資産、外国為替データ

Finnhub の REST API です。リアルタイムの株価、ファンダメンタルズ、決算、ニュース、オルタナティブデータ（インサイダー取引、センチメント、ETF 保有銘柄）、経済データ、暗号資産、外国為替を提供します。充実した無料プランを備えた包括的な市場データです。

Pipeworx の一部です。AI エージェントを 1879 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認や公開も受けていません。

AI エージェントにとって重要な理由

Alpha Vantage がファンダメンタルズとテクニカル分析に強い一方、Finnhub はリアルタイムの株価（無料プランでは1分間隔）、インサイダー取引、ニュース／センチメント、国際市場に強みがあります。株価データに加えてニュースの流れやインサイダー取引の状況も必要とする金融エージェントに適しています。

よくある利用例：

• 株価。 リアルタイム（無料プランでは15分遅延）の株価です。
• 企業ニュース。 ティッカーの最近のニュースとセンチメントスコアです。
• インサイダー取引。 タイミングと金額を含む Form 4 提出書類です（SEC EDGAR から直接取得する insider-trading パックも参照してください）。
• 決算。 今後の決算カレンダー、サプライズの履歴、EPS 予測です。
• 国際銘柄。 欧州、アジア、新興市場のティッカーに対応しています（Alpha Vantage のカバレッジが手薄な分野です）。

認証

https://finnhub.io/dashboard から無料キーを取得できます。無料プランでは1分あたり60回の API 呼び出しが可能です。_apiKey 経由で渡します。

上位プラン（月額50～200ドル）では、リアルタイムデータ、より長期の履歴、実運用に適したレート制限が利用できます。ほとんどのエージェントによるリサーチには無料プランで十分です。

Finnhub と Alpha Vantage の使い分け

必要なデータ	適したソース
株価	どちらも適しています。無料プランでは Finnhub のほうがリアルタイム性に優れます
損益計算書／貸借対照表	Alpha Vantage（スキーマがより整理されています）
インサイダー取引	Finnhub または insider-trading パック
センチメント付き企業ニュース	Finnhub
決算カレンダー	Finnhub
国際市場のカバレッジ	Finnhub
テクニカル指標	Alpha Vantage
ETF 保有銘柄	Finnhub

最も充実したカバレッジを得るため、Pipeworx のエージェントは両方を組み込むことがよくあります。

決算サプライズと決算カレンダー

決算に関する異なる質問に答えるツールが2つあります。選択を誤ると、データを気付かないまま見落とします。

• 「前四半期の実績は、アナリスト予想と比べてどうでしたか？」 → get_earnings_surprises({ symbol }) を使います。日付範囲ではなく銘柄をキーにするため、四半期からどれほど時間が経っていても、その企業の過去の決算履歴をさかのぼって取得できます。各四半期について、EPS 実績、EPS 予想、サプライズ額、サプライズ率を返します（新しい順）。EPS のみです。Finnhub の決算サプライズ履歴には売上高が含まれず、ツールは何も返さずに null とするのではなく、そのことを明示します。
• 「決算発表が予定されているのはいつですか、またはここ数週間に何がありましたか？」 → get_earnings_calendar({ symbol, from, to }) を使います。日付範囲を指定でき、EPS に加えて売上高の予想／実績も含まれます。ただし、2026-10-21 時点の実測では、このプランのカレンダーがさかのぼれる過去の期間は短く、今日から直近数週間ほどで、企業の決算履歴全体には及びません。それより古い四半期は、実際にはその企業が決算を発表していても found: false を返します。対象期間が切り詰められていると知らなければ、「決算なし」と読み取ってしまいます。数週間より古いデータには、代わりに get_earnings_surprises を使ってください。

よくある落とし穴

• シンボルの表記規則。 米国のティッカーはシンプルです（AAPL）。海外市場では取引所のサフィックスが必要です（スイス取引所に上場するNestléの場合はNESN.SW）。Finnhubにはシンボル検索機能があります。
• 無料プランのリアルタイム遅延。 無料プランの「リアルタイム」は実質的に現在の情報ですが、有料プランでは実際のライブデータです。エージェントによる調査なら無料プランで十分です。取引には有料プランが適しています。
• ニュースのセンチメントはヒューリスティックです。 FinnhubはNLPを使ってセンチメントを算出します。傾向を把握するには役立ちますが、ノイズも含まれます。絶対的な真実として扱わず、シグナルとして活用してください。
• インサイダー取引データの遅延。 SECでは、取引から2営業日以内にForm 4を提出することが義務付けられています。Finnhubにはその後まもなく反映されます。リアルタイムのアラートには、ポーリングか別のリアルタイムSECフィードが必要です。
• 予想と実績。 Finnhubはアナリストのコンセンサス予想を提供します。グラフで実績と混在させる場合は、慎重にラベル付けする必要があります。
• 無料プランのカバレッジの穴。 小型株やOTC銘柄の一部は、無料プランではFinnhubのカバレッジが限られています。対象のティッカーを中心にフローを設計する前に、データが存在することを確認してください。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します：

{
  "mcpServers": {
    "finnhub": {
      "url": "https://gateway.pipeworx.io/finnhub/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/finnhub/mcp の tools/list は、上の表に記載されたツールに加え、Pipeworx 共通のメタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）を返します。そのため、表示されるツール数はこの表の数より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて共通ツールがおよそ30個表示されます。接続の initialize レスポンスには正確な範囲が示され、その日の状況を確認するうえで最も信頼できる情報です。

これは意図的なものであり、偶然の多重化ではありません。メタツールを使えば、このパックで扱っていない質問にも、ask_pipeworx を通じてカタログ全体から回答できます。MCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

また、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接表示されます：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1879以上のデータソースに接続します。唯一の違いは、どのパックのツールが直接表示されるかです。ask_pipeworx を使えば、どちらからでもすべてのツールを利用できます。

MCP クライアントがない場合：HTTP で呼び出す

finnhub キーは有料アカウント用に確保されています。そのため、匿名で POST https://gateway.pipeworx.io/v1/tools/get_quote を呼び出すには、引数とともに _apiKey として独自のキーを渡す必要があります。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/get_quote を呼び出します。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへの往復通信も必要ありません：

{
  "mcpServers": {
    "finnhub": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-finnhub"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-finnhub

stdin/stdout 経由で MCP を使用し、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用方法

ツールを直接呼び出す代わりに、自然な英語で質問できます。上記のパックエンドポイントでもフルゲートウェイでも利用できます：

ask_pipeworx({ question: "your question about Finnhub data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT