{"id":13990501,"url":"https://github.com/lawxls/HackerNews-Alerts-Bot","last_synced_at":"2025-07-22T12:32:51.006Z","repository":{"id":39619546,"uuid":"366147277","full_name":"lawxls/HackerNews-Alerts-Bot","owner":"lawxls","description":"Telegram bot for all kinds of notifications from Hacker News","archived":false,"fork":false,"pushed_at":"2024-11-18T20:17:50.000Z","size":280,"stargazers_count":47,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-18T21:28:44.991Z","etag":null,"topics":["hacker-news","hackernews","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://t.me/hackernews_alerts_bot","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lawxls.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-10T18:58:33.000Z","updated_at":"2024-11-12T20:39:21.000Z","dependencies_parsed_at":"2023-09-26T05:24:08.418Z","dependency_job_id":"bfa3f4ba-9d8b-4699-a507-7a10db4b4f18","html_url":"https://github.com/lawxls/HackerNews-Alerts-Bot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawxls%2FHackerNews-Alerts-Bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawxls%2FHackerNews-Alerts-Bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawxls%2FHackerNews-Alerts-Bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lawxls%2FHackerNews-Alerts-Bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lawxls","download_url":"https://codeload.github.com/lawxls/HackerNews-Alerts-Bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227098817,"owners_count":17730642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacker-news","hackernews","telegram","telegram-bot"],"created_at":"2024-08-09T13:02:49.107Z","updated_at":"2024-11-29T10:30:46.125Z","avatar_url":"https://github.com/lawxls.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003eHackerNews Alerts Bot\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://t.me/hackernews_alerts_bot\"\u003e\u003cimg src=\"https://user-images.githubusercontent.com/76647266/207596416-8636a1aa-ccbb-4d9a-bcd6-ea7a22203c48.png\" alt=\"Telegram-bot\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\u003cem\u003eTelegram bot for all kinds of notifications from Hacker News\u003c/em\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/lawxls/HackerNews-personalized/actions\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://github.com/lawxls/HackerNews-personalized/workflows/Test/badge.svg\" alt=\"Test\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://results.pre-commit.ci/latest/github/lawxls/HackerNews-personalized/main\" target=\"_blank\"\u003e\n    \u003cimg src=\"https://results.pre-commit.ci/badge/github/lawxls/HackerNews-personalized/main.svg\" alt=\"pre-commit\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/lawxls/HackerNews-Alerts-Bot#commands\"\u003ecommands\u003c/a\u003e\u003c/p\u003e\n\n---\n\nFeatures:\n\n- [Keyword monitoring](https://github.com/lawxls/HackerNews-Alerts-Bot#keyword-monitoring)\n- [Follow users](https://github.com/lawxls/HackerNews-Alerts-Bot#follow-users)\n- [Subscribe to a thread](https://github.com/lawxls/HackerNews-Alerts-Bot#subscribe-to-a-thread)\n- [Stories by domain names](https://github.com/lawxls/HackerNews-Alerts-Bot#stories-by-domain-names)\n- [Comment replies](https://github.com/lawxls/HackerNews-Alerts-Bot#comment-replies)\n\n## Keyword Monitoring\nCreate a personal feed of stories or monitor mentions of your brand, projects, or topics you're interested in.\n\n![Screenshot_11](https://user-images.githubusercontent.com/76647266/207441549-4617e1c9-bdb6-41f9-8e91-cd93ce7d025e.png)\n![Screenshot_12](https://user-images.githubusercontent.com/76647266/207441488-cf3baad1-dc21-4a29-955a-48aed2f1a30f.png)\n\nTo set up monitoring of story titles and comment bodies, simply add a keyword via the ```/add``` command: ```/add python```\n\nTo monitor only story titles, use the ```-stories``` option: ```/add python -stories```\n\nIn addition, the `/set_score` command can be used to receive stories only if they meet a specified score threshold (set to 1 by default).\n\nKeyword search is implemented via a case-insensitive containment test.\n\n## Follow Users\nFollow a user to get notified of new posts and/or comments.\n\nUse the ```/follow``` command to receive notifications when a user posts a new story or comment: ```/follow hnuser123```\n\nUse the ```-stories``` or ```-comments``` option to monitor only stories or comments: ```/follow hnuser123 -stories```\n\n## Subscribe to a Thread\nReceive an alert when a new comment appears in a thread.\n\n![Screenshot_60](https://user-images.githubusercontent.com/76647266/221961215-95fa49f1-2d3f-4b2a-9cdd-7ddbc2cf1514.png)\n\nSubscribe to a thread by ID: `/subscribe 34971530`\n\n![Screenshot_62](https://user-images.githubusercontent.com/76647266/221963281-4c32d9c4-8847-411e-b7be-0a33c36071ea.png)\n\n## Stories by Domain Names\nAdd domain names to receive alerts whenever new stories are submitted.\n\nAdd a domain name: `/watch example.com`\n\nStories are affected by the `/set_score` command.\n\n## Comment Replies\nReceive notifications when someone replies to one of your comments.\n\nAdd your username: `/notify hnuser123`\n\n## COMMANDS\n\n### Keyword Monitoring\n\n- **Add a Keyword**\n\n  ```/add KEYWORD [-whole-word, -stories, -comments]```\n\n  If no options are specified, the bot will monitor both story titles and comments.\n\n  Options:\n\n    - ```-whole-word```\n      to match the entire word\n\n    - ```-stories```\n      to monitor only thread titles\n\n    - ```-comments```\n      to monitor only comments\n\n  Examples:\n\n    - ```/add project-name```\n\n    - ```/add python -stories```\n\n    - ```/add AI -whole-word -stories```\n\n    - ```/add machine learning -stories```\n\n- **Set a Score Threshold**\n\n  ```/set_score SCORE```\n\n  Receive stories only if they meet a specified score threshold (set to 1 by default).\n\n- **List Keywords**\n\n  ```/keywords```\n\n- **Remove a Keyword**\n\n  ```/remove KEYWORD```\n\n### Follow Users\n\n- **Follow a User**\n\n  ```/follow USERNAME [-stories, -comments]```\n\n  If no options are specified, the bot will monitor new stories and comments.\n\n  Options:\n\n    - ```-stories```\n      to monitor only new stories\n\n    - ```-comments```\n      to monitor only comments\n\n  Examples:\n\n    - ```/follow hnuser123```\n\n    - ```/follow hnuser123 -stories```\n\n- **List Followed Users**\n\n  ```/followed_users```\n\n- **Unfollow a User**\n\n  ```/unfollow USERNAME```\n\n### Subscribe to a Thread\n\n- **Subscribe to a Thread**\n\n  ```/subscribe ID```\n\n- **List Subscriptions**\n\n  ```/subscriptions```\n\n- **Unsubscribe from a Thread**\n\n  ```/unsubscribe ID```\n\n### Stories by Domain Names\n\n- **Follow a Domain Name**\n\n  ```/watch DOMAIN NAME```\n\n- **List Domain Names**\n\n  ```/domains```\n\n- **Unfollow a Domain Name**\n\n  ```/abandon DOMAIN NAME```\n\n### Comment Replies\n\n- **Add a Username**\n\n  ```/notify USERNAME```\n\n- **Disable Notifications**\n\n  ```/disable```\n\n### General Commands\n\n- **General Info**\n\n  ```/help```\n\n- **List of Commands**\n\n  ```/commands```\n\n- **Contacts**\n\n  ```/contacts```\n\n- **Stop the Bot and Delete Your Data**\n\n  ```/stop```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flawxls%2FHackerNews-Alerts-Bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flawxls%2FHackerNews-Alerts-Bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flawxls%2FHackerNews-Alerts-Bot/lists"}