Skip to content

API and Web App for analyzing & finding a person profile across 300+ social media websites (Detections are updated regularly)

License

Notifications You must be signed in to change notification settings

pickkaa/social-analyzer

 
 

Repository files navigation

Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge Generic badge

API and Web App for analyzing & finding a person profile across +300 social media websites. It includes different string analysis and detection modules, you can choose which combination of modules to use during the investigation.

The detection modules utilize a rating mechanism based on different detection techniques, which produces a rate value that starts from 0 to 100 (No-Maybe-Yes)

This project could help in investigating profiles related to suspicious or malicious activities such as cyberbullying, cybergrooming, cyberstalking, spreading misinformation etc.. And, it's currently used by some law enforcement agencies in countries where resources are limited 👍👍👍

Pull Requests are welcomed!

Updates

  • Added more customization to the CLI python version (It's a lot easier to integrate using the JSON output switch) 👏
  • Added Custom Search Query 👏
  • Added similarity checking to FindOrigins 👏
  • Added Proxy option for FindUserProfilesFast & FindUserProfilesSlow 👏
  • Added documentation on how to write detections Wiki 👏
  • Added detection type:advanced (This allows detection on websites that manipulate DOM) 👏

Security Testing

-------------------------------------              ---------------------------------
|        Security Testing           |              |        Social-Analyzer        |
-------------------------------------              ---------------------------------
|   Passive Information Gathering   |     <-->     |   Find Social Media Profiles  |
|                                   |              |                               |
|    Active Information Gathering   |     <-->     |    Post Analysis Activities   |
-------------------------------------              ---------------------------------

Find Profile WEB APP (Fast)

Find Profile WEB APP (Slow)

Profile images will not be blurred. If you want them to be blurred, turn that option on

(New) Find Profile CLI (Fast)

Features

  • String Analysis
  • Search Engine Lookup
  • Multi Layers Detections
  • Most Common Names & Words
  • Convert Numbers to Letters
  • Find Profile Normal (Fast)
  • Find Profile Advanced (Slow)
  • Find Profile Special (Slow)
  • Profile Screenshot (Slow)
  • Find Name Origins
  • Custom Search Queries
  • Websites description
  • Custom user-agent option
  • Dump Logs to folder
  • Optional timeout & implicit wait for each detection
  • Python CLI (Limited to FindUserProfilesFast option)
  • NodeJS CLI (Limited to FindUserProfilesFast option)
  • Grid option (Limited to docker-compose) 👏

Special Detections

  • Facebook

Install and run as web app (NodeJS + NPM + Firefox)

sudo add-apt-repository ppa:mozillateam/ppa
sudo apt-get update
sudo apt-get install -y firefox-esr tesseract-ocr git
git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer
rm -rf package-lock.json node_modules
npm install lodash
npm install
npm start

Install and run as CLI (NodeJS + NPM + Firefox)

sudo add-apt-repository ppa:mozillateam/ppa
sudo apt-get update
sudo apt-get install -y firefox-esr tesseract-ocr git
git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer
rm -rf package-lock.json node_modules
npm install lodash
npm install
# If you want to list all websites use node app.js -c -l
# Remember the following runs as FindUserProfilesFast
node app.js -c -m "fast" -u "username" -w "youtube pinterest tumblr"

Install and run as CLI (Python3 + NPM + Firefox)

sudo add-apt-repository ppa:mozillateam/ppa
sudo apt-get update
sudo apt-get install -y firefox-esr tesseract-ocr git
git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer
pip3 install lxml BeautifulSoup4 tld pygments
# If you want to list all websites use python3 app.py -c -l
# Remember the following runs as FindUserProfilesFast
python3 app.py --cli --mode "fast" --username "johndoe" --websites "youtube pinterest tumblr" --output "pretty"

Install and run as web app with a grid (docker-compose)

git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer
docker-compose -f docker-compose.yml up --build

Install and run as web app (docker)

git clone https://github.com/qeeqbox/social-analyzer.git
cd social-analyzer
docker build -t social-analyzer . && docker run -p 9005:9005 -it social-analyzer

Running Issues

Make sure to update to the latest nodejs and npm

Closing the app by port number

sudo kill -9 $(sudo lsof -t -i:9005)

Goals

  • Adding the generic websites detections (These need some reviewing, but I will try to add them in 2021)

Resources

  • DuckDuckGo API, Google API, NodeJS, bootstrap, selectize, jQuery, Wikipedia and font-awesome
  • Let me know if I missed a reference or resource!

Disclaimer\Notes

  • This tool meant to be used locally (It does not have any type of Access Control)
  • If you want your website to be excluded from this project, please reach out

Contact

Generic badge

About

API and Web App for analyzing & finding a person profile across 300+ social media websites (Detections are updated regularly)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 52.5%
  • HTML 37.9%
  • Python 9.4%
  • Dockerfile 0.2%