JungHoonGhae/tossinvest-cli

解決する課題

tossinvest-cliは、Toss Securitiesに接続するための柔軟な方法を提供し、公式Open APIの機能を拡張します。コマンドラインインターフェース（CLI）またはAIエージェント用のMCPサーバーを介して、ユーザーが口座概要、ポートフォリオ、市場データ、取引機能にアクセスできるようにし、制限のある公式APIとTossウェブアプリ（WTS）で利用可能なフル機能セットとの間のギャップを埋めます。

仕組み

このツールはGoで構築されており、CLI (tossctl) およびMCPサーバーとして動作します。公式のAPIキーを使用するか、ウェブセッション（QRログイン経由）を利用してToss Securitiesに接続できるため、公式APIでは利用できない機能にもアクセス可能です。config.jsonにはセーフティゲートが含まれており、デフォルトでは取引アクションが無効化されており、取引を実行するには明示的なユーザーの許可が必要です。

対象ユーザー

• AIエージェントユーザー: Claude Code、Cursor、Gemini、またはGitHub Copilotを使用しており、エージェントにMCP経由で口座管理や取引を行わせたい方。
• 開発者および自動化担当者: スクリプト、ダッシュボード、または自動取引のために、プログラムによるToss Securitiesデータへのアクセスを必要とするユーザー。
• 投資家: 公式APIにはない、実現損益、配当、市場の需給フローなどの高度な分析ツールを求める個人。

ハイライト

• 拡張されたカバレッジ: 公式Open APIの100%に加え、AIシグナル、市場指数、配当履歴など、ウェブアプリからの24の追加機能をサポートしています。
• AIエージェント統合: MCP (Model Context Protocol) をネイティブサポートしており、さまざまなAIエージェントを介してToss Securitiesとの自然言語による対話が可能です。
• ハイブリッドルーティング: リクエストを公式APIまたはウェブセッションに自動的にルーティングし、レート制限を回避して制限された機能にアクセスします。
• 包括的な取引機能: 指値注文、端株取引（KRW決済モードを含む）、および取引検証用の「ドライラン・プレビュー」をサポートしています。
• ヘッドレスログイン: GUIのない環境（SSH/CI）向けに、QRベースの認証をサポートしています。