WyckoffAgent is a research-oriented AI trading analysis agent. It helps users inspect Wyckoff volume-price structure, screen stocks, diagnose portfolios, run local CLI workflows, and expose analysis tools through MCP-compatible clients.

用自然语言和一位威科夫大师对话。系统把 A 股日线行情、威科夫结构识别、AI 研报、持仓风控、推荐跟踪和通知推送串成一条自动化链路。

React Web、Streamlit 维护入口、CLI、MCP 与 GitHub Actions 共同组成当前产品形态；行情优先复用 Supabase 缓存，缺口再回源补拉并回写。

项目主页：youngcan-wang.github.io/wyckoff-homepage

关键词入口：Trading Agent · Wyckoff Trading Agent · AI Trading Agent · Stock Screener Agent

Risk disclosure: WyckoffAgent is for educational, research, and informational use. It does not provide investment advice, does not account for every personal financial circumstance, and does not guarantee future performance.

文档导航

Special Thanks

TickFlow 感谢 TickFlow 为 WyckoffAgent 提供高质量 A 股 / 美股 / 港股行情数据能力支持。

线上使用

无需安装，注册即用。

Web App（React）

现代 React SPA，AI Agent 对话 + 持仓管理 + 漏斗选股 + 数据导出，流式输出 + 工具调用可视化。

在线地址：wyckoff-analysis.pages.dev

读盘室	漏斗选股

推荐跟踪	持仓管理

Streamlit（维护入口）

Streamlit 框架支撑了项目早期 MVP。当前保留数据导出、单股分析、设置等历史入口；新功能优先进入 React Web 与 CLI。

在线地址：wyckoff-analysis-youngcanphoenix.streamlit.app

读盘室	数据导出

演示视频（含中文字幕）

场景	本地文件	Git 预览图
「从0到1读盘」Web 全流程（读盘室→设置）	web-demo.mp4
「老入口维护」Streamlit 全流程（8 个入口页）	streamlit-demo.mp4
「终端党最爱」CLI 流程（启动→执行→结果）	cli-demo.mp4
「数据可追踪」Dashboard 全流程（各 tab）	dashboard-demo.mp4

本地使用

CLI — 命令行 Agent ⭐ 强烈推荐

终端原生交互，功能最全，支持后台任务、记忆系统、Skills 扩展、MCP Server。所有数据存本地 SQLite，无需联网即可使用。

安装：

# 一键安装（推荐）
curl -fsSL https://raw.githubusercontent.com/YoungCan-Wang/Wyckoff-Analysis/main/install.sh | bash

# 或 Homebrew
brew tap YoungCan-Wang/wyckoff && brew install wyckoff

# 或 pip
uv pip install youngcan-wyckoff-analysis

启动：

wyckoff          # 启动 Agent 对话
wyckoff dashboard  # 启动本地可视化面板

升级： wyckoff update

启动后只需两步：

1. /model — 选择模型（Gemini / Claude / OpenAI），输入 API Key
2. 开始对话 — 无需注册，持仓数据自动存本地

> 帮我看看 000001 和 600519 哪个更值得买
> 审判我的持仓
> 大盘现在什么水温

可选：/login 登录后持仓同步云端，多设备共享。不登录也能完整使用所有功能。

启动界面	持仓查询

诊断报告	操作指令

Web 本地版 ⭐ 优先推荐

React SPA 本地部署，数据读写本地 SQLite（与 CLI 共享同一份数据），浏览器可视化体验。

安装 & 启动：

cd web/apps/web
pnpm install
pnpm dev        # http://localhost:5173

功能：读盘室（AI Agent 对话）、持仓管理、推荐跟踪、漏斗选股、尾盘记录、数据导出、单股分析。

本地可视化面板（Dashboard）

wyckoff dashboard

一条命令启动本地 HTTP 面板（默认端口 8765），自动打开浏览器。全部数据存储在本地 SQLite，无需联网。

功能页面：AI 推荐、信号池、持仓、Agent 记忆、配置、对话日志、Agent 日志、同步状态。支持暗色/亮色主题切换，中英双语。

总览	AI 推荐	信号池

尾盘记录	持仓	Agent 记忆

后台任务	对话日志	同步状态

对话日志详情（Trace）

回测网格

18 组参数并行回测，自动输出最优参数组合、夏普矩阵和策略体检：

最优参数 & 梯队表	参数矩阵

功能一览

工具

Agent 的武器库 — 10 个量价工具 + 5 个通用能力：

工具调用顺序和次数由 LLM 实时决策，无需预编排。发一个 CSV 路径他就能读；说"帮我装个包"他就能执行。

五层漏斗

数据源

个股日线先读统一行情仓库：

1. 优先读取 Supabase stock_hist_cache。
2. 区间缺口只补拉缺失日期。
3. 合并去重后回写缓存，再返回给 Web、CLI、Step3 与回测。

默认行情缓存按日期滑动保留约 320 个交易日窗口。实时回源按可用性自动降级：

tickflow → tushare → akshare → baostock → efinance

任一源不可用时自动切换，无需干预。

数据源 API Key（解锁实时行情 + 分钟K线 + 盘中监控）
购买链接：TickFlow 注册

大模型 API Key（支持 Gemini / Claude / OpenAI / DeepSeek 等）
购买链接：1Route 注册

每日自动化

仓库内置 GitHub Actions 定时任务：

模型支持

CLI：Gemini / Claude / OpenAI，/model 一键切换，支持任意 OpenAI 兼容端点。

Web / Pipeline：1Route / Gemini / OpenAI / 智谱 / Minimax / DeepSeek / Qwen / 火山引擎；Kimi 等 OpenAI 兼容服务可通过自定义 base_url 或 custom_providers 接入。

配置

零配置即可使用 — 启动后 /model 添加任意 LLM API Key 即可对话。持仓数据自动存本地。

进阶配置（.env 文件或 GitHub Actions Secrets）：

数据源购买：TickFlow → ｜ 大模型购买：1Route →

完整配置项和 GitHub Actions Secrets 说明见 架构文档。

MCP Server

将 Wyckoff 分析能力通过 MCP 协议 对外暴露，让 Claude Code / Cursor / 任何 MCP Client 直接调用诊股、筛选、回测等工具。

# 安装 MCP 依赖
uv pip install youngcan-wyckoff-analysis[mcp]

# 注册到 Claude Code
claude mcp add wyckoff -- wyckoff-mcp

或在 MCP Client 配置文件中手动添加：

{
  "mcpServers": {
    "wyckoff": {
      "command": "wyckoff-mcp",
      "env": {
        "TUSHARE_TOKEN": "your_token",
        "TICKFLOW_API_KEY": "your_key"
      }
    }
  }
}

注册后在 Claude Code / Cursor 中直接问"帮我诊断 000001"即可调用 Wyckoff 工具。

Wyckoff Skills

轻量复用威科夫分析能力：YoungCan-Wang/wyckoff_skill

适合给 AI 助手快速挂载一套"威科夫视角"。

交流

飞书群	QQ群	飞书个人
	群号: 761348919

赞助

觉得有帮助？给个 Star。赚到钱了？请作者吃个汉堡。

支付宝	微信

风险提示

本工具基于历史量价结构发现潜力标的，过去表现不代表未来收益，所有筛选、推荐、回测结果均不构成任何投资建议。投资有风险，决策需自主。

License

AGPL-3.0 © 2024-2026 youngcan