Facebook Friend List Scraper

A OSINT tool to scrape names and usernames from large friend lists on Facebook, without being rate limited.

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

---

• 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"

> Visit fb friend_list_scraper Website <