Skip to content

A CLI for reading the news and getting the latest headlines including search functionality. Supports over 70 sources.

License

Notifications You must be signed in to change notification settings

shogunpurple/clinews

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Installation

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

npm

npm i -g clinews

yarn

yarn global add clinews

Usage

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"

or

news search "donald trump"

Options

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.
-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.

About

A CLI for reading the news and getting the latest headlines including search functionality. Supports over 70 sources.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published