SOURCES & METHOD
How the news feed works.
The site uses Google News RSS search feeds as discovery inputs. Google News determines which publisher results appear in those feeds; this site then normalizes, de-duplicates, categorizes, and displays the returned headlines.
Configured searches
- “democratic Iran”
- “Iran democracy”
- “Iran civil society”
- “Iran human rights”
- “Iran economy”
- “Iran culture”
- “Iran diaspora”
What is displayed
For each item, the site stores the headline, original Google News result link, publisher name, publication time, and the search category that surfaced it. It does not copy full articles.
Ordering
Items are ordered newest-first. Similar URLs and normalized headlines are de-duplicated. The site does not assign political scores or endorse the views of a publisher merely by displaying its headline.
Automation
A GitHub Actions workflow runs on a schedule and can also be run manually. It updates data/news.json, commits only when the feed changes, and lets GitHub Pages redeploy the static site.
Source caution
Headlines can contain disputed claims, analysis, or opinion. Readers should open the original article, consider the publisher, and compare reporting across sources.