UNPKG

clinews

Version:

A command line interface for getting news stories from https://newsapi.org

75 lines (53 loc) • 2.26 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
# clinews :earth_africa: :newspaper: :computer: [![npm](https://img.shields.io/npm/dt/clinews.svg)](https://www.npmjs.com/package/clinews) [![npm](https://img.shields.io/npm/v/clinews.svg)](https://www.npmjs.com/package/clinews) [![license](https://img.shields.io/github/license/mmckeaveney/clinews.svg)](https://github.com/mmckeaveney/clinews/blob/master/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](https://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.