YoungCan-Wang/WyckoffTradingAgent

WyckoffAgent – 中国・香港・米国株式市場向けAI搭載トレーディングアシスタント

機能

• 「ウィコフの達人」との会話型インターフェースです。自然言語で質問を入力すると、ウィコフの価格・出来高分析手法に基づいた市場分析を返答します。
• TickFlowからリアルタイムの日次相場を取得し、ユーザー固有のデータ（ポートフォリオ、シグナルフィードバック、バックテスト結果など）をSupabaseに保存し、以下のツールチェーンを実行します。
  1. A株・香港株・米国株の日足バーからウィコフ構造を識別します。
  2. それらの構造をAI生成のリサーチレポート、リスク管理チェック、ファネルスクリーニングロジックと組み合わせます。
  3. 結果をWeb UI、CLIダッシュボード、Electronデスクトップアプリ、または外部MCPツールにプッシュします。

主要コンポーネント

コンポーネント	役割
TickFlow	リアルタイムの市場データプロバイダー（Supabaseキャッシュなし）。
Supabase	ユーザー設定、ポートフォリオ、バックテストログ、シグナルフィードバック、タスク結果を保存します。
LLMバックエンド	Gemini、Claude、OpenAI、DeepSeek V4 – 自然言語対話とAI駆動のリサーチレポートに使用されます。
React Webアプリ	インタラクティブなチャット、ファネルスクリーン、ポートフォリオ表示、ニュースオーバーレイなど。
CLI / TUI	wyckoffコマンドはターミナルUI、ダッシュボード（wyckoff dashboard）、または単発タスク（wyckoff run …）を起動します。
Electronデスクトップ	同じUIとツールをWindows/macOS向けにバンドルし、ダイアログ内の書き込み操作を提供します。
MCP（Model-Context-Protocol）サーバー	GitHub、ファイルシステム、カスタムデータソースから追加できる19の公開ツールを公開します。すべてのアクションは承認キューを通過します。
Cloudflare Workers + Vercelサンドボックス	重いリサーチ計算を安全で短命な環境で実行します。

メインワークフロー

1. データ取り込み – TickFlowの/v1/quotesは全市場スナップショットを返します。エージェントはローカルでフィルタリングします。
2. ウィコフファネル – A株市場（約5,000銘柄）をスキャンし、コンセプトレベルの「メインライン」構造、8チャンネル強度、候補レーン、買いポイント確認を識別します。
3. AIリサーチ – LLMが3層レポート（ロジックブレークダウン、リザーブキャンプ、ローンチパッド）を生成し、それらを評価します。
4. シグナルフィードバックループ – 市場終了後、観察結果をフィードバックしてファネルを改善し、シャドウ戦略の検証を可能にします。
5. 実行ガード – 「日次ファネル×翌日寄り付き」ルールにより、寄り付き価格がモデル生成のインターバル内にある場合のみ取引を許可します。それ以外の場合はシグナルを警告として記録します。
6. ユーザー操作 – チャットを通じて、ポートフォリオ診断、バックテストグリッドの要求、またはカスタム/screen、/checkup、/report、/backtestスキルの実行ができます。すべての書き込みアクションは手動承認のためにキューに入れられます。

インストールと使用方法

# ワンクリックインストール
curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/WyckoffTradingAgent/main/install.sh | bash
# または Homebrew / pip 経由
brew tap YoungCan-Wang/wyckoff && brew install wyckoff
uv pip install youngcan-wyckoff-analysis

wyckoff                # 会話エージェントを起動
wyckoff dashboard      # ローカルビジュアルパネルを起動

初回実行時にLLMモデルを選択し、APIキーを提供すると、エージェントが準備完了になります。

コストとライセンス

• コードはAGPL-3.0で完全にオープンソースです。セルフホストできます。
• ホスト型サービスの実行にはクラウドコストが発生します（データプロバイダー、Supabase、LLM使用量、Cloudflare Workers）。詳細なコストモデルはdocs/COST_MODEL.mdに文書化されています。
• オプションの「ナレッジプラネット」メンバーシップ（年間518人民元）は共有インフラを補助しますが、投資アドバイスを構成するものではありません。

対象ユーザー

• ウィコフメソッドに従い、AI支援によるパターン検出とリサーチを求めるトレーダー。
• LLMチャット、リアルタイム市場データ、データベースバックエンド、マルチプラットフォームフロントエンドを組み合わせたフルスタックの例に興味のある開発者。
• 規制された承認ベースの取引自動化パイプラインのリファレンス実装を探している人。

詳細情報

• アーキテクチャ: docs/ARCHITECTURE.md
• ファネルフロー: docs/A_SHARE_FUNNEL_FLOW.md
• シグナルフィードバックループ: docs/SIGNAL_FEEDBACK_LOOP.md
• 公開デモビデオとスクリーンショットはREADMEに埋め込まれています。