用途：通过量化六项评分（总分 0-100）评估市场见顶概率，聚焦未来 2-8 周、10-20% 级别回调的战术择时信号。六项包括：派发日数量（25%）、龙头股健康度（20%）、防御性板块轮动（15%）、市场宽度背离（15%）、指数技术状况（15%）、情绪与投机（10%）。评分对应绿（0-20）、黄（21-40）、橙（41-60）、红（61-80）、危急（81-100）风险区间及建议仓位操作。
使用方式：需设置 $FMP_API_KEY 或传 --api-key，费用层级免费即可（每次约 33 次 API 调用）；还需 WebSearch 获取 S&P 500 50 日均线以上比例和 CBOE 股票看跌/看涨比率，数据须来自最近 3 个交易日。200 日均线宽度由脚本从 TraderMonty CSV 自动获取，可用 --breadth-200dma 覆盖或 --no-auto-breadth 关闭。运行命令：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]"。脚本抓取 S&P 500、QQQ、VIX 及龙头 ETF（ARKK、WCLD、IGV、XBI、SOXX、SMH、KWEB、TAN）与板块 ETF 数据，输出 JSON 与 Markdown 报告。
适用场景：判断是否临近见顶、是否应减仓、派发日累积、防御板块跑赢成长、龙头股先于指数走弱等。限制：依赖 FMP 与 WebSearch 外部数据，保证金债务通常滞后 1-2 个月，数据陈旧会降低质量，具体效果未提供。