WyckoffTradingAgent：自然言語で出来高・価格分析を行うスクリーナーエージェント

出来高・価格分析のための対話型エージェント

READMEはWyckoffTradingAgentを、Wyckoff分析の専門家と自然言語で対話できるインターフェースとして紹介しています。エージェントは10の専門ツールと5つの汎用機能を操り、結論を出す前に多段階の推論を実行します。対象市場はA株、香港株、米国株です。ツール一覧には、銘柄名やピンインでの検索、Wyckoff診断、ポートフォリオ管理、市場概況、ファネルスクリーニング、AIレポート生成、戦略判断、履歴照会、バックテスト、バックグラウンドタスク監視が含まれます。汎用機能はシェルコマンド実行、ファイルの読み書き、ローカルChrome CDP経由のウェブ調査です。READMEは、ツール呼び出しの順序と頻度はLLMが実行時に決定し、事前の振り付けは不要と述べています。

Web、CLI、MCPの3つのアクセス経路

wyckoff-analysis.pages.devにあるReact Webアプリはインストール不要で、AIエージェントチャット、ポートフォリオ管理、ファネルスクリーニング、推奨銘柄の追跡、データエクスポート、ストリーミング出力、ツール呼び出しの可視化を備えています。CLIは最も完全な機能セットを持つ推奨のネイティブターミナルワークフローとされ、バックグラウンドタスク、メモリ、スキル、MCPサーバー、ローカルSQLiteストレージをサポートします。MCPサーバーはMCPプロトコルで10ツールを公開し、Claude Code、Cursor、その他のMCPクライアントから直接呼び出せます。READMEは旧Streamlit MVPが退役したこと、そのランタイムコードはrelease/streamlitブランチに保存され、MVPのアーキテクチャ画面とメモはSTREAMLIT_MVP_ARCHITECTURE.mdに保管されていると述べています。

5層のメインラインファネル

スクリーニングエンジンは5層のファネル構造です。L1はST、BSE、STAR市場の銘柄を除外し、最低時価総額と平均日次売買代金のフィルターを適用します。時価総額の下限は35億元、平均日次売買代金は5000万元以上です。L2は8チャネルの強さを測定します。Rally、Ignition、Stealth、Accumulation、Dry Volume、Support、Trend Continuation、Breakout Accelerationです。メインライン層はテーマエンジンを使用し、動的なコンセプトの熱量、テーマレーダー、財務品質、タイミングゲートを組み合わせます。L3は弱いセクターを除外しつつ、強い個別銘柄と検証済みテーマが固定のTop-Nセクター制限を回避できるようにします。L4はSpring、LPS、SOS、EVR、Compression、Trend Pullbackというマイクロトリガーを探します。L5はLLMレビュー、翌日までのシグナル確認、OMSリスクゲートを適用します。確認された候補のうち、翌日の寄り付きが単一のOMSエントリー範囲内にあるものだけが購入可能です。NEUTRALが主戦場で、RISK_ONは新規購入をブロックします。

データソースと自動フォールバックチェーン

日足データはtickflow、tushare、akshare、baostock、efinanceの5つのソースを順に流れます。いずれかのソースが利用できない場合、システムは手動介入なしに次のソースへ自動的にフォールバックします。READMEはA株、米国株、香港株のリアルタイムおよび日内データを強化するため、TickFlowの接続を推奨し、登録ページへのリンクを提供しています。設定表ではTUSHARE_TOKENが株式市場データの必須項目、TICKFLOW_API_KEYが任意項目とされています。READMEは各データソースのレート制限、料金、データ遅延については記載しておらず、別途確認が必要です。

CLIのインストールと実行

READMEは3つのローカルインストール方法を記載しています。ワンラインインストールはリポジトリからinstall.shを取得してbashにパイプします。Pythonを検出し、uvをインストールして分離環境を作成し、その後wyckoffコマンドが利用できます。Homebrewユーザーはbrew tap YoungCan-Wang/wyckoffとbrew install wyckoffを実行します。pipルートはuv venv、uv pip install youngcan-wyckoff-analysis、その後wyckoffを使用します。起動後は2つのステップが必要です。/modelでGemini、Claude、OpenAIなどのモデルを選択してAPIキーを入力し、質問を始めます。登録は不要で、ポートフォリオデータはローカルに保存されます。ローカルダッシュボードはwyckoff dashboardで起動し、デフォルトポートは8765です。ローカルReactデプロイはweb/apps/webで、pnpm installとpnpm devを使用します。

GitHub Actionsによる定期自動化

リポジトリはGitHub ActionsとCodex Automationで実行される一連の定期タスクを北京時間で記録しています。ファネル、AIレポート、リバランスは日曜から木曜の17:17に実行され、結果はFeishuまたはTelegramにプッシュされます。保有銘柄診断は手動のworkflow_dispatchトリガーです。寄り前リスク監視は月曜から金曜の08:20に実行され、A50先物とVIXアラートを4段階の警報レベルで出します。急騰レビューは平日19:25に、当日終値リターンが7%超かつ前日終値リターンが3%未満の銘柄を対象に実行されます。推奨銘柄の再評価は平日23:00に実行されます。バックテストグリッドは毎月1日と15日の04:00に実行され、8つのパラメータ組み合わせをカバーします。データベース保守は火曜から土曜の06:20に実行され、古い相場、注文、シグナル、市場シグナル、その他のローリングウィンドウデータを削除します。

ライセンス、免責事項、未確認の事項

このプロジェクトはAGPL-3.0でライセンスされ、著作権は2024年から2026年までyoungcanが保持します。ライセンス抜粋は、これをネットワークサーバーソフトウェアのために設計された自由なコピーレフトライセンスと説明し、公開サーバーで修正版を運用する者は、その修正版のソースコードを利用者に提供することを要求しています。これはライセンスの中心的な義務の一つです。READMEには、このエージェントは教育・研究・情報提供を目的とし、投資助言を提供せず、将来のパフォーマンスを保証しないというリスク開示が含まれています。提供された情報源は、セキュリティ保証、正式なサポート経路、ライセンス条文自体が付与する以上の保証条件については何も述べていません。それらの詳細は別途確認が必要です。

この構成を読むときに最初に分けるべきなのは、分析ロジックと市場データ供給です。TUSHARE_TOKENは必須、TICKFLOW_API_KEYは任意と記載され、tickflow、tushare、akshare、baostock、efinanceの順にフォールバックします。ただし各サービスの料金、レート制限、遅延はREADMEにありません。L1の35億元と平均日次売買代金5,000万元という条件、L2の8チャネル、L4のマイクロトリガーを同じ入力日付で再現できるかが、結果を読む前の確認点です。

CLIはuv venvとuv pip install youngcan-wyckoff-analysisの経路、またはbrew tap YoungCan-Wang/wyckoffとbrew install wyckoffの経路が記載されています。起動後は/modelでモデルとAPIキーを設定し、wyckoff dashboardは既定で8765番ポートを使います。購入候補の判断にはNEUTRAL、RISK_ON、OMSエントリー範囲の扱いが関係します。README自身が教育・研究・情報提供用で投資助言ではないと記しているため、注文処理へ直結させる用途には適合しません。

編集部の結論

A株、香港株、米国株の出来高と価格をCLIやMCPから調べたい研究者には材料があります。投資助言や注文の自動化を求める利用者には適しません。TUSHARE_TOKEN、データ遅延、NEUTRAL時のOMS範囲を確認し、候補が同じ入力日付で再現できるかを先に見てください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes