Robinhood Portfolio Research

robinhood-mcp

Robinhood のポートフォリオ調査用の読み取り専用 MCP サーバーです。robin_stocks をラップし、AI アシスタントが分析のためにポートフォリオデータへアクセスできるようにします。

⚠️ 調査専用ツール - このサーバーは読み取り専用アクセスを提供します。取引機能は公開していません。

⚠️ 非公式 API - robin_stocks の非公式 API を使用しています。予告なく動作しなくなる可能性があります。自己責任でご利用ください。

デモ

シミュレーションによる製品デモを見る

このデモでは、シミュレーションされたアカウントデータと汎用のアシスタントインターフェースを使用しています。読み取り専用の調査ワークフローのみを紹介しており、実際の認証情報、保有銘柄、専門的な助言、取引の実行は示していません。

何ができますか？

接続すると、Claude とポートフォリオについて自然な会話ができます。

ポートフォリオの健全性チェック

「ポートフォリオの健全性をチェックしてください。合計評価額、セクターの集中度、大幅に上昇または下落しているポジションを教えてください。」

Claude が保有ポジションを取得し、セクター別のエクスポージャーを計算して、最も成績の良い銘柄と悪い銘柄を特定し、集中リスクを知らせます。

購入前の調査

「NVDA の保有数を増やそうと考えています。ファンダメンタルズ、最近のニュース、アナリストの評価、過去 1 年間の値動きを見せてください。」

価格履歴、PER、決算日、アナリストのセンチメントを組み合わせた包括的な調査結果を、1 つの回答で得られます。

投資先の比較

「ポートフォリオにあるクルーズ会社を比較してください。CCL、RCL、NCLH の PER、時価総額、年初来のパフォーマンスを並べて表示してください。」

類似する保有銘柄をすばやく評価し、相対的な割安度を特定できます。

配当分析

「今年受け取った配当はいくらですか？保有銘柄のうち、配当を支払っているものとその利回りを教えてください。」

不労所得を追跡し、ポートフォリオ内の配当機会を特定できます。

リスク評価

「エネルギーセクターへのエクスポージャーはどのくらいですか？上位 5 銘柄への集中度はどの程度ですか？」

セクターの集中度を分析し、比率が過大な可能性のあるポジションを特定できます。

決算カレンダー

「保有銘柄のうち、今後 2 週間以内に決算発表があるものはどれですか？」

パーソナライズされたカレンダーで、決算発表に伴う値動きに備えられます。

パフォーマンスの要因分析

「ポートフォリオのリターンを分解してください。利益と損失の主な要因は何ですか？」

どのポジションがパフォーマンスに最も貢献しているかを把握できます。

取引履歴

「HIMS の注文履歴を見せてください。すべての買い注文と売り注文を、価格と日付とともに表示してください。」

約定ごとの詳細を確認できるため、取得原価や税金の調査に役立ちます。

ウォッチリストの調査

「ウォッチリストにあるすべての銘柄の株価とファンダメンタルズを取得してください。今、注目すべき銘柄はどれですか？」

追跡中の銘柄をまとめて調査できます。

インストール

pip install robinhood-mcp

または、uvx で直接実行します。

uvx robinhood-mcp

設定

環境変数

export ROBINHOOD_USERNAME="your_email"
export ROBINHOOD_PASSWORD="your_password"
export ROBINHOOD_TOTP_SECRET="your_2fa_secret"          # if your account exposes TOTP (see below)
export ROBINHOOD_APPROVAL_TIMEOUT="60"                  # optional — seconds to wait for push approval

Claude Desktop やその他のヘッドレスデプロイでは、次の2つの方法があります。

1. アカウントで利用できる場合はTOTPを使用します。 ROBINHOOD_TOTP_SECRET に、base32形式の認証アプリ用シークレット（Robinhoodモバイルアプリまたはrobinhood.comの Account → Security → Two-Factor Authentication で確認できます）を設定します。ログインは高速で、対話操作が不要なうえ、再起動後も利用できます。
2. それ以外の場合はプッシュ承認を使用します。 ROBINHOOD_TOTP_SECRET は設定しないでください。再起動後の最初のツール呼び出しで、Robinhoodモバイルアプリにプッシュ通知が届きます。ROBINHOOD_APPROVAL_TIMEOUT 秒以内（デフォルトは60秒）に「Approve」をタップしてください。この承認を一度行うと、セッションは ~/.tokens/robinhood.pickle にキャッシュされ、数日から数週間再利用されます。自然に期限切れになるまでは、それ以上の操作は不要です。

パスキーまたは生体認証を主な2FAとして使用する新しいRobinhoodアカウントでは、iOSアプリでもウェブ設定でもTOTPの選択肢が表示されない場合があります。このようなアカウントでも、プッシュ承認は問題なく機能します。

認証に失敗すると、サーバーはエラーを約5分間キャッシュします。そのため、完全なログインフローを再試行してMCP サーバーが再びブロックされることなく、後続のツール呼び出しはすぐに失敗します。より早く再試行するには、Claude Desktopを再起動してください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "robinhood": {
      "command": "uvx",
      "args": ["robinhood-mcp"],
      "env": {
        "ROBINHOOD_USERNAME": "your_email",
        "ROBINHOOD_PASSWORD": "your_password"
      }
    }
  }
}

アカウントでTOTP登録が利用できる場合は、上記の env ブロックに "ROBINHOOD_TOTP_SECRET": "your_2fa_secret" を追加してください。

Claude Code

claude mcp add robinhood -- uvx robinhood-mcp

利用可能なツール

ツール	説明
robinhood_get_accounts	利用可能なRobinhoodアカウントの口座番号
robinhood_get_portfolio	ポートフォリオの価値、株式価値、購買余力、当日の変動
robinhood_get_positions	取得原価、現在価値、損益を含むすべての保有銘柄
robinhood_get_position	ティッカー、数量、価値、損益を指定した1つの保有銘柄
robinhood_get_watchlist	ウォッチリストに登録されている株式
robinhood_get_quote	リアルタイム価格、買値／売値、出来高
robinhood_get_fundamentals	株価収益率、時価総額、配当利回り、52週間の値幅
robinhood_get_historicals	OHLCV価格履歴（日／週／月／年）
robinhood_get_news	銘柄に関する最近のニュース記事
robinhood_get_earnings	決算日、EPS予想、実績
robinhood_get_ratings	アナリストによる買い／保有／売りの評価
robinhood_get_dividends	配当金の支払い履歴
robinhood_get_options_positions	現在のオプション保有状況
robinhood_get_order_history	注文履歴（買い／売り）と約定ごとの詳細
robinhood_search_symbols	名前またはティッカーで株式を検索

口座の選択

Robinhoodへのログインで複数の口座を利用できる場合は、最初に robinhood_get_accounts を呼び出し、返された account_number を口座単位のツールに渡してください。account_number を省略すると、Robinhoodのデフォルト口座が使用されます。

account_number を任意で指定できるツール：

• robinhood_get_portfolio
• robinhood_get_positions
• robinhood_get_position
• robinhood_get_dividends
• robinhood_get_options_positions
• robinhood_get_order_history

会話例

簡単な質問：

• 「現在、ポートフォリオの価値はいくらですか？」
• 「評価額上位5銘柄を表示してください」
• 「HIMSをすでに保有していますか？現在の保有状況も教えてください」
• 「Robinhoodの口座を一覧表示してから、IRA口座の保有銘柄を表示してください」
• 「AAPLの株価を取得してください」

単一銘柄のポートフォリオに関する質問では、robinhood_get_positions ではなく robinhood_get_position を優先してください。単一銘柄用のツールなら、すべての 保有銘柄を再構築する必要がなく、「HIMSをさらに買い増すべきですか？」といった質問に はるかに速く回答できます。

分析の依頼：

• 「GOOGLとMETAのファンダメンタルズを比較してください」
• 「保有している銘柄のうち、52週間平均を下回る価格で取引されているものはどれですか？」
• 「過去1年間のTSLAの価格チャートを表示してください」
• 「最もパフォーマンスの良い銘柄はどれですか？最も悪い銘柄はどれですか？」

リサーチのワークフロー：

• 「クルーズ業界について知りたいです。CCL、RCL、NCLHのデータを取得して、ファンダメンタルズと最近のパフォーマンスを比較してください。」
• 「ポートフォリオから、P/Eが15未満で、利益成長率がプラスの銘柄を探してください」
• 「いくつかのポジションで大きな損失が出ています。最悪のパフォーマンスの銘柄について、保有を続けるか損切りするか判断できるよう、ファンダメンタルズとニュースを表示してください。」

制限事項

• 読み取り専用：取引の発注、ウォッチリストの変更、口座設定の変更はできません
• 非公式 API：Robinhood はいつでも API を変更する可能性があり、機能が動作しなくなることがあります
• リアルタイムストリーミングなし：株価は特定時点のものであり、ライブ配信ではありません
• セッションの有効期限：定期的に再認証が必要になる場合があります
• レート制限：頻繁に使用すると、Robinhood のレート制限が適用される場合があります

セキュリティに関する注意事項

• 認証情報は Robinhood への認証のためにローカルでのみ使用されます
• セッショントークンは robin_stocks によって ~/.tokens/robinhood.pickle にキャッシュされます
• .env ファイルをコミットしたり、認証情報を公開したりしないでください
• このツールは取引を実行できません。設計上、読み取り専用です

開発

git clone https://github.com/verygoodplugins/robinhood-mcp.git
cd robinhood-mcp
pip install -e ".[dev]"

# Lint
ruff check . && ruff format --check .

# Test
pytest

# Run locally
robinhood-mcp

トラブルシューティング

「Not logged in」エラー：

• ユーザー名とパスワードが正しいことを確認してください
• 認証アプリを使った2FAを設定している場合は、ROBINHOOD_TOTP_SECRET が必要です
• Robinhood アプリでログインし、アカウントがロックされていないことを確認してください
• ツールの呼び出しが短時間停止した後、「Login returned empty result」で失敗する場合： キャッシュされたセッションがなく、ROBINHOOD_TOTP_SECRET も設定されていないため、Robinhood のモバイルアプリでプッシュ通知を承認するのをサーバーが待っています。ROBINHOOD_APPROVAL_TIMEOUT 秒以内（デフォルトは60秒）に「Approve」をタップしてから、ツールを再度呼び出してください。セッションの pickle がキャッシュされ、以降の呼び出しでは確認を求められません。アカウントでTOTPが利用できる場合は、ROBINHOOD_TOTP_SECRET を追加すると確認を完全に省略できます。失敗後、サーバーはエラーを約5分間キャッシュします。より早く再試行するには、Claude Desktop を再起動してください。

「Non-base32 digit found」エラー：

• TOTP シークレットに無効な文字が含まれています
• シークレットには A～Z の英字と2～7の数字のみを使用してください
• 認証アプリを使っていない場合は、ROBINHOOD_TOTP_SECRET を完全に削除してください

レート制限：

• robin_stocks にはレート制限機能が組み込まれていません
• レート制限に達した場合は、数分待ってから再試行してください

ライセンス

MIT

免責事項

このツールは教育およびリサーチのみを目的としています。いつでも動作しなくなる可能性のある非公式 API を使用しています。アカウントの制限、データの不正確さ、または金銭的損失について、作者は一切責任を負いません。

このプロジェクトは Robinhood Markets, Inc. と提携、承認、または関係していません。

自動化の例

Claude Code で毎日のポートフォリオを確認する

毎日のポートフォリオ概要を取得する cron ジョブを設定します。

# ~/.claude/commands/portfolio-review.md
---
description: "Daily portfolio health check"
---
Using the robinhood MCP tools:
1. Get my current portfolio value and day change
2. Identify my top 3 gainers and top 3 losers today
3. Flag any positions that are down more than 20% from cost basis
4. Check if any holdings have earnings in the next 7 days
5. Give me a 2-3 sentence summary I can read with my morning coffee

毎日実行します。

# Add to crontab -e
0 7 * * 1-5 cd ~/Projects && claude -p "/portfolio-review" --dangerously-skip-permissions >> ~/portfolio-reports/$(date +\%Y-\%m-\%d).md

毎週のリサーチダイジェスト

# ~/.claude/commands/weekly-research.md
---
description: "Weekly deep dive on portfolio"
---
For each of my top 10 holdings by value:
1. Pull current fundamentals and compare to sector averages
2. Get recent news and analyst rating changes
3. Flag any significant changes from last week
4. Identify 2-3 stocks from my watchlist that might be worth adding

Format as a markdown report I can review on the weekend.

クレジット

Very Good Plugins の Jack Arturo が🧡を込めて作成しました。

robin_stocks と FastMCP を利用しています。

Links

• GitHub
• PyPI
• Very Good Plugins
• AutoMem - AI memory infrastructure
• robin_stocks Documentation
• Model Context Protocol