A Twitter API 1.1 script to make a Twitter bot that retweets tweets that contain words in a RegEx. Built off of RegEx Tweet,
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. Read more about that project and the origins of this bot here.
npm install mockingjay
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.
var mockingjay = ;var opts =list_owner: "cspan"list_name: "members-of-congress"count: 200regex: "(Obamacare|Obama)"credentials:consumer_key: ...consumer_secret: ...access_token: ...access_token_secret: ...bot_name: "obamacare-bot"mockingjay
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.
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
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:
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,
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.