{"id":14978805,"url":"https://github.com/n0kovo/fb_friend_list_scraper","last_synced_at":"2025-03-17T14:18:00.183Z","repository":{"id":41278872,"uuid":"430327577","full_name":"n0kovo/fb_friend_list_scraper","owner":"n0kovo","description":"OSINT tool to scrape names and usernames from large friend lists on Facebook, without being rate limited.","archived":false,"fork":false,"pushed_at":"2022-12-15T15:51:31.000Z","size":64,"stargazers_count":225,"open_issues_count":1,"forks_count":21,"subscribers_count":7,"default_branch":"develop","last_synced_at":"2024-04-13T21:06:07.540Z","etag":null,"topics":["facebook","facebook-bot","osint","python","scraper","selenium-webdriver","web-automation","web-scraping"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/fb-friend-list-scraper/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/n0kovo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-21T09:51:36.000Z","updated_at":"2024-04-07T15:35:36.000Z","dependencies_parsed_at":"2023-01-29T03:31:09.665Z","dependency_job_id":null,"html_url":"https://github.com/n0kovo/fb_friend_list_scraper","commit_stats":null,"previous_names":["narkopolo/fb_friend_list_scraper"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0kovo%2Ffb_friend_list_scraper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0kovo%2Ffb_friend_list_scraper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0kovo%2Ffb_friend_list_scraper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/n0kovo%2Ffb_friend_list_scraper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/n0kovo","download_url":"https://codeload.github.com/n0kovo/fb_friend_list_scraper/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244047645,"owners_count":20389206,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["facebook","facebook-bot","osint","python","scraper","selenium-webdriver","web-automation","web-scraping"],"created_at":"2024-09-24T13:58:26.354Z","updated_at":"2025-03-17T14:18:00.150Z","avatar_url":"https://github.com/n0kovo.png","language":"Python","funding_links":[],"categories":["💬 Social Media Intelligence (SOCMINT)"],"sub_categories":[],"readme":"\u003cimg src=\"https://user-images.githubusercontent.com/16690056/207906071-44c681ec-fed1-4e2f-ab20-2c00449d5695.png\"\u003e\n\n\u003cp float=\"left\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Built%20with-Python3-red\" /\u003e\n\u003cimg src=\"https://img.shields.io/badge/Version-0.3.6-green\" /\u003e \n\u003cimg src=\"https://img.shields.io/pypi/dm/fb-friend-list-scraper.svg\" /\u003e\n\u003ca href=\"https://makeapullrequest.com/\"\u003e\u003cimg src=\"https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square\u0026color=green\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Facebook Friend List Scraper\n\nOSINT tool to scrape names and usernames from large friend lists on Facebook, without being rate limited.\u003cbr\u003e\n(hmu on Mastodon: [@n0kovo@infosec.exchange](https://infosec.exchange/@n0kovo))\n### Getting started:\n* Install using pip: `python -m pip install fb-friend-list-scraper`\n* Script is now installed as `fbfriendlistscraper`\n* Run with `-h` or `--help` to show usage information.\n\n### Usage:\n\n```\nusage: fbfriendlistscraper [-h] -e EMAIL [-p PASSWORD] -u USERNAME [-o OUTFILE] [-w] [-q] [-x] [-s SLEEPMULTIPLIER] [-i PROXY] [-c CMD]\n\nTool to scrape names and usernames from large friend lists on Facebook, without being rate limited\n\noptions:\n  -h, --help            show this help message and exit\n  -e EMAIL, --email EMAIL\n                        Email address or phone number to login with.\n  -p PASSWORD, --password PASSWORD\n                        Password to login with. If not supplied you will be prompted. You really shouldn't use this for security reasons.\n  -u USERNAME, --username USERNAME\n                        Username of the user to scrape.\n  -o OUTFILE, --outfile OUTFILE\n                        Path of the output file. (Default: ./scraped_friends.txt)\n  -w, --headless        Run webdriver in headless mode.\n  -q, --quiet           Do not print scraped users to screen.\n  -x, --onlyusernames   Only the usernames/IDs will be written to the output file.\n  -s SLEEPMULTIPLIER, --sleepmultiplier SLEEPMULTIPLIER\n                        Multiply sleep time between each page scrape by n. Useful when being easily rate-limited.\n  -i PROXY, --proxy PROXY\n                        Proxy server to use for connecting. Username/password can be supplied like: socks5://user:pass@host:port\n  -c CMD, --cmd CMD     Shell command to run after each page scrape. Useful for changing proxy/VPN exit.\n\nexamples:\n        fbfriendlistscraper -e your@email.com -p YourPassword123 -u someusername.123 -o my_file.txt\n        fbfriendlistscraper --email your@email.com --username another.user --headless -s 2 -x\n        fbfriendlistscraper -e your@email.com -u username.johnson -w --proxy socks5://127.0.0.1:9050\n        fbfriendlistscraper -e your@email.com -u xxuserxx --headless --cmd \"mullvad relay set provider Quadranet\"\n        fbfriendlistscraper -e your@email.com -u markzuckerburger -w -o ./test.txt --cmd \"killall -HUP tor\"\n```\n\n### NOTE:\nFacebook 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.\n\n\n### TODO:\n* Make script check for followers if friend list isn't public.\n* Add more error handling.\n* Add proxy rotation.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn0kovo%2Ffb_friend_list_scraper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fn0kovo%2Ffb_friend_list_scraper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fn0kovo%2Ffb_friend_list_scraper/lists"}