Stock Alert Workflow

Scan a watchlist and push alerts

uv run {baseDir}/scripts/earnings_surprise_alert.py --watchlist AAPL,MSFT,NVDA,GOOGL,META

Scan with custom surprise threshold

uv run {baseDir}/scripts/earnings_surprise_alert.py --watchlist AAPL,MSFT --threshold 15

Scan S&P 500 top holdings (built-in)

uv run {baseDir}/scripts/earnings_surprise_alert.py --sp500-top

Dry run (no WhatsApp push, print to console)

uv run {baseDir}/scripts/earnings_surprise_alert.py --watchlist AAPL,MSFT --dry-run

Scan with specific WhatsApp recipient

uv run {baseDir}/scripts/earnings_surprise_alert.py --watchlist AAPL,MSFT --whatsapp-to "+1234567890"

Output JSON for programmatic use

uv run {baseDir}/scripts/earnings_surprise_alert.py --watchlist AAPL,MSFT --output json

1. wacli must be installed and authenticated (wacli login) 2. Set the default recipient via environment variable:

export STOCK_ALERT_WHATSAPP_TO="+1234567890"

Or pass --whatsapp-to on each run.

Sending via wacli

The script shells out to:

wacli send --to "+1234567890" --text "..."