用途:量化判断市场见顶概率,输出 0-100 综合评分并映射风险区间,聚焦未来 2-8 周可能出现 10-20% 回调的战术信号(区别于评估数月到数年泡沫破裂的 Bubble Detector)。适用于询问是否接近顶部、派发日累积、防御板块跑赢成长、领先股走弱而指数仍撑住、需要判断减仓时点等场景。
主要能力:6 项加权评分——派发日计数 25%、领先股健康度 20%、防御板块轮动 15%、市场宽度背离 15%、指数技术状态 15%、情绪与投机 10%。评分映射为绿(0-20)、黄(21-40)、橙(41-60)、红(61-80)、危急(81-100)五个风险区间,并给出风险预算与行动建议。脚本从 FMP API 获取 SP500、QQQ、VIX 行情,拉取领先 ETF(ARKK、WCLD、IGV、XBI、SOXX、SMH、KWEB、TAN)与板块 ETF(XLU、XLP、XLV、VNQ、XLK、XLC、XLY)数据,输出 JSON 与 Markdown 报告。
使用方式:需设置 $FMP_API_KEY 或传 --api-key(免费额度约每次执行 33 次调用),并通过 WebSearch 收集 50DMA 宽度与 CBOE Put/Call 数据。运行命令:python3 skills/market-top-detector/scripts/market_top_detector.py --api-key $FMP_API_KEY --breadth-50dma [VALUE] --breadth-50dma-date [YYYY-MM-DD] --put-call [VALUE] --put-call-date [YYYY-MM-DD] --vix-term [steep_contango|contango|flat|backwardation] --margin-debt-yoy [VALUE] --margin-debt-date [YYYY-MM-DD] --output-dir reports/ --context "Consumer Confidence=[VALUE]" "Gold Price=[VALUE]"。200DMA 宽度默认从 TraderMonty CSV 自动获取,可用 --breadth-200dma 覆盖、--no-auto-breadth 关闭;--vix-term 可覆盖自动检测。展示结果时需标注数据新鲜度(数据应来自最近 3 个交易日)、最强警告信号、历史对比、情景敏感性、建议行动与 Follow-Through Day 状态。
限制:依赖外部 API 与 WebSearch 数据,保证金债务数据通常滞后 1-2 个月;交易所日历按 XNYS 会话而非工作日计算,--as-of 仅用于实时评估日期,历史实时回放因报价端点非时点数据而会失败关闭。参考资料包括 methodology、distribution_day_guide 与 historical_tops 文档,常规执行无需加载。