Web Application

Use Social Analyzer through the interactive web interface

The web application provides the most feature-rich and user-friendly way to use Social Analyzer. It includes all detection modes, visualization tools, metadata extraction, and an intuitive interface for OSINT investigations.

The web application is the preferred method for using Social Analyzer as it provides access to all features including advanced visualizations and real-time progress monitoring.

Quick Start

1. Install dependencies

   Install Node.js and required system packages:

   sudo apt-get update
   sudo apt-get install -y firefox-esr tesseract-ocr git nodejs npm
   
2. Clone and setup

   git clone https://github.com/qeeqbox/social-analyzer.git
   cd social-analyzer
   npm update
   npm install
   
3. Start the server

   npm start
   

   The server will start on port 9005 (or the port specified in PORT environment variable).

4. Open in browser

   Navigate to:

   http://localhost:9005/app.html
   

Interface Overview

The web interface consists of several key sections:

Search Panel

The main search interface where you configure your analysis:

• Username field: Enter one or multiple usernames (comma-separated)
• Website selector: Choose which platforms to search
• Analysis options: Select detection modes and features
• Advanced settings: Configure proxy, user-agent, and API keys

Results Panel

Displays detected profiles with:

• Detection confidence rating (percentage)
• Profile metadata and screenshots
• Extracted information (links, patterns)
• Quality indicators (good/maybe/bad)

Visualization Panel

Shows force-directed graphs and statistical analysis when metadata extraction is enabled.

Search Configuration

Username Input

Single Username

Enter a single username to analyze:

johndoe

Multiple Usernames

Enter multiple usernames separated by commas for correlation analysis:

johndoe,janedoe,john_doe

This searches all usernames and can help identify related accounts.

Website Selection

Select All

Check the “Select All” option to search across all 900+ supported platforms.

Select by Category

Filter websites by type:

• Social Networks
• Music Platforms
• Gaming Sites
• Adult Content
• Business Networks
• And more…

Select Top Ranked

Choose only the most popular websites:

• Top 10
• Top 50
• Top 100
• Top 500

Select by Country

Filter by geographical region:

• United States (us)
• Brazil (br)
• Russia (ru)
• India (in)
• And more…

Custom Selection

Manually check individual websites from the list.

Analysis Options

Detection Modes

Select which detection techniques to use:

Fast Mode

FindUserProfilesFast / GetUserProfilesFast

• Quick detection using basic techniques
• HTTP-based analysis
• Checks for username presence in page content
• Recommended for initial scans
• Fastest execution time

Use when: You need quick results or are scanning many platforms.

Slow Mode

FindUserProfilesSlow / ShowUserProfilesSlow

• Deep analysis with advanced detection
• Selenium WebDriver automation
• JavaScript rendering
• OCR text recognition
• More accurate but slower

Use when: Fast mode returns inconclusive results or you need high accuracy.

Special Mode

FindUserProfilesSpecial

• Special detection techniques for specific platforms
• Facebook (phone number, name, or profile name)
• Gmail ([e-mail])
• Google ([e-mail])

Use when: Searching for email addresses or phone numbers on major platforms.

Information Extraction

1. Extract Patterns

   Enable ExtractPatterns to extract:

   • URLs and web links
   • Email addresses
   • Social media handles
   • Other regex-matched patterns
2. Extract Metadata

   Enable ExtractMetadata to extract:

   • Open Graph meta tags
   • Twitter Card data
   • Schema.org structured data
   • Page descriptions and keywords
   • Profile images

   Required for visualization features.

Analysis Features

String Analysis

Analyze the username structure:

• SplitWordsByUpperCase: Split camelCase usernames
• SplitWordsByAlphabet: Split by character patterns
• FindNumbers: Extract numeric components
• FindSymbols: Identify special characters
• ConvertNumbers: Convert leetspeak (3 → e)
• FindAges: Guess possible ages from numbers

Name Analysis

• FindOrigins: Determine name origins and ethnicity
• MostCommon: Find most common words
• WordInfo: Get word definitions and information

Lookups

• LookUps: External API lookups (requires API keys)
• CustomSearch: Google Custom Search integration

Visualization

• NetworkGraph: Force-directed graph visualization
• CategoriesStats: Statistics by category
• MetadataStats: Metadata analysis charts

Advanced Settings

Access advanced configuration via the settings panel:

Proxy Configuration

http://proxy.example.com:8080

Route requests through a proxy server for anonymity or to bypass restrictions.

Custom User-Agent

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36

Modify the User-Agent header to simulate different browsers.

Google API Integration

1. Obtain API credentials

   Get API key and Custom Search Engine ID from Google Cloud Console.

2. Enter credentials

   • Google API Key: Your API key
   • Google Custom Search ID: Your CSE ID
3. Enable custom search

   Check CustomSearch in analysis options.

Working with Results

Understanding Confidence Ratings

Each detected profile receives a percentage rating:

Rating	Badge	Description
100%	Good	High confidence - profile definitely exists
50-99%	Maybe	Medium confidence - profile likely exists
Below 50%	Bad	Low confidence - uncertain or false positive

Filtering Results

Use the filter controls to refine results:

• Show Good: Only high-confidence matches
• Show Maybe: Include medium-confidence matches
• Show Bad: Include low-confidence matches
• Show Unknown: Profiles that couldn’t be verified
• Show Failed: Failed connection attempts

Viewing Profile Details

Click on any detected profile to view:

• Full profile URL
• Page title and language
• Extracted text content
• Website type and country
• Global ranking
• Screenshots (if available)
• Metadata (if extraction enabled)
• Extracted patterns (if extraction enabled)

Exporting Results

Results can be exported in multiple formats:

1. JSON Download: Click “Download JSON” for machine-readable data
2. Copy Links: Copy all profile links to clipboard
3. Screenshots: Download captured screenshots

Visualization Features

Force-Directed Network Graph

When NetworkGraph and ExtractMetadata are enabled:

• Nodes represent detected profiles and extracted entities
• Links show relationships and connections
• Interactive: drag, zoom, and explore
• Hover over nodes for details

Statistics Dashboards

When CategoriesStats or MetadataStats are enabled:

• Pie charts showing distribution by category
• Bar charts for country distribution
• Metadata frequency analysis
• Language distribution

Real-Time Progress Monitoring

The web interface provides live updates:

• Progress bar showing completion percentage
• Real-time log output
• Current website being checked
• Number of profiles found
• Ability to cancel ongoing scans

Example Workflows

Basic Profile Search

1. Enter username

   Type the username in the search field: johndoe

2. Select websites

   Choose “Top 100” for a quick scan of popular platforms.

3. Enable fast mode

   Check FindUserProfilesFast.

4. Start search

   Click “Find” and wait for results.

5. Review results

   Browse detected profiles with good ratings.

Deep Investigation

1. Multiple usernames

   Enter variations: johndoe,john_doe,johndoe99

2. Select all websites

   Check “Select All” for comprehensive coverage.

3. Enable all extraction

   • Check ExtractPatterns
   • Check ExtractMetadata
   • Check FindOrigins
4. Enable visualization

   • Check NetworkGraph
   • Check CategoriesStats
5. Use advanced mode

   Select FindUserProfilesSlow for thorough analysis.

6. Analyze results

   Review the network graph to identify connections and patterns.

Targeted Category Search

1. Enter username

   Type the target username.

2. Filter by category

   Select only “Music” or “Gaming” platforms from the list.

3. Enable extraction

   Check ExtractPatterns to find linked accounts.

4. Start search

   Click “Find” to search category-specific platforms.

Logs and Debugging

View detailed logs in the browser console or in the log output panel:

[init] Detections are updated very often, make sure to get the most up-to-date ones
[Setting] Username: johndoe
[Starting] Checking user profiles normal
[Checking] twitter.com
[Checking] github.com
[Done] Checking user profiles normal
[Finished] Analyzing: johndoe Task: abc123

API Endpoints

The web app exposes several API endpoints for custom integrations:

POST /analyze_string

Analyze a username:

{
  "string": "johndoe",
  "uuid": "unique-task-id",
  "option": "FindUserProfilesFast,ExtractMetadata"
}

GET /get_settings

Retrieve current settings:

{
  "proxy": "http://proxy.example.com:8080",
  "user_agent": "Mozilla/5.0...",
  "websites": [...]
}

POST /save_settings

Update configuration:

{
  "proxy": "http://new-proxy.com:8080",
  "user_agent": "Custom Agent",
  "websites": "0,1,2,5,10"
}

Security Considerations

The web application is designed to run locally only. It does not have built-in access control or authentication. Do not expose it to the internet without proper security measures.

• Run only on localhost or trusted networks
• Use a firewall to restrict access
• Do not save sensitive API keys in the interface
• Clear browser storage after sensitive investigations

Performance Tips

• Start with Fast Mode and Top 100 websites for quick results
• Use Slow Mode only when necessary (significantly slower)
• Enable metadata extraction only when you need detailed analysis
• Disable visualization options if not needed (reduces processing time)
• For very thorough scans, run overnight or during off-hours
• Use website filtering to reduce scope and increase speed

Troubleshooting

Server won’t start

Check that port 9005 is not in use:

lsof -i :9005

Use a different port:

PORT=8080 npm start

No results showing

Check browser console for errors (F12) and review server logs.

Slow performance

Reduce the number of websites or disable advanced detection modes.

Visualization not working

Ensure ExtractMetadata is enabled before enabling NetworkGraph.