Skip to content
Reads RSS feeds and post links to Twitter, also search for keywords and #hashtag to retweet
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Initial commit Nov 24, 2015
LICENSE Initial commit Nov 24, 2015 Moved questions to wiki Jan 28, 2019


Twitterbot is a simple Python application for:

  • reading and parsing a RSS feed and posting its title and links to a Twitter account.
  • searching tweets for keywords or hashtags and retweet those tweets.

Both functions (Reading RSS and retweeting) can be used independently. The bot is limited to handle one feed and one Twitter account.


  1. Download or git clone Twitterbot:
    • git clone
  2. Install dependencies feedparser and twython:
    • pip install feedparser
    • pip install twython
  3. Create a Twitter application, and generate keys, tokens etc.
  4. Modifiy the settings in the source code.
    • Modify FeedUrl to the RSS feed you want to read.
    • Modify the variables in the TwitterAuth class and add keys, tokens etc. for connecting to your Twitter app.
    • Modify RetweetIncludeWords for keywords you want to search and retweet, and RetweetExcludeWords for keywords you would like to exclude from retweeting. For example RetweetIncludeWords = ["foo"] and RetweetExcludeWords = ["bar"] will include any tweet with the word "foo", as long as the word "bar" is absent. This list can also be left empty, i.e. RetweetExcludeWords = [].


Read the RSS feed and post to Twitter account:

$ python rss

Search for tweets and retweet them:

$ python rt

Setup crontabs examples

Preferably, you should use crontab to set up Twitterbot to run on a schedule.

crontab examples:

# Read RSS feed every hour and tweet new links.
00 * * * * python rss

# Rewteet keywords/hashtags every 15 minutes.
*/15 * * * * python rt

Use the cron schedule expression editor to easily create crons.


See Questions and answers in the wiki.

You can’t perform that action at this time.