JungHoonGhae/tossinvest-cli

何を解決するか

tossinvest-cli は、Toss Securities に柔軟に接続する方法を提供し、コマンドラインインターフェース (CLI) または AI エージェント向けの Model Context Protocol (MCP) サーバーとして、口座の管理、市場価格の確認、取引の実行を可能にします。公式 Open API の制限と Toss ウェブ取引システム (WTS) に備わる完全な機能セットの間のギャップを埋め、公式 API だけでは得られない大幅な拡張機能を提供します。

動作方法

このツールは Go で構築され、ハイブリッドルーティングシステムとして動作します。対応する機能については公式 Open API を使用し、それ以外のリクエストは Toss ウェブアプリケーションの内部 API (WTS) を経由してルーティングします。ユーザーはブラウザベースの QR ログインまたはリンクログインで認証を行います。セキュリティを確保するため、取引機能はデフォルトで無効になっており、config.json ファイルで明示的に有効化する必要があります。また、再ログインを頻繁に行わずに接続を維持するためのセッション延長メカニズム（tossctl auth extend）も備えています。

対象ユーザー

• AI エージェントユーザー：Claude Code、Cursor、Gemini、GitHub Copilot を使用しており、AI エージェントが MCP サーバーを通じて証券取引や市場分析を処理できるようにしたいユーザー。
• 開発者および自動化ユーザー：スクリプト作成、自動化、または公式 API にないリアルタイムプッシュや詳細なポートフォリオパフォーマンスデータにアクセスする必要があるユーザー。
• 個人投資家：Toss Securities の利用者で、投資をプログラムで管理したいユーザー。

主な特徴

• 拡張された機能：公式 Open API の 100% をカバーし、さらに AI シグナル、条件検索、詳細な取引履歴など、合計 58 の独自機能を提供。
• AI エージェント統合：MCP へのネイティブ対応により、AI エージェントが自然言語で Toss Securities と対話可能。
• ハイブリッドルーティング：公式 API と WTS 内部 API の間をシームレスに切り替え可能。
• 安全最優先：取引の変更は明示的な設定と dry-run preview が必要で、実行前に確認が可能。
• 包括的なデータ：リアルタイムプッシュ (SSE)、"Kimchi プレミアム" を含む暗号資産価格、海外株式の詳細な税務レポートにアクセス可能。