用途:按 Mark Minervini 的波动收缩形态(VCP)筛选标普500股票,寻找处于第二阶段上升趋势、波动收缩、接近突破枢轴的标的;也可对单一股票的多历史区间检测曾出现过的每个 VCP,并附突破、止损触发或超时等前瞻结果,供形态研究与回测参考,而非实时筛选。
主要能力:三段式流水线——基于报价的预筛选、7 点第二阶段趋势模板过滤、VCP 形态分析与评分报告生成。输出带时间戳的 JSON 与 Markdown 报告,包含综合评分、执行状态(Pre-breakout/Breakout 等)、形态类型、收缩深度与比率、枢轴价、止损、风险百分比、成交量枯竭与突破量评分、相对强度排名。严格模式仅返回 valid_vcp=True 且执行状态为 Pre-breakout 或 Breakout 的股票。历史模式需 --history 与 --ticker,输出逐次检测时间线及前瞻结果,检测按 T1 高点日期、最后低点日期与枢轴去重。
使用方式:需 FMP API 密钥(设置 FMP_API_KEY 或传 --api-key)。免费额度每日 250 次调用,默认筛选前 100 个候选足够;完整标普500筛选建议付费额度。默认命令:python3 skills/vcp-screener/scripts/screen_vcp.py --output-dir skills/vcp-screener/scripts;自定义股票池用 --universe AAPL NVDA MSFT AMZN META;全标普500用 --full-sp500;严格模式加 --strict。历史模式示例:python3 skills/vcp-screener/scripts/screen_vcp.py --history --ticker FIX --output-dir reports/,可配 --stride-days、--outcome-days,并可用 --min-contractions、--t1-depth-min、--breakout-volume-ratio、--trend-min-score、--atr-multiplier 等参数做回测调优。
适用场景:VCP 筛选、Minervini 式形态查找、紧凑底部与波动收缩识别、第二阶段动能股扫描、具明确风险的突破候选,以及单只股票历史 VCP 研究。
限制:历史模式仅两次 FMP API 调用(个股与 SPY 历史),市值与绝对 RS 百分位反映个股孤立情况,不代表实时筛选池;该报告用于形态研究而非组合仓位计算。其余功能未提供。