mcpField
F
ftd-detector

ftd-detector

github.com/mphinance数据与数据库3284 次安装5 天前更新
代码仓库

关于 ftd-detector

FTD Detector 是一项 Agent 技能，依据 William O'Neil 方法评估市场调整后的 Follow-Through Day 信号。它分析 S&P 500 和 QQQ 数据，并生成信号质量评分及仓位建议。

主要功能

  1. 01分析 S&P 500 和 QQQ 数据
  2. 02跟踪调整与反弹阶段
  3. 03评估 FTD 后的市场状况
  4. 04生成 0 至 100 的信号评分
  5. 05生成 JSON 和 Markdown 报告

适用场景

  1. 01评估市场调整后的底部信号
  2. 02查看反弹尝试及 FTD 确认
  3. 03评估市场下跌后的仓位

MCP 相关

这是 Agent 技能，而非 MCP 服务。README 未说明 MCP 连接或接口。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mphinance/alpha-skills --skill ftd-detector

安装后在 Claude Code 中输入/ftd-detector确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
ftd_methodology.md
post_ftd_guide.md
scripts/
fmp_client.py
ftd_detector.py
post_ftd_monitor.py
rally_tracker.py
report_generator.py
scripts/tests/
conftest.py
helpers.py
test_fmp_client.py
test_post_ftd_monitor.py
test_rally_tracker.py

详细介绍

FTD Detector 技能

用途

使用 William O'Neil 经验证的方法，检测确认市场底部的 Follow-Through Day（FTD）信号。生成质量评分（0-100），并提供市场回调后重新入市的仓位建议。

与 Market Top Detector 互为补充：

  • Market Top Detector = 防御型（检测派发、轮动和恶化）
  • FTD Detector = 进攻型（检测反弹尝试和底部确认）

何时使用此技能

英语：

  • 用户询问“市场是否正在筑底？”或“现在可以放心再次买入吗？”
  • 用户观察到市场回调（下跌 3% 以上），希望了解重新入市的时机
  • 用户询问 Follow-Through Days 或反弹尝试
  • 用户希望评估近期反弹是否可持续
  • 用户询问回调后是否应增加股票仓位
  • Market Top Detector 显示风险升高，用户希望寻找底部信号

日语：

  • 「筑底了吗？」「可以买回来了吗？」
  • 判断从调整阶段（下跌 3% 以上）重新入市的时机
  • 了解 Follow-Through Day 或反弹尝试
  • 评估近期反弹是否可持续
  • 判断调整后是否应扩大仓位
  • Market Top Detector 显示高风险后，确认筑底信号

与 Market Top Detector 的区别

方面FTD DetectorMarket Top Detector
重点底部确认（进攻型）顶部检测（防御型）
触发条件市场回调（下跌 3% 以上）市场处于或接近高点
信号反弹尝试 → FTD → 重新入市派发 → 恶化 → 退出
评分FTD 质量评分（0-100）顶部概率（0-100）
操作何时增加仓位何时减少仓位

执行工作流

阶段 1：执行 Python 脚本

运行 FTD 检测脚本：

python3 skills/ftd-detector/scripts/ftd_detector.py --api-key $FMP_API_KEY

脚本将：

  1. 从 FMP API 获取 S&P 500 和 QQQ 的历史数据（60 个以上交易日）
  2. 获取两个指数的当前报价
  3. 运行双指数状态机（回调 → 反弹 → FTD 检测）
  4. 评估 FTD 后的健康状况（派发日、信号失效、强势趋势）
  5. 计算质量评分（0-100）
  6. 生成 JSON 和 Markdown 报告

**API 调用额度：**4 次（远低于免费套餐每天 250 次的限额）

阶段 2：呈现结果

向用户呈现生成的 Markdown 报告，并重点说明：

  • 当前市场状态（回调、反弹尝试、FTD 已确认等）
  • 质量评分和信号强度
  • 建议的仓位水平
  • 关键观察价位（波段低点、FTD 当日低点）
  • FTD 后的健康状况（派发日、强势趋势）
阶段 3：提供背景建议

根据市场状态，提供补充建议：

如果 FTD 已确认（评分 60 以上）：

  • 建议关注处于合适底部形态中的领先股票
  • 推荐使用 CANSLIM 选股器寻找候选股票
  • 提醒注意仓位规模和止损

如果处于反弹尝试阶段（第 1-3 天）：

  • 建议耐心等待，不要在 FTD 出现前买入
  • 建议建立观察名单

如果没有回调：

  • 上升趋势中不适用 FTD 分析
  • 转而使用 Market Top Detector 检测防御性信号

状态机

NO_SIGNAL → CORRECTION → RALLY_ATTEMPT → FTD_WINDOW → FTD_CONFIRMED
                ↑              ↓               ↓              ↓
                └── RALLY_FAILED ←─────────────┘     FTD_INVALIDATED
状态定义
NO_SIGNAL上升趋势中，没有符合条件的回调
CORRECTION下跌 3% 以上且有 3 个以上下跌日
RALLY_ATTEMPT从波段低点反弹的第 1-3 天
FTD_WINDOW第 4-10 天，等待符合条件的 FTD
FTD_CONFIRMED检测到有效的 FTD 信号
RALLY_FAILED反弹跌破波段低点
FTD_INVALIDATED收盘价跌破 FTD 当日低点

质量评分（0-100）

评分信号仓位
80-100强势 FTD75-100%
60-79中等 FTD50-75%
40-59弱势 FTD25-50%
<40无 FTD / 失败0-25%

前提条件

  • **FMP API 密钥：**必需。设置 FMP_API_KEY 环境变量，或通过 --api-key 标志传入。
  • **Python 3.8+：**需安装 requests 库。
  • **API 调用额度：**每次执行 4 次调用（远低于 FMP 免费套餐每天 250 次的限额）。

输出文件

  • JSON：ftd_detector_YYYY-MM-DD_HHMMSS.json
  • Markdown：ftd_detector_YYYY-MM-DD_HHMMSS.md

参考文档

skills/ftd-detector/references/ftd_methodology.md
  • O'Neil FTD 规则详解
  • 反弹尝试机制和交易日计数
  • 历史 FTD 示例（2020 年 3 月、2022 年 10 月）
skills/ftd-detector/references/post_ftd_guide.md
  • FTD 后分布日的失败率
  • Power Trend 的定义和条件
  • 成功与失败模式对比
何时加载参考资料
  • 首次使用： 加载 skills/ftd-detector/references/ftd_methodology.md，以全面了解相关内容
  • 关于 FTD 后的问题： 加载 skills/ftd-detector/references/post_ftd_guide.md
  • 常规执行： 无需参考资料——脚本会处理分析

评论

支持 Markdown