Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/peterdalle/twitterbot
Reads RSS feeds and post links to Twitter, also search for keywords and #hashtag to retweet
https://github.com/peterdalle/twitterbot
python rss-feed twitter-bot
Last synced: about 2 months ago
JSON representation
Reads RSS feeds and post links to Twitter, also search for keywords and #hashtag to retweet
- Host: GitHub
- URL: https://github.com/peterdalle/twitterbot
- Owner: peterdalle
- License: gpl-2.0
- Created: 2015-11-24T11:28:34.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2020-09-01T14:15:50.000Z (about 4 years ago)
- Last Synced: 2024-07-27T05:36:25.854Z (about 2 months ago)
- Topics: python, rss-feed, twitter-bot
- Language: Python
- Homepage:
- Size: 39.1 KB
- Stars: 61
- Watchers: 6
- Forks: 25
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Twitterbot
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.
## Install
1. Download or git clone Twitterbot:
- `git clone https://github.com/peterdalle/twitterbot`
2. Install dependencies [feedparser](https://pythonhosted.org/feedparser/) and [twython](https://twython.readthedocs.org/en/latest/):
- `pip install feedparser`
- `pip install twython`
3. Create a [Twitter application](https://apps.twitter.com/), and generate keys, tokens etc.
4. Modifiy the settings in the source code.
- Modify `feed_url` 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 `retweet_include_words` for keywords you want to search and retweet, and `retweet_exclude_words` for keywords you would like to exclude from retweeting. For example `retweet_include_words = ["foo"]` and `retweet_exclude_words = ["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. `retweet_exclude_words = []`.
## Requirements
* Python 3+
* Twitter account
## Usage
Read the RSS feed and post to Twitter account:
```bash
$ python twitterbot.py rss
```
Search for tweets and retweet them:
```bash
$ python twitterbot.py rt
```
## Setup crontabs examples
Preferably, you should use crontab to set up Twitterbot to run on a schedule.
crontab examples:
```bash
# Read RSS feed every hour and tweet new links.
00 * * * * python twitterbot.py rss
# Rewteet keywords/hashtags every 15 minutes.
*/15 * * * * python twitterbot.py rt
```
Use the [cron schedule expression editor](https://crontab.guru/) to easily create crons.
## Questions
See [Questions and answers](https://github.com/peterdalle/twitterbot/wiki/Questions-and-answers) in the wiki.