Social Watchers allows you to watch and record changes on Twitter and Instagram accounts. It can alert you the changes via Telegram.
Before you begin, ensure you have met the following requirements:
- Internet Connection
- Python 3.7+
You can install, configure and run social-watcher with 3 basic steps.
1- Install from PyPI
$ pip3 install social-watcher
2- Create configuration file
$ social-watcher --configure
3- Run with configurations
$ social-watcher --config watcher.json
List of metrics which one watching.
| Platform | Metrics |
|---|---|
| name, followers, following, biography, profile_photo, tweets, likes, birthday, website | |
| name, followers, following, biography, profile_photo, posts, is_private, is_verified |
{
"interval": 300, # general interval time, default is 86400 (1 day)
"telegram": {
"token": "9999999999:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", # telegram bot token
"chat_id": "999999999" # telegram chat id
},
"instagram": [
{
"username": "bisguzar", # username, required
"interval": 5, # interval for this watcher as seconds
# if not defined it uses general interval
"only_if_changed": false, # not required
# if false it will report you if no changes
# default is true
"ignored_metrics": ["profile_photo"] # not required,
# it will ignore this metrics even is changed
},
{...another instagram watcher...},
{...another instagram watcher...}
],
"twitter": [
{
"username": "bugraisguzar", # username, required
"interval": 30, # interval for this watcher as seconds
# if not defined it uses general interval
"only_if_changed": false, # not required
# if false it will report you if no changes
# default is true
"ignored_metrics": ["likes"] # not required,
# it will ignore this metrics even is changed
},
{...another twitter watcher...},
{...another twitter watcher...}
]
}
To contribute to twitter-scraper, follow these steps:
- Fork this repository.
- Create a branch with clear name:
git checkout -b <branch_name>. - Make your changes and commit them:
git commit -m '<commit_message>' - Push to the original branch:
git push origin <project_name>/<location> - Create the pull request.
Alternatively see the GitHub documentation on creating a pull request.
- @bisguzar
If you want to contact me you can reach me at @bugraisguzar.
This project uses the following license: MIT.