JungHoonGhae/tossinvest-cli

解決する課題

本プロジェクトは、Toss Securitiesの投資データにアクセスするためのコマンドラインインターフェース (CLI) およびModel Context Protocol (MCP) サーバーを提供します。公式のOpen APIとToss Securitiesのウェブプラットフォーム (WTS) で利用可能な情報のギャップを埋め、AIシグナル、配当履歴、税務データなど、公式APIでは利用できない30以上の追加機能へのアクセスを可能にします。

仕組み

tossctl は、公式のOpen APIと非公式のウェブ内部API (WTS) の両方に接続するラッパーとして機能します。ユーザーは電話認証を通じて認証を行い、セッションを維持できます。接続後は、スクリプトやターミナルクエリ用のスタンドアロンCLIツールとして、あるいはAIエージェント (Claude Code、Cursor、Codexなど) をユーザーの投資データに接続し、資産、ニュース、パフォーマンスに関する自然言語クエリを可能にするMCPサーバーとして利用できます。

対象ユーザー

Toss Securitiesを利用しており、ポートフォリオ追跡の自動化、AI駆動型ワークフローへの財務データの統合、またはターミナルから直接高度な投資分析ツールへのアクセスを求める投資家。

主な特徴

• 拡張された機能セット: AIシグナル、決算説明会、税務情報など、公式APIにはない30以上の機能にアクセス可能。
• AIエージェント統合: Claude CodeやCursorなどのAIエージェントとシームレスに接続するためのMCPサーバーを内蔵。
• ハイブリッドAPIアプローチ: 利用可能な場合は公式のOpen APIキーを優先し、拡張機能が必要な場合はWTS内部APIにフォールバック。
• 安全第一: 実際の取引はデフォルトで無効化されており、注文はプレビュー後にユーザーが手動で承認する必要があります。
• ローカル履歴: 投資履歴をオフラインで同期および検索する機能。