🚀 SpaceX IPO Notification Bot

A Python bot that monitors online sources every 5 minutes for news about SpaceX going public (IPO) and sends you alerts via WhatsApp (CallMeBot), Twilio SMS, or other notification providers.

• Multi-source monitoring: Google News RSS, SEC EDGAR filings, Reddit
• Two alert levels:
  • 🚀 CONFIRMED: SEC S-1 filings, official announcements
  • 📰 RUMOR: News articles, analyst predictions, community discussions
• Rumored date extraction: Automatically detects and includes mentioned IPO timeframes (e.g., "Q3 2026", "early 2027")
• Deduplication: Tracks seen articles to avoid duplicate notifications
• Rate limiting: Configurable max rumor SMS per hour to prevent spam
• Modular notification system: Easy to swap Twilio for another SMS/notification provider
• Graceful shutdown: Saves state on Ctrl+C

cd spacex_bot
pip install -r requirements.txt

Copy the example config and edit it:

cp config.example.py config.py

1. Each recipient sends this WhatsApp message to +34 644 21 77 47:

   I allow callmebot to send me messages
   

2. You'll receive an API key in the reply
3. Edit config.py:

NOTIFIER = "callmebot"

CALLMEBOT_RECIPIENTS = [
    {"phone": "+14155551234", "apikey": "123456"},
    # Add more recipients here
]

NOTIFIER = "twilio"

PHONE_NUMBERS = ["+14155551234"]
TWILIO_ACCOUNT_SID = "ACxxxxxxxx..."    # From twilio.com/console
TWILIO_AUTH_TOKEN = "your_auth_token"   # From twilio.com/console
TWILIO_FROM_NUMBER = "+15551234567"     # Your Twilio phone number

# Production mode (sends real SMS, runs continuously)
python spacex_ipo_bot.py

# Test mode (console output only, runs once, no SMS)
python spacex_ipo_bot.py --test

# Run a single check cycle with SMS then exit
python spacex_ipo_bot.py --once

spacex_bot/
├── spacex_ipo_bot.py    # Main bot orchestrator (scheduling, dedup, logic)
├── sources.py           # Source checkers (Google News, SEC EDGAR, Reddit)
├── notifier.py          # Abstract notifier interface + Twilio implementation
├── config.py            # Configuration (credentials, intervals, settings)
├── requirements.txt     # Python dependencies
└── README.md            # This file

1. Every 5 minutes, the bot queries all configured sources
2. Articles are classified as "confirmed" or "rumor" based on keyword matching
3. New articles (not previously seen) trigger SMS notifications
4. Confirmed alerts are always sent immediately
5. Rumor alerts are rate-limited (default: max 3 per hour)
6. Any mentioned dates/timeframes are extracted and included in the SMS

The notification system is modular. To add a new provider:

1. Create a new class in notifier.py that extends BaseNotifier:

class VonageNotifier(BaseNotifier):
    def __init__(self, api_key, api_secret, from_number, to_number):
        # ...

    def send_alert(self, message: str, alert_level: str) -> bool:
        # Your implementation here
        pass

2. Add it to the create_notifier() factory function:

elif notifier_type == "vonage":
    return VonageNotifier(...)

3. Update config.py:

NOTIFIER = "vonage"
VONAGE_API_KEY = "..."
VONAGE_API_SECRET = "..."

Create /etc/systemd/system/spacex-ipo-bot.service:

[Unit]
Description=SpaceX IPO Notification Bot
After=network.target

[Service]
Type=simple
User=your_username
WorkingDirectory=/path/to/spacex_bot
ExecStart=/usr/bin/python3 spacex_ipo_bot.py
Restart=on-failure
RestartSec=60

[Install]
WantedBy=multi-user.target

Then:

sudo systemctl enable spacex-ipo-bot
sudo systemctl start spacex-ipo-bot

screen -S spacex-bot
python spacex_ipo_bot.py
# Detach with Ctrl+A, D

Personal use.