About This Project

What is IranIsraelWarUpdates?

IranIsraelWarUpdates is a news aggregation platform that collects articles about the Iran-Israel/US conflict from 50+ international news sources. Every article is analyzed for editorial bias, and related articles are grouped into multi-perspective story clusters so readers can see how different outlets cover the same events.

The goal is to provide a comprehensive, transparent view of media coverage — not to determine what's "true" or "false," but to help readers understand different editorial perspectives and make their own informed judgments.

How It Works

1. Aggregation — Every 15 minutes, we fetch articles from 50+ RSS feeds, GDELT, and NewsData.io, covering sources from Iran, Israel, US, UK, Qatar, and other countries.
2. Deduplication — Duplicate articles are filtered out using URL normalization and title similarity matching.
3. Story Clustering — Related articles are grouped into story clusters using text similarity, enabling multi-perspective comparison.
4. Bias Classification — Each article receives a bias score based on its source and content analysis. Read our methodology.
5. Presentation — Stories are displayed with three-tab perspective views showing pro-Iran, neutral, and pro-Israel coverage side by side.

Technology

The entire platform runs at $0/month using free tiers of cloud services:

• Astro (SSR framework) on Cloudflare Pages
• Cloudflare D1 (SQLite database)
• Cloudflare R2 (object storage)
• Groq API (LLM bias classification)
• GitHub Actions (automated news fetching)

Open Source

This project is open source. You can view the code, report issues, or contribute on GitHub. Transparency is a core value — the algorithms, source ratings, and classification logic are all publicly auditable.

Contact

For questions, corrections, or feedback, please open an issue on the GitHub repository.