How mihai918/breaking_news works
This repository implements an automated breaking-news monitor that filters regional and global RSS items and delivers urgent alerts to Telegram. Its main flow is feed retrieval, recency/source checks, urgency scoring and deduplication, then alert formatting and delivery through the authenticated Telegram API; a separate authenticated MCP endpoint also offers health and send tools. The UI remains the unmodified Next.js starter page. The monitor implementation is sampled; the scheduled workflow details and protected-resource route implementation were not, so their behavior is not expanded here.
Main entry points: monitor-news.mjs Feed monitor · mcp/route.ts MCP tools · telegram/route.ts Alert endpoint · breaking-news-monitor.yml Scheduled workflow
Components 10
News monitoring
- Feed monitor
scripts/monitor-news.mjs - Sent-item state
data/breaking-news-state.json
Telegram delivery
- Alert endpoint
app/api/telegram/route.ts
MCP access
- MCP tools
app/api/mcp/route.ts - OAuth metadata route
app/.well-known/oauth-protected-resource/route.ts
Other components
- Scheduled workflow
.github/workflows/breaking-news-monitor.yml - RSS feeds
- Telegram Bot API
- MCP client
- Auth0 JWKS
Connections 9
- Scheduled workflow → Feed monitor: runs
- Feed monitor → RSS feeds: fetches feeds
- Feed monitor → Sent-item state: reads and writes
- Feed monitor → Alert endpoint: posts alert
- Alert endpoint → Telegram Bot API: sends message
- MCP client → MCP tools: calls tools
- MCP tools → Auth0 JWKS: verifies JWT
- MCP tools → OAuth metadata route: sets metadata path
- MCP tools → Telegram Bot API: sends message