https://github.com/n0kovo/fb_friend_list_scraper
OSINT tool to scrape names and usernames from large friend lists on Facebook, without being rate limited.
https://github.com/n0kovo/fb_friend_list_scraper
facebook facebook-bot osint python scraper selenium-webdriver web-automation web-scraping
Last synced: about 2 months ago
JSON representation
OSINT tool to scrape names and usernames from large friend lists on Facebook, without being rate limited.
- Host: GitHub
- URL: https://github.com/n0kovo/fb_friend_list_scraper
- Owner: n0kovo
- License: gpl-3.0
- Created: 2021-11-21T09:51:36.000Z (over 3 years ago)
- Default Branch: develop
- Last Pushed: 2022-12-15T15:51:31.000Z (over 2 years ago)
- Last Synced: 2024-04-13T21:06:07.540Z (about 1 year ago)
- Topics: facebook, facebook-bot, osint, python, scraper, selenium-webdriver, web-automation, web-scraping
- Language: Python
- Homepage: https://pypi.org/project/fb-friend-list-scraper/
- Size: 62.5 KB
- Stars: 225
- Watchers: 7
- Forks: 21
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
## Facebook Friend List Scraper
OSINT tool to scrape names and usernames from large friend lists on Facebook, without being rate limited.
(hmu on Mastodon: [@[email protected]](https://infosec.exchange/@n0kovo))
### Getting started:
* Install using pip: `python -m pip install fb-friend-list-scraper`
* Script is now installed as `fbfriendlistscraper`
* Run with `-h` or `--help` to show usage information.
### Usage:
```
usage: fbfriendlistscraper [-h] -e EMAIL [-p PASSWORD] -u USERNAME [-o OUTFILE] [-w] [-q] [-x] [-s SLEEPMULTIPLIER] [-i PROXY] [-c CMD]
Tool to scrape names and usernames from large friend lists on Facebook, without being rate limited
options:
-h, --help show this help message and exit
-e EMAIL, --email EMAIL
Email address or phone number to login with.
-p PASSWORD, --password PASSWORD
Password to login with. If not supplied you will be prompted. You really shouldn't use this for security reasons.
-u USERNAME, --username USERNAME
Username of the user to scrape.
-o OUTFILE, --outfile OUTFILE
Path of the output file. (Default: ./scraped_friends.txt)
-w, --headless Run webdriver in headless mode.
-q, --quiet Do not print scraped users to screen.
-x, --onlyusernames Only the usernames/IDs will be written to the output file.
-s SLEEPMULTIPLIER, --sleepmultiplier SLEEPMULTIPLIER
Multiply sleep time between each page scrape by n. Useful when being easily rate-limited.
-i PROXY, --proxy PROXY
Proxy server to use for connecting. Username/password can be supplied like: socks5://user:pass@host:port
-c CMD, --cmd CMD Shell command to run after each page scrape. Useful for changing proxy/VPN exit.
examples:
fbfriendlistscraper -e [email protected] -p YourPassword123 -u someusername.123 -o my_file.txt
fbfriendlistscraper --email [email protected] --username another.user --headless -s 2 -x
fbfriendlistscraper -e [email protected] -u username.johnson -w --proxy socks5://127.0.0.1:9050
fbfriendlistscraper -e [email protected] -u xxuserxx --headless --cmd "mullvad relay set provider Quadranet"
fbfriendlistscraper -e [email protected] -u markzuckerburger -w -o ./test.txt --cmd "killall -HUP tor"
```
### NOTE:
Facebook changes the markup of it's pages regularly, so the script might break from time to time. Please open an issue if something doesn't work and I'll take a look at it. Pull requests are welcome as well.
### TODO:
* Make script check for followers if friend list isn't public.
* Add more error handling.
* Add proxy rotation.