IBI Portfolio (Israel)

ibi-portfolio-mcp

IBI（Israel Brokerage & Investments、אי.בי.אי）向けの読み取り専用 MCP サーバーです。 Claude、ChatGPT、Cursor などの AI アプリから IBI のポートフォリオ（保有銘柄、現金、損益、最近の口座取引）を確認できるため、「ポートフォリオの調子はどうですか？」といった質問ができます。買付、売却、送金はできません。 Mac と Windows で動作します。

🇮🇱 שרת MCP לקריאה בלבד עבור חשבון המסחר שלך באי.בי.אי (IBI NextGen). הוא נותן ל-Claude, ל-ChatGPT או לכל עוזר AI אחר לראות את תיק ההשקעות שלך: אחזקות, מזומן, רווח והפסד ופעולות אחרונות. הוא לא יכול לבצע פקודות קנייה או מכירה. הסיסמה נשמרת רק במחשב שלך ולא מגיעה למודל. עובד על Mac ועל Windows.

非公式ツールです。IBI との提携関係はなく、IBI による推奨も受けていません。

架空の数値を使ったデモです。回答は Claude による実際の返答です。

セキュリティ対策

IBI のログイン情報は資産への完全なアクセス権を与えるため、ここが最も重要な部分です。

パスワード

• 🔒 パスワードは、お使いのコンピューターのセキュアな保管庫にのみ保存されます。Mac では Keychain、Windows では Credential Manager を使用します。どちらもオペレーティングシステムによって暗号化されます。ファイルには保存されません。
• 🔒 パスワードを入力するのは、HTTPS 経由で、お使いのコンピューター上の非表示ブラウザーから IBI の実際のログインページ（auth.ibi.co.il）に対してのみです。
• 🔒 AI に送信されることはありません。パスワードを取得するツールはなく、パスワードを返すツールもないため、AI がパスワードを要求することはできません。
• 🔒 AI アプリの設定に保存されるのはプログラムの場所だけで、ユーザー名やパスワードは保存されません。
• 🔒 ログに書き込まれることはありません。また、エラーメッセージにユーザー名やパスワードが含まれている場合は、AI に表示される前に削除されます（これを確認するテストもあります）。

アカウント

• 🛡️ 読み取り専用です。買付、売却、キャンセル、送金を行うコードはありません。
• 🛡️ クリックするのは「Login」ボタン、ログインフォームの送信ボタン、「Latest Account Activity」タブだけです。
• 🛡️ さらに安全対策として、IBI のウェブサイトから送信されようとした場合でも、注文、取引、送金、入金、出金用のアドレス宛てのリクエストを内蔵ガードがブロックし、ブロックした場合はその旨をお知らせします。
• 🛡️ 口座番号、氏名、個人情報は収集しません。

データ

• 🏠 すべての処理はお使いのコンピューター上で行われます。こちら側のサーバーも、アカウント登録も、追跡も、分析機能もありません。ポートフォリオを読み取る際に開くのは IBI のウェブサイトだけで、読み込み方は通常のブラウザーと同じです。（インストール時には、GitHub、PyPI、Microsoft の Playwright サーバーからプログラムとブラウザーが一度だけダウンロードされます。）
• 🧹 ディスクには何も保存されません。読み取りのたびに新しいブラウザーを開き、Cookie、トークン、セッションを保存せずに終了します。最後の結果はメモリ上に 5 分間保持された後、消去されます。
• 👀 AI が確認できる情報：ポートフォリオの数値（保有銘柄、評価額、現金、損益、最近の口座取引）です。ほかのチャットメッセージと同様に、お使いの AI 企業に送信され、その企業のプライバシーポリシーが適用されます。

保護できないこと

• ⚠️ ロック解除されたコンピューターを使える人や、そのコンピューター上のマルウェアは、同じようにポートフォリオを読み取る可能性があります。コンピューターをロックし、最新の状態に保ってください。
• ⚠️ これは非公式ツールです。ログイン情報を預ける前に、コード（約 750 行、scraper.py から確認できます）をご自身で読むか、AI にレビューを依頼してください。

いつでも削除できます

• ibi-portfolio-mcp forget を実行すると、保管庫に保存されたログイン情報が削除されます。
• uv tool uninstall ibi-portfolio-mcp を実行すると、プログラムが削除されます。
• IBI のパスワードを変更しても、ログインできなくなります。

🇮🇱 בקצרה: הסיסמה נשמרת רק בכספת המוצפנת של המחשב שלך (Keychain / Credential Manager) ולא נשלחת אף פעם ל-AI. הכלי רק קורא נתונים: אין בו קוד לקנייה, מכירה או העברת כסף, ויש חסימה מובנית לכל בקשה כזו. הכל רץ אצלך במחשב, בלי שרת ובלי מעקב. ה-AI רואה רק את מספרי התיק (אחזקות, שווי, מזומן, רווח והפסד).

対応している AI アプリ

このツールはお使いのコンピューター上で動作するため、コンピューターにインストールされている AI アプリで利用できます。ウェブサイト上だけで動作するチャットからはアクセスできません。

ターミナルの操作に慣れていれば、Linux でも動作します。

セットアップ（約5分）

ターミナルに3行コピーして貼り付けます。Mac では「ターミナル」アプリ、Windows ではスタートメニューから開く「PowerShell」を使います。

1. uv をインストールする（Python プログラムをインストールする、小さな無料ツールです）。

Mac:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

次に、ターミナルを閉じて、もう一度開きます。

2. IBI Portfolio MCP をインストールする：

uv tool install ibi-portfolio-mcp

3. ガイド付きセットアップを実行する：

ibi-portfolio-mcp setup

次の処理が行われます。

1. IBI のユーザー名とパスワードを尋ねます。入力中、パスワードは表示されず、お使いのコンピューターの安全な保管庫（Mac では Keychain、Windows では Credential Manager）にのみ保存されます。
2. IBI の情報を読み取るために使う小さなブラウザーをダウンロードします（初回のみ、約100 MB）。
3. ログインをテストします（約1分）。
4. 見つかった AI アプリに接続します。お使いのアプリには「はい」と答えてください。

4. AI アプリを再起動して、次のように尋ねます。「IBI ポートフォリオの状況はどうですか？」

コマンドを入力したくない場合

Claude Code または Codex（ChatGPT desktop app に組み込み済み）をお使いの場合、次の内容を貼り付けると、手順1と2を代わりに実行します。

私の代わりに、README の手順1と2に従って https://github.com/kobimantzur/ibi-portfolio-mcp をインストールしてください。ibi-portfolio-mcp setup は自分で実行しないでください。また、チャットで IBI のパスワードを絶対に尋ねないでください。完了したら、自分のターミナルで ibi-portfolio-mcp setup を実行するように伝えてください。

その後、自分で ibi-portfolio-mcp setup を実行してください。パスワードを入力するのは自分だけになります。

まずはダミーデータで試す

アカウントを使う前に動作を確認したいですか？IBI_DEMO=1 ibi-portfolio-mcp check（Mac）または $env:IBI_DEMO=1; ibi-portfolio-mcp check（Windows）を実行してください。IBI にログインせず、架空のポートフォリオを使って回答します。

利用できる機能

接続後に尋ねられる質問の例：

• 「IBI ポートフォリオの評価額と、保有している現金の額を教えてください」
• 「保有銘柄のうち、評価額が最も大きい5銘柄はどれですか？それぞれの損益も教えてください」
• 「今月、何を買ったり売ったりしましたか？」

{
  "currency": "USD",
  "total_value": 54105.1,
  "market_value": 49284.75,
  "cash": 4820.35,
  "cash_pct": 8.91,
  "total_cost": 41460.9,
  "unrealized_pl": 7823.85,
  "unrealized_pl_pct": 18.87,
  "position_count": 8,
  "positions": [
    {
      "symbol": "VOO", "qty": 22.0, "last_price": 541.3, "change_pct": 0.4,
      "cost_price": 455.1, "market_value": 11908.6, "total_cost": 10012.2,
      "todays_pl": 47.63, "unrealized_pl": 1896.4, "unrealized_pl_pct": 18.94, "weight_pct": 22.01
    },
    {
      "symbol": "AAPL", "qty": 40.0, "last_price": 228.9, "change_pct": -0.6,
      "cost_price": 171.25, "market_value": 9156.0, "total_cost": 6850.0,
      "todays_pl": -54.94, "unrealized_pl": 2306.0, "unrealized_pl_pct": 33.66, "weight_pct": 16.92
    }
  ],
  "balances": { "buying_power": 4820.35, "balance_usd": 4820.35 },
  "fetched_at": "2026-10-27T14:05:12+00:00",
  "source": "demo"
}

{
  "ref": "D-1003", "symbol": "NVDA", "side": "BUY", "status": "Filled", "order_type": "Limit",
  "created_at": "2026-10-21T10:02:11", "executed_at": "2026-10-21T10:02:13",
  "qty": 10.0, "exec_qty": 10.0, "limit_price": 135.0, "exec_price": 134.8,
  "profit_loss": null, "commission": 2.5, "fees": null, "currency": "USD"
}

意図的に読み取り専用にしています

ログインするとアカウントへの完全なアクセス権が付与されます。利用前に、ご自身または開発者の知人に scraper.py を確認してもらうことができます。約200行のファイルです。

対応しているIBIアカウント

• ✅ IBI NextGen（ibi.orbisfn.io の米国株式プラットフォーム、英語UI）
• ❌ その他のIBIプラットフォーム（たとえば、イスラエルのTASE取引サイト）は、まだ対応していません。プルリクエストを歓迎します。

IBIのパスワード（シークレット）

ここは正しく設定する必要があるため、実際の動作を詳しく説明します。

必要なもの

IBI NextGenのユーザー名（メールアドレスまたはID）とパスワードです。ibi.orbisfn.io で入力するものと同じです。IBIにはAPIも読み取り専用キーもないため、サーバーはあなたと同じ方法でログインします。つまり、あなたのコンピューター上で非表示のブラウザーを開き、IBIの実際のログインページに入力します。

パスワードが保存される場所と、保存されない場所

AIに表示されるもの： ポートフォリオの数値です。ツールが返す内容は、ほかのチャットメッセージと同様にAIプロバイダーに送信されます。それが問題であれば、このサーバーに接続しないでください。

パスワードの保存方法（おすすめ順）

複数の方法が設定されている場合、優先順位は IBI_USER / IBI_PASS、次に IBI_USER_CMD / IBI_PASS_CMD、最後に保管庫です。

方法2：パスワードマネージャー。 パスワードだけを出力するコマンドであれば、どれでも使用できます。

IBI_PASS_CMD=op read op://Private/IBI/password          # 1Password
IBI_PASS_CMD=bw get password ibi.orbisfn.io             # Bitwarden (vault must be unlocked)

IBI_USER_CMD も同じ方法でユーザー名に使用できます。

方法3と4では、パスワードが平文ファイルに保存されます。そのファイルは非公開にし、共有やコミットは絶対にしないでください。サーバーは起動したフォルダーにある .env、または IBI_ENV_FILE で指定したファイルを読み込みます。

保存したログイン情報の変更または削除

ibi-portfolio-mcp forget     # removes it from the vault
ibi-portfolio-mcp setup      # saves a new one

SMSコード（二要素認証）

IBIからワンタイムコードを求められると、ツールは IbiOtpRequired エラーを返します。IBI_HEADED=1 を設定してください（アプリの env ブロック、または check の実行前にターミナルで設定します）。表示されたブラウザーウィンドウが開き、サーバーがユーザー名とパスワードを入力するので、コードは自分で入力してください。入力できる時間は3分間です。

パスワードが漏えいしたと思われる場合

IBIでパスワードを変更してから、ibi-portfolio-mcp setup をもう一度実行してください。

手動で接続する

setup で自動的に設定できます。このセクションは、ほかのアプリを使う場合や、自分で設定を編集したい場合に使用してください。

まず、プログラムの絶対パスを取得します。which ibi-portfolio-mcp（Mac）または where.exe ibi-portfolio-mcp（Windows）を実行します。以下では、そのパスを PATH_TO/ibi-portfolio-mcp と表記します。

Claude Desktop、Cursor、VS Code、Windsurfなどのほとんどのアプリ（JSON）。Claude Desktopのファイルは、Macでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json です。Cursorのファイルは ~/.cursor/mcp.json です。

{
  "mcpServers": {
    "ibi-portfolio": {
      "command": "PATH_TO/ibi-portfolio-mcp",
      "args": []
    }
  }
}

Windowsでは、パスの区切り文字にバックスラッシュを2つ使用します。たとえば "C:\\Users\\you\\.local\\bin\\ibi-portfolio-mcp.exe" のように記述します。

ChatGPTデスクトップアプリとCodex（~/.codex/config.toml、またはアプリの「Settings → MCP servers」）。ツールのタイムアウトを延長してください。IBIから新たに読み取るには約1分かかり、デフォルトのタイムアウトは60秒です。

[mcp_servers.ibi-portfolio]
command = 'PATH_TO/ibi-portfolio-mcp'
startup_timeout_sec = 30
tool_timeout_sec = 300

Claude Code：

claude mcp add --scope user ibi-portfolio -- PATH_TO/ibi-portfolio-mcp

変更後はアプリを再起動してください。

設定

アプリの env ブロックまたはターミナルで設定します。すべて省略可能です。

仕組み

1. ツールが呼び出されます。直近の読み取り結果が IBI_CACHE_SECONDS より新しい場合は、そのまま返されます。
2. それ以外の場合、非表示の新しいブラウザーが起動し、保存済みのログイン情報で ibi.orbisfn.io にログインします。
3. IBI のウェブアプリが独自のバックエンドからデータを読み込みます。サーバーはその応答（ポートフォリオ、残高、最新の取引）のコピーを保持し、フォールバックとしてページを読み取ります。
4. ブラウザーが閉じられ、数値が返されます。ディスクには何も書き込まれません。

読み取りには約 30～60 秒かかります。IBI がウェブサイトを変更すると動作しなくなる場合があります。その場合は、エラーテキストを添えて issue を作成してください（パスワードや、残高が写ったスクリーンショットは絶対に貼り付けないでください）。

トラブルシューティング

開発者向け

git clone https://github.com/kobimantzur/ibi-portfolio-mcp
cd ibi-portfolio-mcp
uv sync
uv run pytest -q
uv run ibi-portfolio-mcp check      # needs a saved login, or IBI_DEMO=1

テストには架空の数値のみを使用します。実際のアカウントデータは絶対にコミットしないでください。デモ GIF を再録画するには、uv run python docs/demo/record.py を実行してください。

免責事項

非公式のプロジェクトであり、IBI Israel Brokerage & Investments とは提携していません。ご自身のデータを読み取るために、ご自身のログインを自動化します。ご利用のアカウントについて、これが IBI の利用規約に適合することをご確認ください。ご自身の責任でご利用ください。ここに記載されている内容は、投資助言ではありません。MIT ライセンス。