Skip to content

A collection of Twitter bots about Wikipedia, Wikimedia Commons and other wikis


Notifications You must be signed in to change notification settings


Repository files navigation


Twitter bots about Wikipedia, Wikimedia Commons and other wikis.

See a list of wikitweets bots working here

Ideas for future bots:

  • enwikiTFA (pic+intro)
  • villagepump titles
  • sister projects (word of the day, book, etc)

How to register a Twitter bot account?

Follow these steps:

  1. Go to and register a nickname for your bot
  2. Go to and create an APP. The callback URL is not needed and the website URL can be modified later. In the "Permissions" tab, give Read and Write permissions. As of May 2014, that will ask you for a phone number and send a verification code. If you don't want to do this, do this Step 2 from a Smartphone/Tablet. (Read this and the tip by @UAlanbari)
  3. In the "API keys" tab you will find the API key and the API secret, write both in a file named .twitter_keys with the following structure: API_KEY = xxxxxx (newline) API_SECRET = xxxxxxxxxxxx
  4. Now use the script to get the tokens: python That will use .twitter_keys and show a link that you have to open in web browser. A code number will be displayed which you have to write in console, answering the question.
  5. Two tokens will saved in a file named .twitter_tokens.

Now you can run your Twitter bot. The bot will need both .twitter_keys and .twitter_tokens files. If you want more than one Twitter bot, you will need to repeat these steps and generates other keys and tokens. Remember to protect these files to avoid others read them (chmod go-rwx .twitter_*).

How to create virtualenv for wikitweets?

Follow these steps:

  1. virtualenv -p python3 tweetsenv
  2. cd tweetsenv;source bin/activate
  3. pip install twython
  4. deactivate

How to launch bot periodically?

Add a task to cron:

  1. crontab -e
  2. 0 13 * * * bash commonspotd/



A collection of Twitter bots about Wikipedia, Wikimedia Commons and other wikis







No releases published