stockbee-episodic-pivot-analyzer

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Stockbee Episodic Pivot Analyzer

Stockbee 事件性枢轴分析器

Classify Day 1 Episodic Pivot (EP) candidates using both catalyst quality and price/volume confirmation. The skill is a candidate-quality analyzer, not an execution engine.

基于催化剂质量和价格/成交量确认对首日事件性枢轴（Day 1 Episodic Pivot，EP）候选标的进行分类。本工具是候选标的质量分析器，而非执行引擎。

When to Use

使用场景

The user asks for Pradeep Bonde / Stockbee style EP candidates
The user provides earnings, guidance, M&A, FDA, analyst, contract, product, short-squeeze, or theme/news events
The user wants to separate
```
ACTIONABLE_DAY1
```
candidates from
```
DELAYED_EP_WATCH
```
names
The user wants to hand strong earnings/guidance EPs into
```
pead-screener
```
The user wants to combine catalyst analysis with
```
stockbee-momentum-burst-screener
```
price/volume output

用户询问Pradeep Bonde / Stockbee风格的EP候选标的
用户提供财报、业绩指引上调、并购、FDA、分析师、合同、产品、轧空或主题/新闻事件相关信息
用户希望将
```
ACTIONABLE_DAY1
```
候选标的与
```
DELAYED_EP_WATCH
```
标的区分开
用户希望将强劲财报/业绩指引的EP标的移交至
```
pead-screener
```
用户希望将催化剂分析与
```
stockbee-momentum-burst-screener
```
的价格/成交量输出相结合

Prerequisites

前置条件

Python 3.10+
Optional: FMP API key for OHLCV/profile enrichment
One of:
- Catalyst/events JSON
- ```
earnings-trade-analyzer
```
  JSON output
- Catalyst JSON plus
```
stockbee-momentum-burst-screener
```
  JSON enrichment
This skill does not fetch or discover news by itself. If the catalyst is not supplied, first gather the event/news context using the user's preferred news or research process.

Python 3.10+
可选：用于OHLCV/资料丰富的FMP API密钥
以下输入之一：
- 催化剂/事件JSON
- ```
earnings-trade-analyzer
```
  的JSON输出
- 催化剂JSON加上
```
stockbee-momentum-burst-screener
```
  的JSON增强数据
本工具不会自行获取或发现新闻。如果未提供催化剂，需先通过用户偏好的新闻或研究流程收集事件/新闻背景信息。

Workflow

工作流程

Step 1: Prepare Candidate Inputs

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

Use one or more of these input modes.

Mode A — Catalyst/event JSON:

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."
    }
  ]
}

Mode B — Earnings pipeline:

Use the JSON produced by

earnings-trade-analyzer

Mode C — Price/volume enrichment:

Pass a

stockbee-momentum-burst-screener

JSON report to reuse day-gain, volume, close-location, and risk-distance fields.

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

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

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报告，复用当日涨幅、成交量、收盘位置和风险距离字段。

Step 2: Run the Analyzer

步骤2：运行分析器

bash

undefined

bash

undefined

Catalyst JSON + offline OHLCV

催化剂JSON + 离线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

催化剂JSON + Stockbee动量增强

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/


Optional FMP enrichment:

```bash
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/

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增强：

```bash
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/

Step 3: Review the Output

步骤3：查看输出

For each candidate, present:

state

ACTIONABLE_DAY1

DAY1_WATCH

DELAYED_EP_WATCH

CATALYST_WATCH

, or

REJECT

ep_type

EARNINGS_EP

GUIDANCE_EP

FDA_EP

M_AND_A_EP

STORY_EP

, etc.

Catalyst quality score and reasons
Price/range expansion, volume shock, and close-location quality
Risk to EP-day low
```
pead_handoff
```
and
```
delayed_ep_watch
```
flags

针对每个候选标的，展示：

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
```
标记

Step 4: Handoff Rules

步骤4：移交规则

ACTIONABLE_DAY1

: Send to

technical-analyst

and

position-sizer

before any trade decision.

```
DAY1_WATCH
```
: Keep on the intraday/next-day watchlist; require chart confirmation.
```
DELAYED_EP_WATCH
```
: Do not chase Day 1; monitor for a controlled pullback or new range.
```
CATALYST_WATCH
```
: Catalyst may be important, but price/volume confirmation is not yet sufficient.
```
REJECT
```
: Do not trade from this candidate source.
Earnings/guidance EPs with
```
pead_handoff=true
```
can be sent to
```
pead-screener
```
for weekly red-candle / delayed reaction monitoring.

```
ACTIONABLE_DAY1
```
: 在做出任何交易决策前，发送至
```
technical-analyst
```
和
```
position-sizer
```
```
DAY1_WATCH
```
: 保留在日内/次日观察名单中；需要图表确认
```
DELAYED_EP_WATCH
```
: 不要追涨首日；监控是否出现可控回调或新区间
```
CATALYST_WATCH
```
: 催化剂可能重要，但价格/成交量确认尚不充分
```
REJECT
```
: 不要从此候选标的来源进行交易
带有
```
pead_handoff=true
```
的财报/业绩指引EP标的可发送至
```
pead-screener
```
，进行每周红K线/延迟反应监控

Output

输出

stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.json

— structured EP scoring report

stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.md

— human-readable candidate report

stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.json

— 结构化EP评分报告

stockbee_episodic_pivot_YYYY-MM-DD_HHMMSS.md

— 人类可读的候选标的报告

Resources

资源

```
references/ep_methodology.md
```
— Stockbee EP interpretation and setup taxonomy
```
references/catalyst_quality.md
```
— catalyst classification and quality scoring
```
references/handoff_rules.md
```
— downstream workflow handoffs and review rules

```
references/ep_methodology.md
```
— Stockbee EP解读和设置分类体系
```
references/catalyst_quality.md
```
— 催化剂分类和质量评分
```
references/handoff_rules.md
```
— 下游工作流移交和审核规则