X Tweet Fetcher

# Add a tweet to track
python3 scripts/tweet_growth_cli.py --add "https://x.com/user/status/123" "my launch tweet"
List all tracked tweets
python3 scripts/tweet_growth_cli.py --list
Run sampling (new tweets <48h, every 15min)
python3 scripts/tweet_growth_cli.py --run --fast
Run sampling (all tweets, hourly)
python3 scripts/tweet_growth_cli.py --run --normal
Generate analysis report
python3 scripts/tweet_growth_cli.py --report 123456789
Report with topic cross-analysis
python3 scripts/tweet_growth_cli.py --report 123456789 --cross

Cron Integration

# Dual-frequency sampling
*/15 * * * * python3 tweet_growth_cli.py --run --fast    # New tweets (<48h)
0 * * * *    python3 tweet_growth_cli.py --run --normal  # All tweets (hourly)

Detection Algorithm

| Component | Method | Purpose | |-----------|--------|---------| | Derivative detection | dV/dt per hour | Spot sudden acceleration | | Sliding window | 5-sample moving average | Filter noise | | Multi-signal fusion | views×1 + likes×1 + bookmarks×1.5 + RT×3 | Weighted composite score | | Burst confirmation | 3 consecutive windows above threshold | Prevent false positives | | Surge override | Single window +100%/h | Catch massive spikes | | Saturation | 6 samples < 2%/h growth | Detect long tail | | Propagation | RT-per-1k-views ratio | Influencer vs algorithm driven |

Output Example

🎯 Burst detected at 2026-03-14 08:45
   - Growth rate: 156%/h
   - Composite score: +2847 (views +1200, RT +89, likes +234)
   - Propagation: 12.3 RT/1k views (influencer-driven)