lawxls / hackernews-alerts-bot

Telegram bot for all kinds of notifications from Hacker News

HackerNews Alerts Bot

Telegram bot for all kinds of notifications from Hacker News

---

commands

---

Features:

• Keyword monitoring
• Follow users
• Subscribe to a thread
• Stories by domain names
• 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

hackernews-alerts-bot's Issues

feature idea: follow user, get notified of new posts

thanks for dropping this in HN: just throwing this in here as a feature idea!

https://news.ycombinator.com/item?id=35117535

Stopped responding to commands

Has not responded to commands for many days, but continues to send news

Considering supporting more sources (like Reddit)?

Thank you for the awesome project 💪🏻
I usually monitor keywords on both Hacker News, Reddit, and other platforms, and I'm sure many others do the same.
It would be awesome if your project could support more platforms (like kwatch.io does for example, except that they don't provide a Telegram integration).
If you can't no worries and I would like to thank you again for your project!