explaingit

ourongxing/newsnow

★ 20,291TypeScriptAudience · vibe coderComplexity · 3/5MaintainedLicenseSetup · hard

TLDR

A self-hosted news reader that aggregates trending headlines from multiple sources into a clean dashboard, with smart caching and AI assistant integration via MCP.

Mindmap

mindmap
  root((NewsNow))
    What it does
      Aggregates trending news
      Caches results 30 min
      Adaptive scraping
    Features
      GitHub OAuth login
      Force refresh option
      MCP for AI access
    Deployment
      Cloudflare Pages
      Vercel
      Docker support
    Tech Stack
      TypeScript
      Cloudflare D1
      GitHub OAuth

Things people build with this

USE CASE 1

Deploy a personal news dashboard that pulls trending headlines from your favorite sources without ads or algorithmic feeds.

USE CASE 2

Build a custom news aggregator for a team or community by adding your own data sources and deploying it on serverless infrastructure.

USE CASE 3

Connect a running NewsNow instance to an AI assistant via MCP to let it fetch current headlines and summarize news programmatically.

Tech stack

TypeScriptCloudflare PagesVercelCloudflare D1DockerGitHub OAuth

Getting it running

Difficulty · hard Time to first run · 1day+

Requires Cloudflare D1 database setup, GitHub OAuth credentials, and multiple external service configurations (Cloudflare Pages, Vercel, MCP integration).

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

NewsNow is an elegant news reader application that aggregates real-time trending news from multiple sources into a clean, readable interface. Rather than overwhelming users with raw feeds, it focuses on presenting the hottest and most current news in a visually polished way. The application scrapes news sources at an adaptive interval, no more frequently than every 2 minutes, and caches results for 30 minutes by default. This prevents overloading the sources or triggering IP bans. Users who log in via GitHub can force a refresh to get the latest data immediately. Login is done through GitHub's OAuth system, which synchronizes user data. It also supports MCP (Model Context Protocol), a standard for letting AI assistants access external tools. This means you can point an AI assistant at a running NewsNow instance to retrieve current headlines programmatically. Deployment is straightforward: fork the repository and import it to Cloudflare Pages or Vercel with a single build command. For the full login and caching features, you configure GitHub OAuth credentials and connect a database, Cloudflare D1 is the recommended option. Docker deployment is also supported. The project is written in TypeScript and currently focuses on Chinese-language news sources, with English content support planned. You would use NewsNow if you want a self-hosted, cleanly designed news aggregation dashboard you can customize with your own data sources and deploy on serverless platforms.

Copy-paste prompts

Prompt 1
How do I fork NewsNow and deploy it to Cloudflare Pages with GitHub OAuth login?
Prompt 2
Show me how to add custom news sources to NewsNow and adjust the scraping interval.
Prompt 3
How do I set up MCP in NewsNow so my AI assistant can fetch live headlines?
Prompt 4
What's the best way to configure Cloudflare D1 as the database for NewsNow caching?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.