hotnews CLI#

Fetch trending news and hot topics from 8 sources. Returns news items with title, URL, hot metric, and rank.

Run hotnews --help for usage details.

Workflow#

Follow this pattern:

1. List - Don't know what sources are available? List them first.
2. Fetch - Know the source? Fetch news directly.
3. JSON - Need structured data? Add --json for machine-readable output.

NeedCommandWhenSee all sourceshotnews listDon't know source namesGet newshotnews <source>Know the source, want readable outputGet news as JSONhotnews <source> --jsonNeed structured data for processingControl item counthotnews <source> --limit NWant specific number of results (1-50, default 10)

Commands#

list#

List all available sources.

bash

hotnews list

Fetch a source#

bash

hotnews baidu
hotnews baidu --json
hotnews weibo --limit 5
hotnews douyin -l 15 --json

Options#

FlagShortDescription--jsonOutput as JSON--limit N``-l NNumber of items to return (default: 10, max: 50)

Output fields (JSON mode):

• title - News headline
• url - Link to the article
• hot - Popularity metric, e.g. "871 stars today", "5.3k" (optional)
• rank - Position in the ranking (1-based)

Sources#

8 source endpoints:

PlatformIDDescriptionBaidubaiduBaidu real-time search trendsWeiboweiboWeibo real-time trending topicsDouyindouyinDouyin real-time trendingHupuhupuHupu street hot posts36Krkr3636Kr tech news flashesZhihuzhihuZhihu trending questionsJuejinjuejinJuejin developer community hot articlesGitHubgithubGitHub trending open source projects today

Source Selection Guide#

CategoryRecommended SourcesGeneral Newsbaidu, weibo, toutiaoSocial/Trendingweibo, douyin, zhihuTech/Developerjuejin, github, kr36Sports/Lifestylehupu

Working with Results#

bash

hotnews baidu --json | jq '.[].title'
hotnews baidu --json --limit 5
hotnews weibo --json | jq '.[] | "\(.rank). \(.title) \(.hot // "")"'
hotnews github --json | jq '.[] | "\(.title) - \(.hot)"'