About newsnow
newsnow is a CLI for fetching trending news and topics from a range of sources. It lets users list available sources and retrieve readable or JSON-formatted items, including titles, links, and optional metadata.
Key features
- 01List available news sources
- 02Fetch news from a chosen source
- 03Output structured JSON items
- 04Return titles, links, and optional metadata
Use cases
- 01Check trending items from a source such as Hacker News
- 02Read the source list programmatically
- 03Pipe news titles and links into command-line processing
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/newsnowin Claude Code to confirm it loaded.
Details
From the project READMEnewsnow CLI
Fetch trending news and hot topics from 66 sources across 44 platforms. Returns news items with title, URL, and optional metadata.
Run newsnow --help for usage details.
Workflow
Follow this pattern:
- List - Don't know what sources are available? List them first.
- Fetch - Know the source? Fetch news directly.
- JSON - Need structured data? Add
--jsonfor machine-readable output.
| Need | Command | When |
|---|---|---|
| See all sources | newsnow list | Don't know source names |
| See sources as JSON | newsnow list --json | Need source list programmatically |
| Get news | newsnow <source> | Know the source, want readable output |
| Get news as JSON | newsnow <source> --json | Need structured data for processing |
Commands
list
List all available sources.
newsnow list
newsnow list --json
Fetch a source
newsnow hackernews
newsnow hackernews --json
Output fields (JSON mode):
id- Unique item identifiertitle- News headlineurl- Link to the article (optional)pubDate- Publication date (optional)extra- Additional metadata like view counts, comments (optional)
Sources
66 source endpoints across 44 platforms:
| Platform | Sources |
|---|---|
| 36kr | 36kr, 36kr-quick, 36kr-renqi |
| Baidu | baidu |
| Bilibili | bilibili, bilibili-hot-search, bilibili-hot-video, bilibili-ranking |
| Cankaoxiaoxi | cankaoxiaoxi |
| Chongbuluo | chongbuluo, chongbuluo-hot, chongbuluo-latest |
| CLS | cls, cls-telegraph, cls-depth, cls-hot |
| Coolapk | coolapk |
| Douban | douban |
| Douyin | douyin |
| Fastbull | fastbull, fastbull-express, fastbull-news |
| FreeBuf | freebuf |
| Gelonghui | gelonghui |
| Ghxi | ghxi |
| GitHub | github, github-trending-today |
| Hacker News | hackernews |
| Hupu | hupu |
| iFeng | ifeng |
| iQIYI | iqiyi-hot-ranklist |
| ITHome | ithome |
| Jin10 | jin10 |
| Juejin | juejin |
| Kaopu | kaopu |
| Kuaishou | kuaishou |
| LinuxDo | linuxdo, linuxdo-latest, linuxdo-hot |
| MktNews | mktnews, mktnews-flash |
| Nowcoder | nowcoder |
| PCBeta | pcbeta-windows, pcbeta-windows11 |
| Product Hunt | producthunt |
| QQ Video | qqvideo-tv-hotsearch |
| SMZDM | smzdm |
| Solidot | solidot |
| Sputnik News CN | sputniknewscn |
| SSPai | sspai |
| Steam | steam |
| Tencent | tencent-hot |
| The Paper | thepaper |
| Tieba | tieba |
| Toutiao | toutiao |
| V2EX | v2ex, v2ex-share |
| Wall Street CN | wallstreetcn, wallstreetcn-quick, wallstreetcn-news, wallstreetcn-hot |
weibo | |
| Xueqiu | xueqiu, xueqiu-hotstock |
| Zaobao | zaobao |
| Zhihu | zhihu |
Source Selection Guide
| Category | Recommended Sources |
|---|---|
| Tech | hackernews, github, v2ex, juejin, ithome, linuxdo |
| Finance | xueqiu, wallstreetcn, cls, jin10, gelonghui, fastbull |
| General News | toutiao, baidu, thepaper, ifeng, zaobao, cankaoxiaoxi |
| Social/Trending | weibo, douyin, bilibili, zhihu, tieba, douban |
| Security | freebuf |
| Product/Design | producthunt, sspai |
Environment Variables
PRODUCTHUNT_API_TOKEN- Required forproducthuntsource
Known Limitations
linuxdo,linuxdo-latest,linuxdo-hotmay return 403 Forbidden (Cloudflare)- Some Chinese sources may be inaccessible from outside mainland China
Working with Results
newsnow hackernews --json | jq '.[].title'
newsnow hackernews --json | jq '.[:5]'
newsnow weibo --json | jq '.[] | "\(.title) \(.url)"'
Comments
Markdown supported