{"id":22669091,"url":"https://github.com/stjohnjohnson/reddit-watcher","last_synced_at":"2025-04-12T11:10:48.951Z","repository":{"id":82743288,"uuid":"131451197","full_name":"stjohnjohnson/reddit-watcher","owner":"stjohnjohnson","description":"Simple bot to scan /r/mechmarket looking for specific sales","archived":false,"fork":false,"pushed_at":"2018-06-02T06:30:16.000Z","size":83,"stargazers_count":19,"open_issues_count":7,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-10T00:46:58.436Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/stjohnjohnson/reddit-watcher/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stjohnjohnson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2018-04-28T23:23:32.000Z","updated_at":"2023-04-02T23:55:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"84788ea3-c5d6-460b-bd0f-10dce06fbc59","html_url":"https://github.com/stjohnjohnson/reddit-watcher","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stjohnjohnson%2Freddit-watcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stjohnjohnson%2Freddit-watcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stjohnjohnson%2Freddit-watcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stjohnjohnson%2Freddit-watcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stjohnjohnson","download_url":"https://codeload.github.com/stjohnjohnson/reddit-watcher/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248557844,"owners_count":21124168,"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":[],"created_at":"2024-12-09T15:18:28.389Z","updated_at":"2025-04-12T11:10:48.932Z","avatar_url":"https://github.com/stjohnjohnson.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reddit Watcher\n\n[![Current Release](https://img.shields.io/github/tag/stjohnjohnson/reddit-watcher.svg)](https://img.shields.io/github/tag/stjohnjohnson/reddit-watcher.svg)  [![CircleCI](https://circleci.com/gh/stjohnjohnson/reddit-watcher/tree/master.svg?style=shield)](https://circleci.com/gh/stjohnjohnson/reddit-watcher/tree/master) [![Coverage Status](https://coveralls.io/repos/github/stjohnjohnson/reddit-watcher/badge.svg?branch=master)](https://coveralls.io/github/stjohnjohnson/reddit-watcher?branch=master) [![Go Report Card](https://goreportcard.com/badge/github.com/stjohnjohnson/reddit-watcher)](https://goreportcard.com/report/github.com/stjohnjohnson/reddit-watcher) [![Docker Pulls](https://img.shields.io/docker/pulls/stjohnjohnson/reddit-watcher.svg)](https://hub.docker.com/r/stjohnjohnson/reddit-watcher/) [![Chat Now](https://img.shields.io/badge/telegram-MechKeyBot-blue.svg?style=social)](https://telegram.me/MechKeyBot)\n\nWatches specific subreddits (`/r/mechmarket`) for items matching a specific pattern.\n\n## Running the Bot\n\nRunning the bot is easy!  You just need a Telegram token that you can get from the [BotFather](https://core.telegram.org/bots#3-how-do-i-create-a-bot).\n\nOnce you have that, start up your server with the following command:\n\n```bash\ndocker run -v `pwd`/config:/config stjohnjohnson/reddit-watcher:latest --token ${TELEGRAM_TOKEN}\n```\n\nIn this example, I'm running the container with settings being saved to a local directory.\n\n## Using the Bot\n\nThe bot responds to private or group messages that look like a command (start with a `/`).\n\n### Notification\n\nThe most basic usage is to monitor for posts that match your keywords.  The following commands will subscribe (or unsubscribe) you on new posts matching your keywords.  If you leave the keyword empty, it defaults to `*` which is ALL posts.\n\n#### `/selling \u003ckeyword\u003e`\n\nLook for items matching that keyword that are being sold.  Sold means the listing includes \"cash\" or \"paypal\" in the \"want\" field.\n\n#### `/buying \u003ckeyword\u003e`\n\nLook for items matching that keyword that are being bought.  Sold means the listing includes \"cash\" or \"paypal\" in the \"have\" field.\n\n#### `/vendor \u003ckeyword\u003e`\n\nLook for items matching that keyword posted by a vendor.\n\n#### `/artisan \u003ckeyword\u003e`\n\nLook for items matching that keyword posted by an artisan.\n\n#### `/groupbuy \u003ckeyword\u003e`\n\nLook for items matching that keyword posted as a group buy.\n\n#### `/interestcheck \u003ckeyword\u003e`\n\nLook for items matching that keyword posted as an interest check.\n\n#### `/giveaway \u003ckeyword\u003e`\n\nLook for items matching that keyword posted as a giveaway.\n\n### Other\n\n#### `/help`\n\nReplies with a simple help message listing all the available commands.\n\n#### `/items`\n\nOutputs a list of your keywords and the number of matches found so far.\n\n#### `/stats`\n\nOutputs interesting information about the current bot.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstjohnjohnson%2Freddit-watcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstjohnjohnson%2Freddit-watcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstjohnjohnson%2Freddit-watcher/lists"}