A CLI for reading the news and getting the latest headlines including search functionality. Supports over 70 sources.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
src v1.0.2 Sep 17, 2018
.gitignore initial commit Oct 3, 2017
LICENSE Initial commit Oct 3, 2017
README.md Update README.md Oct 5, 2017
package-lock.json 1.0.1 Sep 17, 2018
package.json v1.0.2 Sep 17, 2018
yarn.lock updating to use the latest version of news CLI with search functionality Sep 17, 2018


clinews 🌍 📰 💻

npm npm license

A CLI for reading the news which supports over 70 sources. Get all the latest headlines from around the world without leaving your terminal. Powered by NewsAPI.org.

clinews allows you to:

  • Fetch all the latest stories from a particular news source
  • List all possible news sources the API provides
  • Search across all the sources for a particular word or phrase in the title.


Note: You must be on node version 7.6.0 or later to use clinews.


npm i -g clinews


yarn global add clinews


Fetch stories from a source

Fetch all the latest news stories from bbc-news:

news fetch bbc-news

other examples...

news fetch techcrunch
news fetch hacker-news

List all news sources

Show all the sources you can get news from. Use the Fetch Id field with the fetch command to get news for that source.

news sources

Search for news stories across all sources matching search criteria

You can search across all 70+ news sources to find stories with a title matching your criteria. For example, to find all news stories with titles containing the words "Donald Trump" you can execute the following. Note that searches are also case insensitive. The 2 commands below are equivalent.

news search "Donald Trump"


news search "donald trump"


clinews supports some extra flags as well. See below:

-V, --version              output the version number
-l, --limit <limit>        limit the amount of news stories you want to see.
-s, --sort <sort>          sort to apply to the news stories, Choices include top, latest or popular.
-c, --category <category>  category of sources you want to see. Choices include: business, entertainment, gaming, general, music, politics, science-and-nature, sport, technology.
-h, --help                 output usage information

You can run news --help to get this information at any time.