Skip to content

Latest commit

 

History

History
74 lines (53 loc) · 2.21 KB

README.md

File metadata and controls

74 lines (53 loc) · 2.21 KB

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.