# mockingjay

> Create a twitter bot that follows a list and retweets tweets that match a regex pattern.

Latest version **1.3.0** (published 2015-03-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install mockingjay
pnpm add mockingjay
yarn add mockingjay
bun add mockingjay
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.3.0 |
| Published | 2015-03-30 |
| First published | 2014-03-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Known vulnerabilities | 0 (+2 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 100 |
| Maintainers | mhkeller |
| Keywords | regex, twitter, retweet, bot |

## Links

- npm: https://www.npmjs.com/package/mockingjay
- Repository: https://github.com/csvsoundsystem/mockingjay
- Issues: https://github.com/csvsoundsystem/mockingjay/issues
- npm.io page: https://npm.io/package/mockingjay

## Dependencies (2)

- [twit](https://npm.io/package/twit.md) ~1.1.12
- [underscore](https://npm.io/package/underscore.md) ~1.6.0

## Recent versions

- 1.3.0 (latest) — 2015-03-30
- 1.2.3 — 2014-06-10
- 1.2.2 — 2014-06-10
- 1.2.1 — 2014-06-10
- 1.2.0 — 2014-06-09
- 1.1.5 — 2014-06-09
- 1.1.4 — 2014-05-29
- 1.0.2 — 2014-05-13
- 1.0.1 — 2014-03-28
- 1.0.0 — 2014-03-28
- 0.1.4 — 2014-03-22
- 0.1.3 — 2014-03-12
- 0.1.2 — 2014-03-09
- 0.1.1 — 2014-03-09
- 0.1.0 — 2014-03-09
- … 2 more at https://npm.io/package/mockingjay/versions

## README

Mockingjay
===========

A Twitter API 1.1 script to make a Twitter bot that retweets tweets that contain words in a RegEx. Built off of <a href="https://github.com/abelsonlive/regextweet" target="_blank">RegEx Tweet</a>, 

It currently powers [@YourRepsOnGuns](http://twitter.com/yourrepsonguns), retweeting members of congress when they tweet about firearms and related words. Check out [that implementation](https://github.com/csvsoundsystem/yourrepsonguns) for a more advanced example.

We originally made this project when we were working at The Daily Beast and compiling every member of congress's stance on gun control for [This Is Your Rep On Guns](http://thedailybeast.thisisyourreponguns.com). Read more about that project and the origins of this bot [here](http://newsbeastlabs.tumblr.com/post/41373060897/update-feb-10-repsguntweets-has-been-changed-to).

# Installation

````
npm install mockingjay
````

# Usage

This example includes the optional inclusion of a `bot_name` see below for when you want to include that. Otherwise, you can leave it blank or omit it entirely.

````js
var mockingjay = require('mockingjay');

var opts = {
  list_owner: "cspan",
  list_name: "members-of-congress",
  count: 200,
  regex: "(Obamacare|Obama)",
  credentials: {
    consumer_key:         ...,
    consumer_secret:      ...,
    access_token:         ...,
    access_token_secret:  ...
  },
  bot_name: "obamacare-bot"
}

mockingjay.retweet(opts, function(err, result){
  if (!err){
    console.log(result)
    /*{
      "retweeted_matches": true,
      "since_last": 20,
      "matching": 5
    }*/
  }else{
    console.log(err)
  }
})
````

### Options

If you have multiple instances of Mockingjay running on the same machine, you'll want to include a `bot_name` in the config file. Mockingjay only checks new tweets since the last time it ran. It does this by saving the id of the most latest tweet in a file at `src/last-ids/<bot-name>-last-id.json`. Specifying a name will make sure that your script will only check for the last time it ran as opposed to the last time some other script ran.

### Crontab

This package is meant to be run on a cron. Here's an example setup that runs it on the 1s

````
1,11,21,31,41,51 * * * * /usr/bin/node /home/ubuntu/tasks/botname/bot.js
````

### Tweets that are retweets

If someone in your list *retweeted* a tweet that matches your criteria, e.g. you're following senators using the word "gun" and a senator retweets an NRA tweet about "guns", then Mockingjay will send out a tweet that looks like this:

````
.@<person-on-your-tracking-list> retweeted @<person-they-retweeted>: <url-of-original-tweet>
````

If a Mockingjay bot were retweeting @csvsoundsystem whenever they mentioned "big data", which someone should make by the way, it would look like this:

````
@csvsoundsystem retweeted @lifewinning: https://twitter.com/lifewinning/status/445688842721705985 
````

### Callback

`result` returns an object. If `retweeted_matches` is true, it found new matching tweets and retweeted them without error. If everything went well but it didn't find any matches, `status` is `false`. `since_last` are the number of new tweets in that list since last it checked. `matching` is the number of new and matching tweets since last it checked.

---
_Source: https://npm.io/package/mockingjay · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._