https://github.com/edoardottt/twitterbot
[NOT WORKING] 🤖 CLI Twitter Bot. It's made to reach more engagement based on your interests. See https://github.com/edoardottt/twitterbot2
https://github.com/edoardottt/twitterbot
bot bots feed keywords pydev python python-script python3 retweets selenium sql sqlite3 sqlite3-database tweet tweets tweets-reached twitter twitter-bot twitterbot webscraping
Last synced: 5 months ago
JSON representation
[NOT WORKING] 🤖 CLI Twitter Bot. It's made to reach more engagement based on your interests. See https://github.com/edoardottt/twitterbot2
- Host: GitHub
- URL: https://github.com/edoardottt/twitterbot
- Owner: edoardottt
- License: mit
- Created: 2019-07-07T15:29:03.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-11-10T09:38:26.000Z (11 months ago)
- Last Synced: 2025-03-31T23:51:17.133Z (6 months ago)
- Topics: bot, bots, feed, keywords, pydev, python, python-script, python3, retweets, selenium, sql, sqlite3, sqlite3-database, tweet, tweets, tweets-reached, twitter, twitter-bot, twitterbot, webscraping
- Language: Python
- Homepage: https://edoardottt.com/
- Size: 299 KB
- Stars: 39
- Watchers: 9
- Forks: 21
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# twitterBot 🤖
# VERSION 2 OUT NOW => [twitterbot2](https://github.com/edoardottt/twitterbot2)
**⚠️CURRENTLY NOT WORKING DUE TO NEW TWITTER WEBSITE⚠️**
Follow https://twitter.com/edoardottt2
CLI Twitter Bot. It's made to reach more engagement based on your interests.
[](https://www.codacy.com/manual/edoardottt/twitterBot?utm_source=github.com&utm_medium=referral&utm_content=edoardottt/twitterBot&utm_campaign=Badge_Grade)
Does it really works? 📊
----------
**Take a look**
Get started 🎉
--------
- Download this repo and open a terminal inside the main folder
- Install the required libraries: `pip install -r requirements.txt`
- ONLY FOR LINUX
- [Download the latest release of geckodriver](https://github.com/mozilla/geckodriver/releases)
- Execute this ```export PATH=$PATH:/path/to/directory/of/executable/downloaded/in/previous/step```
- To start the bot searching for some keywords:
```python twitterbot.py -u YOUR-EMAIL@mail.com -k trend,topics,twitter```
- To start the bot with your feed:
```python twitterbot.py -u YOUR-EMAIL@mail.com -m```
- To see your account bot statistics with a chart:
```python twitterbot.py -u YOUR-EMAIL@mail.com -s```
- To see info:
```python twitterbot.py -i```
- Help doc.:
```python twitterbot.py -h```
- Follow the followers of an user:
```python twitterbot.py -u YOUR-EMAIL@mail.com -f edoardottt2```
Description 🔦
--------
It uses selenium, matplotlib, getpass and other famous python libraries.
It tries to login with an email and a password on Twitter.
If credentials are correct, It looks into the database if that user logged in yet and so if There is a record with that username id.
If there isn't that record, It creates it.
If the credentials aren't correct, throws an error.
It captures the followers count in your Home.
You can decide if It searches for some keywords as input and It will looks for some tweets searching those words in the search input field.
Instead you can crawl the tweets present in your Home Feed.
The tweets links listed in the result pages are copied in a unique list X.
The elements of this X list are shuffled and then It starts to search those tweets.
Surely It presses the heart button on all of those, then It maybe retweets them.
Why maybe?
Because It only retweets the ~50% of all tweets reached (but puts likes on all).
Why ~50% and not exactly 50%?
Because for little numbers, less trendingand low content keywords and few tweets in your feed (so the captured links < 30-40) It retweets about 40-65% of all tweets reached.
Instead for big numbers, most trending, with high content keywords and so if your feed contains so many tweets (so the captured links > 80-90) It's more precise and almost exactly retweets 50% of them (with a low error like 3-4%).
When It finish, It stores all the likes and retweets count in a SQLite3 database called database.db
With the -s option (only if the password matches the word stored in the database on the same record of that username) It displays (with the help of matplotlib) a chart that shows the amount of likes, retweets and followers per day.
Requirements 📣
---------
- Mozilla Firefox
- Python >= 3.0
- selenium (`pip install selenium`) OR [geckodriver](https://github.com/mozilla/geckodriver/releases)
- matplotlib (`python -m pip install -U matplotlib`)
- It works only with desktop-type Twitter website window
Usage 🚀
-------
Assuming you are in the same folder of the scripts and you run them with **python3**:
Usage: python twitterbot.py -u [value] {-k [values separated by comma] OR -s OR -m} OR -i OR -h
-u or --username:
It's your twitter username(e-mail)
-k or --keywords:
It's/They are the keyword[s] you want to crawl
If you want to insert multiple keywords you have to separated them by comma:
e.g. -k climatechange,techtips,python
-s or --stat:
If you want to see your stats account with a chart.
Insert only -u [value] -s
-m or --mine:
If you want to crawl your feed's tweets.
Insert only -u [value] -m
-i or --info:
To see twitterBot info.
Insert only -i
-h or --help:
Help documentation
Insert only -h
-f or --follow:
Insert an username. The bot will check for some
followers of that username and it tries to follow them.
Insert -f username
Download 📡
---------
`git clone https://github.com/edoardottt/twitterBot.git`
Contributing
--------
Just open an [issue](https://github.com/edoardottt/twitterBot/issues) / [pull request](https://github.com/edoardottt/twitterBot/pulls).
Versioning 📊
---------
**[v1.3.3.3](https://github.com/edoardottt/twitterBot/releases/tag/v1.3.3.3):**
ADDED:
- Security bugs fixed
**[v1.3.3.2](https://github.com/edoardottt/twitterBot/releases/tag/v1.3.3.2):**
ADDED:
- f option. Follow random accounts
**[v1.3.3.1](https://github.com/edoardottt/twitterBot/releases/tag/v1.3.3.1):**
ADDED:
- Refactoring
- Added dynamical prints
- Set the plot title
- Fixed some knows bugs (limit print, typing errors)
**[v1.3.3](https://github.com/edoardottt/twitterBot/releases/tag/v1.3.3):**
ADDED:
- Added -i or --info option that calls print_usage(7) = version, github site, License.
- Added -h or --help option that calls print_usage(0)
- Added twitterBot_log.txt file function that catches the exceptions
and write them into it.
- If isn't present any option after -u calls print_usage(8) = Error 8: Bad input
- Check if the internet connection status is active, otherwise print_usage(6) =
Error 6: no internet connection
CHANGED:
- -h or --hashtags changed in -k or --keywords
REMOVED:
- Print the website URL on print_usage(0)
**[v1.3.2](https://github.com/edoardottt/twitterBot/releases/tag/v1.3.2):**
- Crawling updates (time, likes and retweets) print on the same line and then flush it
- Added followers update that appears on the chart
- Added point marker on the chart
**v 1.3.1:**
- Password input not readable
- Statistics aggregated per days
- Bad input handled. All error prints migrated on print_usage(error_code)
- When it's crawling, doesn't print milliseconds
**v 1.3:**
- Added a better visualization of statistics for every user with matplotlib
- With -s option now It shows a chart that shows likes and retweets for each performance performed
**v 1.2.1:**
- Now It prints the links crawled in your home/search input field
**v 1.2:**
- Added some files that create an SQLite3 database and stores users and bot sessions
table Users
It contains all the users authenticated by twitter
table analytics
It contains all the likes and retweets count of all bot sessions
- Fixed some known bugs (invalid credentials, bad usage..)
- More readable usage printer
**v1.1:**
- Catching some known Exceptions
**v1.0:**
- First release
License 📝
-------
This repository is under [MIT License](https://github.com/edoardottt/twitterBot/blob/master/LICENSE).
[edoardottt.com](https://edoardottt.com/) to contact me.