Horlarmeday/breaking-news-africa

# NNB NEWS ALERT A Node.js application that monitors RSS feeds from major news outlets (BBC, CNN, Al Jazeera, MSNBC, Sky News) for Nigerian news and sends real-time alerts via Telegram and Email. ## Features - 🎯 **News Filtering**: Filters for news relevant to Nigeria and West African countries - 🇳🇬 **Nigerian Context**: Comprehensive keyword matching for Nigerian cities, states, politicians, organizations - 📰 **Multi-Source Monitoring**: Monitors RSS feeds from 5 major international news outlets - 🤖 **Telegram Alerts**: Real-time notifications via Telegram bot - 📧 **Email Alerts**: Detailed email notifications - 🚫 **Duplicate Prevention**: Prevents duplicate alerts for the same story - ⏰ **Rate Limiting**: Configurable alert frequency limits - 📊 **Logging & Statistics**: Comprehensive logging and system statistics ## Implementation Status ### Phase 1: ✅ COMPLETED - ✅ RSS Feed Monitoring - ✅ Nigerian Keyword Filtering - ✅ News Filtering - ✅ Duplicate Prevention - ✅ Logging System - ✅ Rate Limiting - ✅ Configuration Management ### Phase 2: ✅ COMPLETED - ✅ Telegram Bot Integration - ✅ Email SMTP Notifications - ✅ Rich HTML Email Templates - ✅ Markdown Telegram Formatting - ✅ Notification Rate Limiting - ✅ Graceful Error Handling - ✅ Connection Testing - ✅ System Status Reports ### Phase 3: ✅ COMPLETED - ✅ Social Media Scraping (Twitter/X, Facebook) - ✅ Browser Automation with Puppeteer - ✅ Anti-Bot Measures (User agents, delays, error handling) - ✅ Unified Processing Pipeline (RSS + Social) - ✅ Cross-Platform Deduplication - ✅ Social Media Rate Limiting - ✅ Separate Scheduling for Social Monitoring - ✅ Comprehensive Social Statistics ## Installation 1. **Clone and Install** ```bash git clone cd breaking-news-alerts npm install ``` 2. **Configure Environment** ```bash cp .env.example .env nano .env # Edit with your credentials ``` 3. **Required Environment Variables** ```env # Telegram (Optional but recommended) TELEGRAM_BOT_TOKEN=your_bot_token TELEGRAM_CH …