https://github.com/stjohnjohnson/reddit-watcher

Simple bot to scan /r/mechmarket looking for specific sales
https://github.com/stjohnjohnson/reddit-watcher

Last synced: about 1 year ago
JSON representation

Simple bot to scan /r/mechmarket looking for specific sales

• Host: GitHub
• URL: https://github.com/stjohnjohnson/reddit-watcher
• Owner: stjohnjohnson
• License: mit
• Created: 2018-04-28T23:23:32.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2018-06-02T06:30:16.000Z (about 8 years ago)
• Last Synced: 2025-04-10T00:46:58.436Z (about 1 year ago)
• Language: Go
• Homepage: https://hub.docker.com/r/stjohnjohnson/reddit-watcher/
• Size: 81.1 KB
• Stars: 19
• Watchers: 2
• Forks: 2
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Reddit Watcher

[![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)

Watches specific subreddits (`/r/mechmarket`) for items matching a specific pattern.

## Running the Bot

Running 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).

Once you have that, start up your server with the following command:

```bash

docker run -v `pwd`/config:/config stjohnjohnson/reddit-watcher:latest --token ${TELEGRAM_TOKEN}

```

In this example, I'm running the container with settings being saved to a local directory.

## Using the Bot

The bot responds to private or group messages that look like a command (start with a `/`).

### Notification

The 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.

#### `/selling `

Look for items matching that keyword that are being sold.  Sold means the listing includes "cash" or "paypal" in the "want" field.

#### `/buying `

Look for items matching that keyword that are being bought.  Sold means the listing includes "cash" or "paypal" in the "have" field.

#### `/vendor `

Look for items matching that keyword posted by a vendor.

#### `/artisan `

Look for items matching that keyword posted by an artisan.

#### `/groupbuy `

Look for items matching that keyword posted as a group buy.

#### `/interestcheck `

Look for items matching that keyword posted as an interest check.

#### `/giveaway `

Look for items matching that keyword posted as a giveaway.

### Other

#### `/help`

Replies with a simple help message listing all the available commands.

#### `/items`

Outputs a list of your keywords and the number of matches found so far.

#### `/stats`

Outputs interesting information about the current bot.