📰 hacker-feeds-cli

A command line tool for Hacker News、 Product Hunt、 GitHub Trending 、Reddit and V2EX feeds.

Usage

# install
> npm install -g hacker-feeds-cli
# command option
> hfeeds help
# hf for short
> hf news
# JSON output (for automation/chat paste)
> hf --json github -s daily -l javascript
# config cli
> hf config
# optional: set Product Hunt token
> hf config --ph-token <token>
# optional: use env var instead
> export HF_PRODUCTHUNT_TOKEN=<token>

Local Checks

npm test
npm run smoke
npm run smoke:live

JSON Output

Use --json before any sub command:

hf --json github -s daily -l javascript
hf --json news -t 5
hf --json reddit -t popular -s top

To send in chat, paste output inside a fenced block:

{ "source": "github", "items": [] }

Resource Support

Because most of the web servers are located abroad, please make sure your network can access the above website properly. You can try pinging the following domains.

ping github.com
ping www.v2ex.com
ping hacker-news.firebaseio.com
ping api.producthunt.com
ping www.reddit.com

• GitHub
• Hacker News
• Product Hunt
• Reddit
• V2EX

Resource	Sub Command	Parameters	Screenshot
GitHub	github	-l, --lang -s, --since
Product Hunt	product	-c, --count -p, --past
Hacker News	news	-t --top
Reddit	reddit	-t --topic -s --sort
V2EX	v2ex	-n --node

Product Hunt Setup

The Product Hunt feed requires a free API token (the other four feeds work without any key).

1. Visit api.producthunt.com/v2/oauth/applications
2. Sign in and click Add an Application
3. Set any name and https://localhost as the redirect URI
4. Open the app and generate a Developer Token

Then configure the CLI:

# Option A: environment variable (add to .bashrc / .zshrc to persist)
export HF_PRODUCTHUNT_TOKEN="your-token"

# Option B: CLI config (saved to ~/.hacker-feeds-cli/config.json)
hf config --ph-token your-token

Verify it works:

hf product -c 3
# or in JSON mode
hf --json product -c 3

Language Support

Input sub-command config to config cli language.

> hf config
? Please select a language(Default EN):  (Use arrow keys)
  EN（English）
❯ ZH（简体中文）

TODO

• i18n support
• Accept resouce param
• Hyper link support
• Support Translate
• Add more resource

API References

• Hacker News API
• Product Hunt API
• GitHub Trending API
• Reddit API
• V2EX API