vanyasem/vk-scraperCommand-line tool to scrape and download media (photos, videos, stories) from VKontakte users and communities using the VK API. Supports multiple targets, media type filtering, and incremental downloads.
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 better understanding of how it works, head to the docs.
For the stable version (vk-scraper):
git clone https://aur.archlinux.org/vk-scraper.git vk-scraper
For the git version (vk-scraper-git):
git clone https://aur.archlinux.org/vk-scraper-git.git vk-scraper
Then build & install:
cd vk-scraper
makepkg -sic
Or use an AUR helper of your choice.
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
To scrape media:
vk-scraper <username/community> -u <your username> -p <your password>
By default, downloaded media will be placed in <current working directory>/<username>.
To specify multiple users/communities, pass a comma separated list of users:
vk-scraper username1,community1,username2,username3,community2
You can also supply a file containing a list of users/communities:
vk-scraper -f scrape_list.txt
$ cat vk_users.txt
username1
community1
username2
username3
community2
...
Usernames may be separated by newlines, commas, semicolons, or whitespace.
--help -h Show help message and exit
--login-user -u Your VK username
--login-pass -p Your VK password
--filename -f Path to a file containing a list of users/communities to scrape
--destination -d Specify destination folder. By default, media will
be downloaded to <current working directory>/<username>
--retain-username -n Creates a subdirectory for each scraped name when the flag is set
--media-types -t Specify media types to scrape. Enter as space separated values.
Valid values are image, saved, video, story, wall, 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 for comparasion
--quiet -q Be quiet while scraping
--maximum -m Maximum number of items to scrape
--offset -o Offset from which the scrape starts. 0 is from the oldest. (Defaults to 0)