stockbee-episodic-pivot-analyzer

Stockbee Episodic Pivot 分析器

结合催化剂质量和价格／成交量确认，对第 1 天的 Episodic Pivot（EP）候选标的进行分类。此技能用于评估候选标的质量，并非交易执行引擎。

适用场景

• 用户询问 Pradeep Bonde / Stockbee 风格的 EP 候选标的
• 用户提供了财报、业绩指引、并购、FDA、分析师、合同、产品、逼空或主题／新闻事件
• 用户希望将 ACTIONABLE_DAY1 候选标的与 DELAYED_EP_WATCH 名单区分开
• 用户希望将优质财报／业绩指引 EP 候选标的移交给 pead-screener
• 用户希望结合催化剂分析与 stockbee-momentum-burst-screener 的价格／成交量输出

前置条件

• Python 3.10+
• 可选：用于 OHLCV 数据补充的 FMP API 密钥
• 以下任一输入：
  • 催化剂／事件 JSON
  • earnings-trade-analyzer JSON 输出
  • 催化剂 JSON 以及 stockbee-momentum-burst-screener JSON 补充数据
• 此技能不会自行获取或发现新闻。如果未提供催化剂，请先使用用户偏好的新闻或研究流程收集事件／新闻背景。

工作流

步骤 1：准备候选标的输入

使用以下一种或多种输入模式。

模式 A — 催化剂／事件 JSON：

{
  "events": [
    {
      "symbol": "ABC",
      "event_date": "2026-04-25",
      "catalyst_type": "guidance_raise",
      "headline": "ABC raises FY guidance after record demand",
      "summary": "Management raised revenue and EPS guidance."
    }
  ]
}

模式 B — 财报流程：

使用 earnings-trade-analyzer 生成的 JSON。

模式 C — 价格／成交量补充数据：

传入 stockbee-momentum-burst-screener JSON 报告，以复用日涨幅、成交量、收盘位置和风险距离字段。

步骤 2：运行分析器

# Catalyst JSON + offline OHLCV
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --events-json data/catalysts.json \
  --prices-json data/daily_ohlcv.json \
  --output-dir reports/

# Earnings pipeline input
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --earnings-json reports/earnings_trade_analyzer_YYYY-MM-DD_HHMMSS.json \
  --output-dir reports/

# Catalyst JSON + Stockbee momentum enrichment
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --events-json data/catalysts.json \
  --momentum-json reports/stockbee_momentum_burst_YYYY-MM-DD_HHMMSS.json \
  --output-dir reports/

可选的 FMP 数据补充：

export FMP_API_KEY=your_key
python3 skills/stockbee-episodic-pivot-analyzer/scripts/analyze_ep.py \
  --events-json data/catalysts.json \
  --max-api-calls 200 \
  --output-dir reports/

步骤 3：查看输出

针对每个候选标的，提供：

• state：ACTIONABLE_DAY1、DAY1_WATCH、DELAYED_EP_WATCH、CATALYST_WATCH 或 REJECT
• ep_type：EARNINGS_EP、GUIDANCE_EP、FDA_EP、M_AND_A_EP、STORY_EP 等
• 催化剂质量评分及原因
• 价格／区间扩张、成交量冲击和收盘位置质量
• 距 EP 日低点的风险
• pead_handoff 和 delayed_ep_watch 标记

步骤 4：移交规则

• ACTIONABLE_DAY1：任何交易决策前，先发送给 technical-analyst 和 position-sizer。
• DAY1_WATCH：保留在盘中／次日观察名单中；需有图表确认。
• DELAYED_EP_WATCH：第 1 天不要追涨；关注有序回调或新区间。
• CATALYST_WATCH：催化剂可能很重要，但价格／成交量确认尚不足。
• REJECT：不要根据此候选标的来源进行交易。
• 带有 pead_handoff=true 的财报／业绩指引 EP，可发送给 pead-screener，以监测周线红色蜡烛／延迟反应。

输出

• stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.json — 结构化 EP 评分报告
• stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.md — 易读的候选标的报告

资源

• references/ep_methodology.md — Stockbee EP 解读和形态分类
• references/catalyst_quality.md — 催化剂分类和质量评分
• references/handoff_rules.md — 下游工作流移交及审查规则

共用 FMP 客户端

实时 FMP 访问使用随附生成的 scripts/fmp_client.py，仅在 FMP 运行开始时加载，因此离线模式无需 requests 也能运行。CLI 密钥／环境变量优先级、API 调用预算和成功输出结构均保持不变。请求仅使用稳定端点；稳定请求被拒绝、无返回或失败时，不会回退到已弃用的 v3 URL。共用客户端会屏蔽原始密钥和 URL 编码密钥回显；遇到格式错误的 JSON 时重试一次；遇到 429 时，等待 60 秒后最多重试一次，若再次触发速率限制则停止。