{"id":18732500,"url":"https://github.com/gsscoder/facebook-snooper","last_synced_at":"2025-06-13T12:37:02.377Z","repository":{"id":56378658,"uuid":"218807289","full_name":"gsscoder/facebook-snooper","owner":"gsscoder","description":"Scrapes Facebook profile pages using a normal login (without an API key)","archived":false,"fork":false,"pushed_at":"2020-11-11T09:39:32.000Z","size":95,"stargazers_count":32,"open_issues_count":2,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-12T09:46:56.054Z","etag":null,"topics":["facebook","information-gathering","linux","macos","osint","python3","reconnaissance","scraping","windows"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gsscoder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-10-31T16:12:56.000Z","updated_at":"2025-04-14T23:22:42.000Z","dependencies_parsed_at":"2022-08-15T17:40:26.453Z","dependency_job_id":null,"html_url":"https://github.com/gsscoder/facebook-snooper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gsscoder/facebook-snooper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsscoder%2Ffacebook-snooper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsscoder%2Ffacebook-snooper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsscoder%2Ffacebook-snooper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsscoder%2Ffacebook-snooper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gsscoder","download_url":"https://codeload.github.com/gsscoder/facebook-snooper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gsscoder%2Ffacebook-snooper/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259613733,"owners_count":22884846,"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","information-gathering","linux","macos","osint","python3","reconnaissance","scraping","windows"],"created_at":"2024-11-07T15:06:26.620Z","updated_at":"2025-06-13T12:37:02.327Z","avatar_url":"https://github.com/gsscoder.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"![fb-snooper logo](https://user-images.githubusercontent.com/1194228/69556500-1ab03f00-0fa5-11ea-867a-c4c897ea17ff.png)\n\n# Facebook Snooper\n\nScrapes Facebook profile pages and searches profiles using a normal log in (without an API key). Inspired by [facebook-scraper](https://github.com/kevinzg/facebook-scraper). Built with [MechanicalSoup](https://github.com/MechanicalSoup/MechanicalSoup).\n\n## Install\n\n**NOTE**: Python 3.7 or higher is required.\n\nTo install facebook_snooper from source, follow these steps:\n```sh\n# clone the repository\n$ git clone https://github.com/gsscoder/facebook-snooper.git\n\n# change the working directory\n$ cd facebook-snooper\n\n# install the package\n$ pip install .\n```\n\nYou can also install with PyPI:\n\n```sh\n$ pip install facebook_snooper\n```\n\n## Usage\n\n```python\n\u003e\u003e\u003e import facebook_snooper\n\u003e\u003e\u003e from facebook_snooper.dump import dump_search, dump_info\n\u003e\u003e\u003e fb = facebook_snooper.init_session()\n\u003e\u003e\u003e fb.log_in('user@account.com', 'user_password')\n\u003cfacebook_snooper.core.session.Session object at 0x10ffc58d0\u003e\n\u003e\u003e\u003e results = fb.search('frank new york')\n\u003e\u003e\u003e dump_search(results, pretty=True)\nprofile frankdecaro https://m.facebook.com/frankdecaro?refid=46\n  Frank DeCaro\n  Author at Rizzoli New York\n  Freelance Writer at The New York Times\nprofile frankbruninyt https://m.facebook.com/frankbruninyt?refid=46\n  Frank Bruni\n  The New York Times\n  New York, New York\n\u003e\u003e\u003e info = fb.profile_info('frankbruninyt')\n\u003e\u003e\u003e dump_info(info, pretty=True)\nFrank Bruni\nImage: https://scontent-fco1-1.xx.fbcdn.net/v/t1.0-1/cp0/e15/q65/p120x120/49...\n  work The New York Times\n  education Columbia University,\n  education UNC Chapel Hill\n  education Loomis Chaffee\n  education Loomis Chaffee, Windsor, Conn.\n  living New York\n  living White Plains\n```\n\n## Test\n\nCreate test directory and data:\n\n```sh\n$ cd facebook-snooper\n$ mkdir tests/pages\n```\n\n```python\n\u003e\u003e\u003e import facebook_snooper \n\u003e\u003e\u003e from tests.persistence import save_login, save_current_page\n\u003e\u003e\u003e fb = facebook_snooper.init_session()\n\u003e\u003e\u003e save_login(fb)\n\u003e\u003e\u003e fb.log_in('user@email.com', 'user_password')\n...\n\u003e\u003e\u003e save_current_page(fb, 'logged')\n\u003e\u003e\u003e fb.search('frank new york')\n...\n\u003e\u003e\u003e save_current_page(fb, 'search')\n\u003e\u003e\u003e fb.profile_info('frankbruninyt')\n...\n\u003e\u003e\u003e save_current_page(fb, 'profile')\n\n```\n\nExecute tests:\n\n```sh\n$ python tests/session.py\n```\n\n### Disclaimer\n\n- This package cannot gather nothing more that is publicly visible.\n- Please respect people's privacy and use it ethically.\n\n### Notes\n\n- There is no guarantee that will work if scraped pages change too much.\n\n### Contributors\n\n- Andrew Polukhin ([pandrey2003](https://github.com/pandrey2003))","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsscoder%2Ffacebook-snooper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgsscoder%2Ffacebook-snooper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgsscoder%2Ffacebook-snooper/lists"}