claude yahoo finance apiは公式?MCP接続の手順と限界
「Claudeに株価を聞きたいが、Yahoo Finance APIは公式なのか」「APIキーなしでつなげられるのか」と迷っていませんか。この記事では、検索で見かけるYahoo Finance連携の正体を整理し、Claude CodeやClaude Desktopから市場データを参照する方法、導入前に確認したい安全面をまとめます。
Yahoo FinanceをClaudeで使う近道は、公式APIと決めつけず、yfinanceを使うMCPサーバーをClaude Codeへ接続する方法です。取得範囲と注意点を確認すれば、株価・履歴・財務情報を調査に活用できるとわかる。
Contents (11)
claude yahoo finance apiで検索する人が知りたいこと
このキーワードで調べる人の多くは、Claudeに「AAPLの現在値」「過去1年の値動き」「決算や配当」を尋ね、会話時点の市場データを取得したいと考えています。
ただし「API」は、Pythonライブラリ、MCP(Model Context Protocol)サーバー、YahooのWeb画面が使うエンドポイントをまとめた呼び方です。MCPはAIクライアントと外部データをつなぐオープンなプロトコルで、公式説明は https://docs.anthropic.com/en/docs/mcp にあります。方式を分けて考えると、導入方法とリスクが見えやすくなります。
Yahoo Finance APIは公式なのか
結論からいうと、Yahoo Finance連携を「公式API」として扱うのは危険です。検索上位の yahoo-finance-mcp-server は、Yahooが公式の公開Finance APIを以前に終了したと説明し、yfinanceからYahooの内部エンドポイントを利用する非公式な方式だと明記しています。
同じく emmanuelay/yahoo-finance-mcp も、Yahoo社による提携・承認済みではないと注意書きを置いています。APIキーを発行して長期安定利用する公式サービスとは性質が異なるため、エンドポイント変更やアクセス制限を前提に小さく試してください。
確認すべき点は次のとおりです。
- 公式契約APIなのか、Web向けの内部エンドポイントなのかを確認する。
- 取得時刻、遅延、欠損、通貨、取引所を回答に添えるようClaudeへ指示する。
- 投資判断の根拠にせず、公式開示資料や証券会社の情報で照合する。
- 利用規約と再配布条件を読み、商用組み込みは法務・提供元へ確認する。
ClaudeとYahoo Financeをつなぐ3つの方法
1. MCPサーバーを使う
Claude CodeやClaude Desktopから使うなら、専用MCPサーバーが分かりやすい方法です。株価、チャート、財務諸表、ニュースなどをClaude側のツールとして呼び出せます。
2. Pythonのyfinanceを使う
yfinanceで必要な項目だけをJSONやCSVへ整形し、MCPや社内ツールから渡します。取得条件を固定できる一方、Python環境・キャッシュ・エラー処理を自分で保守します。
3. 内部エンドポイントを直接呼ぶ
Cookieやcrumb、レート制限、レスポンス変更への対応が必要です。一時調査なら、直接接続を自作するより、コードと更新履歴を確認できるMCP実装のほうが管理しやすいでしょう。
Claude CodeにYahoo Finance MCPを追加する手順
ここではローカルMCPを例にします。実行コマンドや対応ツールはリポジトリごとに違うため、READMEを確認してください。
-
Python 3.10以上など、選んだリポジトリの前提環境を用意する。
-
リポジトリを取得し、仮想環境と依存関係を用意する。
git clone https://github.com/christianGRogers/yahoo-finance-mcp-server.git cd yahoo-finance-mcp-server python -m venv .venv # macOS / Linux source .venv/bin/activate # Windowsは .venv\Scripts\activate を実行 pip install -e . -
Claude Codeへ、サーバーのPythonとモジュールを指定して登録する。
claude mcp add yahoo-finance -- /absolute/path/to/.venv/bin/python -m yahoo_finance_mcpWindowsでは、
/absolute/path/to/.venv/bin/pythonを実際の.venv\Scripts\python.exeのパスに置き換えます。 -
claude mcp listとセッション内の/mcpで接続状態・ツール・権限を確認し、「AAPLの現在値を取得し、時刻と通貨を表示して」のようにテストする。
別実装では、ビルド後にclaude mcp add yahoo-finance -- yahoo-finance-mcpと登録する方式もあります。具体例は https://github.com/emmanuelay/yahoo-finance-mcp のREADMEを確認し、実行ファイルがPATHにない場合は絶対パスを指定してください。
Claude DesktopとRemote MCPで使う場合
Claude Desktopでは設定ファイルのmcpServersへ実行コマンドを登録します。PATHが通った実行ファイルなら次の形です。
{
"mcpServers": {
"yahoo-finance": {
"command": "yahoo-finance-mcp"
}
}
}
- READMEで実行コマンドと必要な環境変数を確認する。
- 設定ファイルへ定義を追加し、Claude Desktopを再起動する。
- 接続済みツールを確認し、APIキーや個人情報をプロンプトへ貼らずに試す。
Remote MCPならHTTPSのURLで登録できます。MCP.soのYahoo Finance掲載ページには、Claude Code向けにclaude mcp add yahoo-finance --transport http https://gateway.mcpservers.org/yahoo-finance/mcpという例があります。ただしYahoo公式の案内ではありません。運営者、データの流れ、認証、ログ保存、利用規約を確認できない接続先は避けてください。
取得できるデータとプロンプトの書き方
実装によって差はありますが、次の用途に使えます。
- 現在値、前日比、出来高、52週高値・安値
- 指定期間のOHLCV履歴と複数銘柄の比較
- 財務諸表、配当、株式分割、決算予定、ニュース
- ティッカー検索、セクター・業種、指数や暗号資産
質問には銘柄、期間、単位、取得時刻を含めます。
AAPLについて、直近1か月の日次終値と出来高を取得してください。
取得時刻、通貨、データの対象期間、欠損の有無を明記し、投資判断ではなく事実の整理として説明してください。
比較は同じ期間・通貨、決算は年度か四半期かを指定します。要約だけでなく、銘柄コードと取得日時も残すと再確認しやすくなります。
うまく動かないときの確認ポイント
接続できない場合は、次の順番で切り分けます。
claude mcp listで登録状態と起動エラーを確認する。- Pythonのバージョン、仮想環境のパス、実行権限を確認する。
AAPL、MSFT、BTC-USDなど正しいシンボル形式を試す。- レート制限を避け、期間を短くした日次データから再試行する。
エラーをClaudeに渡すときも、APIキーやCookieは貼らないでください。ホスト名・HTTPステータス・発生時刻だけで原因を推測できる場合があります。
claude yahoo finance apiを安全に使うための結論
Yahoo FinanceをClaudeへ接続する方法はありますが、「Yahoo公式APIをClaudeが直接使う」と理解するのは適切ではありません。yfinanceなどを使うMCPサーバーを選び、公開元、更新状況、取得時刻、利用条件を確認して使います。
検索上位の実装は、ローカルPython型、実行ファイル型、HTTPSでつなぐRemote型に分かれます。個人の調査ならローカルMCP、チーム利用ならバージョン固定とログ設計、Web利用なら運営者確認から始めます。重要な判断では一次資料と突き合わせてください。
出典URL: