A command-line tool to fetch trending news and hot topics from 66 sources across 44 platforms. Built with TypeScript, runs on Bun.

Ported from ourongxing/newsnow server sources.

npm install -g newsnow

Or use directly with npx:

npx newsnow

# Show help
newsnow --help

# List all available sources
newsnow list

# Fetch news from a source
newsnow hackernews

# Output as JSON (pipeable to jq, etc.)
newsnow hackernews --json

# Pretty-print JSON
newsnow hackernews --json --pretty

# Limit number of items
newsnow hackernews --limit 5

# Select specific fields (JSON mode)
newsnow hackernews --json --fields title,url

# List sources as JSON
newsnow list --json

# Print machine-readable JSON Schema
newsnow schema

All --json output uses structured envelopes:

Fetch (newsnow <source> --json):

{ "source": "hackernews", "count": 30, "items": [...] }

List (newsnow list --json):

{ "count": 66, "sources": [{ "name": "hackernews", "category": "hackernews", "envVars": [] }, ...] }

Errors (written to stderr):

{ "error": "Unknown source \"foo\"", "code": "UNKNOWN_SOURCE", "suggestions": ["foobar"] }

66 source endpoints across 44 platforms:

Some sources require environment variables:

• producthunt requires PRODUCTHUNT_API_TOKEN

Some sources may be blocked by Cloudflare or require authentication:

• linuxdo, linuxdo-latest, linuxdo-hot - May return 403 Forbidden

bun test

• cheerio - HTML parsing
• ofetch - HTTP client
• dayjs - Date formatting
• iconv-lite - Character encoding

MIT