Anthropic Status Bot

Discord bot that monitors Anthropic's status page and provides real-time updates.

🔄 Python version of peltae's Anthropic Status Bot (originally in JavaScript)

📦 Repository: github.com/PierrunoYT/anthropic-status-bot

---

🌟 Features

📊 Live Status Dashboard

• Real-time status monitoring with in-place updates
• Rich Discord embed formatting:
  • 🟢 Color-coded status indicators (operational: green, degraded: yellow, outage: red)
  • ⚪ Smart status dots (● for operational/resolved, ○ for issues)
  • 📝 Hierarchical component layout with proper indentation
  • ⚡ Active incident tracking with impact levels
  • 🕒 User-friendly timestamp formatting with divider line
  • 📅 Detailed incident updates with UTC timestamps

🔔 Incident Management

• Impact level tracking (minor/major/critical)
• Intelligent component status tracking:
  • Duplicate detection with configurable expiry window
  • Detailed state comparison and change detection
  • Timestamp tracking for each component

🛡️ Robust Error Handling

• Exponential backoff retry mechanism
• Configurable retry attempts and timeouts
• Structured logging with detailed formatting:
  • Request logging with duration tracking
  • Error logging with context and stack traces
  • Multiple log levels (info, warn, error, debug)
  • UTC timestamp standardization

🔍 Monitoring Capabilities

• Configurable component filtering
• Custom user agent support
• Cache control
• Flexible HTML parsing with configurable selectors

🎯 Monitored Components

• console.anthropic.com
• api.anthropic.com
• api.anthropic.com - Beta Features
• anthropic.com

---

🚀 Getting Started

Requirements

• Python 3.9 or higher
• pip (Python package installer)

Local Setup

1. Clone and Create Virtual Environment

git clone https://github.com/PierrunoYT/anthropic-status-bot.git
cd anthropic-status-bot
python -m venv venv

# Activate virtual environment
# On Windows:
.\venv\Scripts\activate
# On Unix or MacOS:
source venv/bin/activate

2. Install Dependencies

pip install -r requirements.txt

3. Configure Environment

# Copy example environment file
cp .env.example .env

# Edit .env file with your settings:
DISCORD_TOKEN=your_bot_token                # Discord bot token
DISCORD_CHANNEL_ID=your_channel_id          # Channel for status updates
CHECK_INTERVAL=5                            # Minutes between checks (minimum: 1)
LOG_LEVEL=info                              # Logging level (info, warn, error, debug)

# Advanced Configuration (optional):
# Status Page Configuration:
STATUS__URL=https://status.anthropic.com    # Status page URL
STATUS__TIMEOUT=10000                       # Request timeout in ms
STATUS__RETRIES=3                          # Number of retry attempts
STATUS__USER_AGENT=AnthropicStatusBot/1.0  # Custom user agent

# Logging Configuration:
LOGGING__FORMAT="%(asctime)s - %(name)s - %(levelname)s - %(message)s"  # Log format
LOGGING__DATE_FORMAT="%Y-%m-%d %H:%M:%S"                               # Date format

4. Run the Bot

python start.py  # Single entry point that handles both path setup and bot startup

---

🏗️ Deployment

Sparked Host Setup

1. Upload files to your server
2. Set Python version to 3.9 or higher in server panel
3. Create .env file with your configuration
4. Start the bot using start.py or the control panel

Other Hosting Services

The bot is compatible with any Python hosting service that supports:

• Python 3.9+
• Virtual environments
• Environment variables
• Background processes

---

🧪 Testing

Run the test suite to verify embed formatting and functionality:

Using pytest directly:

# Activate virtual environment if not already active
.\venv\Scripts\activate  # Windows
source venv/bin/activate  # Unix/MacOS

# Run tests
python -m pytest src/tests/test_bot.py -v

Using provided test runners:

# On Windows:
.\run_tests.ps1

# On Unix/MacOS:
python run_test.py

Test Coverage

The test suite verifies:

• Status embed formatting and structure:
  • Color codes and status indicators
  • Component hierarchy and indentation
  • Timestamp formatting
  • Status dot logic
• Component status tracking:
  • State changes and updates
  • Status level determination
• Incident handling:
  • Impact level assessment
  • Update tracking
  • Resolution detection

---

🛠️ Development

Tech Stack

The bot is built with:

• discord.py - Discord API wrapper
• beautifulsoup4 - HTML parsing
• requests - HTTP client
• pydantic - Data validation
• APScheduler - Task scheduling
• python-dotenv - Environment variable management
• tenacity - Retry handling
• lxml - XML/HTML processing

---

📄 License

This project is licensed under the MIT License