A simple example Twitter bot using NodeJS.
JavaScript
Switch branches/tags
Nothing to show
Clone or download
dariusk Merge pull request #8 from ryanoasis/patch-1
Minor updates and readability changes
Latest commit 7ac42a6 Mar 7, 2018
Permalink
Failed to load latest commit information.
.gitignore Updated .gitignore to have correct npm output directory. Nov 10, 2015
README.md Minor updates and readability changes Oct 29, 2017
bot.js Fix spacing Dec 10, 2013
config.js a bot\! Jun 1, 2013

README.md

ExampleBot

This bot retweets the latest tweet using the "#mediaarts" hashtag. It attempts to retweet once per hour.

Note: you must be comfortable using your computer's command line interface to use this bot. If you've never used it, there are tutorials for macOS and Windows.

Installation

If you don't already have have them, please install Node.js. This will install two programs: node, which runs JavaScript from the command line, and npm, which helps you install software that Node.js can run.

Make an empty project directory somewhere convenient for you, download the archive zip file, and unzip the contents to your project directory. Go to your project directory in the command line. There should be four files there: .gitignore, README.md, bot.js and config.js. In that directory type:

npm install twit

This installs some code to the npm_modules subdirectory, which you don't need to worry about. (It's Twit, the library that lets us talk to Twitter.)

Connecting to Twitter

At this point you need to register a Twitter account and also get its "app info".

So create a Twitter account for whatever account you want to tweet this stuff. Twitter doesn't allow you to register multiple twitter accounts on the same email address. I recommend you create a brand new email address (perhaps using Gmail) for the Twitter account. Once you register the account to that email address, wait for the confirmation email. Then go here and log in as the Twitter account for your bot:

https://apps.twitter.com/app/new

Once you're there, fill in the required fields: name, description, website. None of it really matters at all to your actual app, it's just for Twitter's information. Do the captcha and submit.

Next you'll see a screen with a "Details" tab. Click on the "Settings" tab and under "Application Type" choose "Read and Write", then hit the update button at the bottom.

Then go to the Keys and Access Tokens tab, and at the bottom click "create my access token". Nothing might happen immediately. Wait a minute and reload the page. then there should be "access token" and "access token secret", which are both long strings of letters and numbers.

Now use a text editor to open up the "config.js" file. It should look like this:

module.exports = {
  consumer_key:         'blah',
  consumer_secret:      'blah',
  access_token:         'blah',
  access_token_secret:  'blah'
}

In between those quotes, instead of 'blah', paste the appropriate info from the Details page. This is essentially the login information for the app.

Now type the following in the command line in your project directory:

node bot.js

Hopefully at this point you see a message like "Success! Check your bot, it should have retweeted something." Check the Twitter account for your bot, and it should have retweeted a tweet with the #mediaarts hashtag.