Stockbit MCP

Stockbit MCP

Stockbitのマーケットデータ、分析、チャート描画、読み取り専用の証券口座ポートフォリオ、およびシミュレーション取引を、Claude、ChatGPT、その他のMCPクライアントで利用できます。StockbitおよびIDXとは無関係の非公式プロジェクトです。

このビルドでは、実資金を使った取引を実行できません。 実際の買い、売り、訂正、取消、e-IPOの申し込みに関するツールとHTTPルートは削除されています。入金および出金には対応していません。以前のlive設定はフェイルクローズし、実取引を再び有効にする切り替え手段はありません。これは技術上の制限であり、OJKの承認や法令遵守の認証を主張するものではありません。

Bahasa Indonesia · ツールリファレンス · クライアント設定 · セキュリティ · 検証

ビルドとサインイン

このチェックアウト、または検証済みの1.4.1以降のリリース成果物を使用してください。1.3.1 npmパッケージにはこれらの変更が含まれていません。また、以前のv1.4.0 GitHubタグも、1.3.1のパッケージマニフェストを指しています。

npm ci
npm run build
node dist/bin/stockbit-auth.js login
node dist/bin/stockbit-auth.js status

Node.js 22以降と、ログインおよび対話型のチャート描画に対応するChromium系ブラウザーが必要です。Stockbitの公式ページでサインインしてください。パスワードやOTPをアシスタントから要求することはありません。認証情報はOSのKeychain、または暗号化ファイルのフォールバックにローカル保存されます。ブラウザーのセッションとAPIのセッションは別々です。どちらに対応が必要かはstatusで確認できます。

クライアントを接続する

Claude Desktopのclaude_desktop_config.jsonから、ビルド済みサーバーを起動できます。

{
  "mcpServers": {
    "stockbit": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/stockbit-mcp/dist/bin/stockbit-mcp.js"],
      "env": {
        "STOCKBIT_MCP_TRANSPORT": "stdio",
        "STOCKBIT_TOOLS": "core,chartbit,virtual"
      }
    }
  }
}

command -v node（PowerShellの場合は(Get-Command node).Source）を使ってNodeのパスを確認し、2つのサンプルパスを置き換えてください。設定を変更したら、クライアントを再起動してください。STOCKBIT_TOOLS=allを設定すると、サポート対象のツール一式が利用できます。デフォルトでは、より小規模なcoreが使われます。プロファイルが選択するのは機能であり、実資金を動かす権限ではありません。

npm run build:mcpbを実行して、ローカルのClaude Desktop拡張機能をビルドすることもできます。インストールとプロファイルの選択については、クライアント設定をご覧ください。

ChatGPTでは、サポートされているSecure MCP Tunnel、または適切に保護されたリモートMCPデプロイメントを使用してください。コネクターにローカルファイルのパスを貼り付けても、stdioサーバーがChatGPTからアクセス可能になるわけではありません。クライアント設定では、現在の要件、任意のローカルHTTPトランスポート、およびデプロイメントで別途必要となる手順について説明しています。

機能

タスク	ツール／ファミリー
株価、板情報、値上がり・値下がり銘柄、取引時間、約定履歴	market
ブローカーの買い集め、売り抜け、資金フロー	bandarmology
インジケーター、パターン、戦略比較、バックテスト、スキャン	analysis
ファンダメンタルズ、所有状況、インサイダー、コーポレートアクション、IPO情報	fundamentals、company、insider、corpaction、eipo
ニュース、Stockbitの投稿および調査情報の閲覧	stream
編集を含むウォッチリストと保存済みスクリーナー	account、screener
Stockbitチャートの閲覧、描画、確認、スクリーンショット、保存	chartbit
実際のポートフォリオ、保有ポジション、現金、注文履歴 — 読み取りのみ	portfolio、position、cash_balance、orders、order_history
Stockbitウェブサイトのシミュレーション口座	virtual_*
独立したローカルのシミュレーション台帳	paper_*
ローカルのアラート、Pineスクリプト、保存済みの読み取りワークフロー	alerts、pine、workflows

これはサポート対象のAPI機能であり、Stockbitウェブサイト上のすべての機能に相当するツールがあることを保証するものではありません。機能の利用資格、非公開の上流変更、ログイン状況、ブラウザーの利用可否によって、個々のツールが制限されることがあります。エビデンスラベルでは、観測された応答と推定されたマッピングを区別します。認識されない口座の値は、ゼロに変換されず、存在しない状態のまま扱われます。

ポートフォリオとシミュレーションは別です

実際の証券口座の情報を読み取るには、証券セッションが必要です。端末でご自身でロックを解除してください。

node dist/bin/stockbit-auth.js trading-login

PIN はローカルで入力され、保存されたり MCP ツールに渡されたりすることはありません。セッションのロックを解除しても、取引は有効になりません。このビルドには実際の注文を送信する経路がありません。

virtual_* は、通常の Stockbit ログインを使って Stockbit のウェブサイト上の仮想口座を利用します。これは実際のポートフォリオとも、ローカルのペーパーレジャーとも別のものです。シミュレーション注文を送信できるのは、/virtualtrading/ 配下のルートだけです。結果を信頼する前に、各ツールの検証に関する注意事項を確認してください。

独立したローカルのペーパーレジャーを使う場合：

node dist/bin/stockbit-auth.js trading-enable --paper

paper_order_preview を使って注文内容を確認し、その後、対応する paper_order_buy、paper_order_sell、paper_order_amend、または paper_order_cancel を実行してください。シミュレーション結果は paper_portfolio と paper_orders で確認できます。ローカルのペーパーモードが有効な場合も、portfolio は常に実際の証券口座のポートフォリオを読み取ります。

チャートの描画

chartbit ファミリーを有効にし、保存済みのブラウザープロファイルを使ってサインインしてください。一般的なフローは chartbit_open → chartbit_shapes → chartbit_draw → chartbit_screenshot → chartbit_save です。対応するレイアウト ID を chartbit_layouts から取得し、保存範囲を限定した永続化チェックのために chartbit_save に渡してください。レイアウトのメタデータが十分でない場合、保存結果では検証状態が不明と報告されます。まず既存の描画を確認してください。サーバーが作成した図形のみを scope: "ours" で消去してください。すべての図形の削除や、保存済みレイアウトの置き換えには明示的な確認が必要です。保存処理では、Stockbit に保存されているレイアウト／描画に照らして永続化を検証します。

リクエスト例：「BBRI を分析してサポートラインとレジスタンスラインを描画して」「ポートフォリオを表示して」「BBRI と TLKM のブローカーフローを比較して」「Stockbit の仮想注文を表示して」

検証

npm run typecheck
npm test
npm run build
npm run docs:tools
npm run smoke
npm run check:pack

ログイン後、再利用可能な読み取り専用 MCP スイープを実行してください。

npm run verify:tools -- --live

登録されているすべてのツールを一覧化し、成功した読み取り、上流の障害、不足している前提条件、制御されたシナリオが必要な変更操作／ブラウザー操作を記録します。注文の発注、アカウント状態の編集、ブラウザーの起動は行いません。レポートは無視対象の .stockbit/ 配下に保存され、レスポンスのペイロードは含まれません。--only quote,analyze を指定すると、後続チェックの対象を絞り込めます。分離されたテストスイートでは、アカウントに触れることなく、変更操作のガードとシミュレーション上の書き込みシナリオを検証します。

API は非公開であり、変更される可能性があります。このプロジェクトは投資助言を提供するものではなく、自動アクセスが Stockbit の利用規約で許可されていることも保証しません。実際の制限については、セキュリティ上の境界と検証記録を参照してください。