Program for analysing your own vk.com data.
Do not track other people without their acceptation!
- 📈 Recording online activity (module.onliner)
- 🙊 Hidden friends searching (module.hidden_friends)
- 📑 Particularly profile data scrapping (module.onliner)
- 🎯 Multiple targets support
- 👪 Multiple API tokens support
- 🌐 Proxy support
- ⚙️ Custom modules
- Modules exceptions
- On/Off modules
- Any delay for any module
- Easy to create your own by template!
-
🔀 Random proxy (sslproxies.org)(Banhammered by VkApi)
- 📊 Live time visualizing data
- 📑 Scrapping profile info
- 🎱 Predicting activity
-
Clone the latest stable release
git clone https://github.com/v1a0/vks.git
-
Install development dependencies:
cd vks pip3 install -r requirements.txt
Before running, configure necessary settings in file settings.py:
| Setting | Description | Example |
|---|---|---|
| API_TOKENS | list of your VK API tokens (might contain only one) | ['000fuck...rm0a1'] |
| TARGETS_IDS | list of targets ids (also might contain one) | ['123', '345'] |
* How to get API token read here
| Setting | Description |
|---|---|
| MODULES | List of using modules |
| MODULES_EXCEPTS | Sets which targets (ids), modules will skip |
| PROXY | Custom proxy settings for all requests to API |
| MODULES_TIMEOUTS | How often to call (some) module |
| REQ_FREQUENCY | How long time script will be sleep after all modules called |
# Main settings
API_TOKENS = [
'000fuck0fvk000i8oppkq22so2c7binpysm5lpwxlfoxcbbir7kcr2ir8g0rgbu7lv4mo0000use0tlgrm000',
]
TARGETS_IDS = [
'123456789', '987654321', '121201',
]
# Optional settings
MODULES = [
modules.onliner,
modules.my_module
]
MODULES_TIMEOUTS = {
modules.onliner: 60, # 60 seconds
modules.hidden_friends: 13E7, # only once after run
# modules.template: 0,
}
MODULES_EXCEPTS = {
MODULES[1]: [
TARGETS_IDS[0],
TARGETS_IDS[2]
]
}
PROXY = {
"http": "http://123.45.6.78:4321",
"https": "https://123.45.6.78:4321",
"ftp": ""
}
REQ_FREQUENCY = 0.01And finally just run it by python3 , like this: python3.9 main.py.
Go to
https://vk.com/editapp?act=create
Create "Standalone app" and copy apps ID
Replace "APPs_ID" in the link below to your app IP
https://oauth.vk.com/authorize?client_id=___APPs_ID___&scope=photos,audio,video,docs,notes,pages,status,offers,questions,wall,groups,email,notifications,stats,ads,offline,docs,pages,stats,notifications&response_type=token
[ Example ]
https://oauth.vk.com/authorize?client_id=1234567&scope=photos,audio,video,docs,notes,pages,status,offers,questions,wall,groups,email,notifications,stats,ads,offline,docs,pages,stats,notifications&response_type=token
After you visit this link you'll be automatically redirected to new link it will be looks like:
https://oauth.vk.com/blank.html#access_token=___YOUR_API_TOKEN____&expires_in=0&user_id=1&[email protected]
YOUR_API_TOKEN it is you API_TOKEN
[ Example ]
https://oauth.vk.com/authorize?client_id=000fuck0vk000i8oppkq22so2c7binpyysm5lpwxl3uliibir7kcr2ir8g0rgbu7lv4mo0000use0tlgrm000&scope=photos,audio,video,docs,notes,pages,status,offers,questions,wall,groups,email,notifications,stats,ads,offline,docs,pages,stats,notifications&response_type=token
Official instruction: https://vk.com/dev/access_token
| Module | Description | Database | Requests |
|---|---|---|---|
| Onliner | Collecting online status of users and friends online Checking and updating public users data |
onliner.db modules_stat.db |
users.get?sex,online,photo_max_orig,online_mobile |
| Hidden friends | Searching hidden friends Analysing friends of friends |
hidden_friends.db modules_stat.db |
friends.get?user_id=id,count=val |
| Template | Template for future modules | None | None |
| Setting | Description | Located | Value |
|---|---|---|---|
| MODULES_TIMEOUTS | How often run module | settings.py | 0 - 9999999 60 by default |
Hidden friends
| Setting | Description | Located | Value |
|---|---|---|---|
| MODULES_TIMEOUTS | How often run module | settings.py | 13E7 it's mean "run only once" |
| deepness | 1 - means you searching among friends of friends 2 - among friends of friends and friends of friends of friends And so on |
modules.hidden_friends.module_settings | 0 - 4 2 by default |
| max_friends | Slice of friends list. How many friends API can send back | modules.hidden_friends.module_settings | 0 - 9999999 1000 by default |