Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lawxls/HackerNews-Alerts-Bot
Telegram bot for all kinds of notifications from Hacker News
https://github.com/lawxls/HackerNews-Alerts-Bot
hacker-news hackernews telegram telegram-bot
Last synced: about 1 month ago
JSON representation
Telegram bot for all kinds of notifications from Hacker News
- Host: GitHub
- URL: https://github.com/lawxls/HackerNews-Alerts-Bot
- Owner: lawxls
- Created: 2021-05-10T18:58:33.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-18T20:17:50.000Z (about 2 months ago)
- Last Synced: 2024-11-18T21:28:44.991Z (about 2 months ago)
- Topics: hacker-news, hackernews, telegram, telegram-bot
- Language: Python
- Homepage: https://t.me/hackernews_alerts_bot
- Size: 273 KB
- Stars: 47
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
HackerNews Alerts Bot
Telegram bot for all kinds of notifications from Hacker News
---
---
Features:
- [Keyword monitoring](https://github.com/lawxls/HackerNews-Alerts-Bot#keyword-monitoring)
- [Follow users](https://github.com/lawxls/HackerNews-Alerts-Bot#follow-users)
- [Subscribe to a thread](https://github.com/lawxls/HackerNews-Alerts-Bot#subscribe-to-a-thread)
- [Stories by domain names](https://github.com/lawxls/HackerNews-Alerts-Bot#stories-by-domain-names)
- [Comment replies](https://github.com/lawxls/HackerNews-Alerts-Bot#comment-replies)
## Keyword Monitoring
Create a personal feed of stories or monitor mentions of your brand, projects, or topics you're interested in.
To set up monitoring of story titles and comment bodies, simply add a keyword via the ```/add``` command: ```/add python```
To monitor only story titles, use the ```-stories``` option: ```/add python -stories```
In addition, the `/set_score` command can be used to receive stories only if they meet a specified score threshold (set to 1 by default).
Keyword search is implemented via a case-insensitive containment test.
## Follow Users
Follow a user to get notified of new posts and/or comments.
Use the ```/follow``` command to receive notifications when a user posts a new story or comment: ```/follow hnuser123```
Use the ```-stories``` or ```-comments``` option to monitor only stories or comments: ```/follow hnuser123 -stories```
## Subscribe to a Thread
Receive an alert when a new comment appears in a thread.
Subscribe to a thread by ID: `/subscribe 34971530`
## Stories by Domain Names
Add domain names to receive alerts whenever new stories are submitted.
Add a domain name: `/watch example.com`
Stories are affected by the `/set_score` command.
## Comment Replies
Receive notifications when someone replies to one of your comments.
Add your username: `/notify hnuser123`
## COMMANDS
### Keyword Monitoring
- **Add a Keyword**
```/add KEYWORD [-whole-word, -stories, -comments]```
If no options are specified, the bot will monitor both story titles and comments.
Options:
- ```-whole-word```
to match the entire word
- ```-stories```
to monitor only thread titles
- ```-comments```
to monitor only comments
Examples:
- ```/add project-name```
- ```/add python -stories```
- ```/add AI -whole-word -stories```
- ```/add machine learning -stories```
- **Set a Score Threshold**
```/set_score SCORE```
Receive stories only if they meet a specified score threshold (set to 1 by default).
- **List Keywords**
```/keywords```
- **Remove a Keyword**
```/remove KEYWORD```
### Follow Users
- **Follow a User**
```/follow USERNAME [-stories, -comments]```
If no options are specified, the bot will monitor new stories and comments.
Options:
- ```-stories```
to monitor only new stories
- ```-comments```
to monitor only comments
Examples:
- ```/follow hnuser123```
- ```/follow hnuser123 -stories```
- **List Followed Users**
```/followed_users```
- **Unfollow a User**
```/unfollow USERNAME```
### Subscribe to a Thread
- **Subscribe to a Thread**
```/subscribe ID```
- **List Subscriptions**
```/subscriptions```
- **Unsubscribe from a Thread**
```/unsubscribe ID```
### Stories by Domain Names
- **Follow a Domain Name**
```/watch DOMAIN NAME```
- **List Domain Names**
```/domains```
- **Unfollow a Domain Name**
```/abandon DOMAIN NAME```
### Comment Replies
- **Add a Username**
```/notify USERNAME```
- **Disable Notifications**
```/disable```
### General Commands
- **General Info**
```/help```
- **List of Commands**
```/commands```
- **Contacts**
```/contacts```
- **Stop the Bot and Delete Your Data**
```/stop```