VK Scraper
vk-scraper is a command-line application written in Python that scrapes and downloads VK user's / community's data. Use responsibly.
To get a closer look at how it works, read the docs.
Inspired by instagram-scraper.
Features
- Scrape user's photos
- Scrape user's videos (both uploaded and external)
- Scrape user's saved photos
- Scrape user's stories
Install
Arch GNU/Linux
For the stable version:
$ trizen -S vk-scraper
For the git version:
$ trizen -S vk-scraper-git
Other distros
For the stable version:
$ pip3 install vk-scraper --upgrade --user
For the git version:
$ pip3 install git+https://github.com/vanyasem/VK-Scraper.git --upgrade --user
Usage
To scrape user's media:
vk-scraper <username> -u <your username> -p <your password>By default, downloaded media will be placed in <current working directory>/<username>.
To specify multiple users, pass a delimited list of users:
vk-scraper username1,username2,username3You can also supply a file containing a list of usernames:
vk-scraper -f vk_users.txt# vk_users.txt
username1
username2
username3
# and so on...
Usernames may be separated by newlines, commas, semicolons, or whitespace.
Arguments
--help -h Show help message and exit
--login-user -u VK username
--login-pass -p VK password
--filename -f Path to a file containing a list of users / communities to scrape
--destination -d Specify the download destination. By default, media will
be downloaded to <current working directory>/<username>
--retain-username -n Creates a username subdirectory when the destination flag is set
--media-types -t Specify media types to scrape. Enter as space separated values.
Valid values are image, saved, video, story, or none
(defaults to image)
--latest Scrape only new media since the last scrape. Uses the last modified
time of the latest media item in the destination directory to compare
--quiet -q Be quiet while scraping
--maximum -m Maximum number of items to scrape
Contributing
- Check open issues or open a new one to start a discussion around your idea or a bug you found
- Fork the repository and make your changes
- Send a pull request
Futurelog
- Scrape by hashtag
- Scrape by location
- Save metadata to a file (likes, comments, etc)
- Sort photos by their albums