Advanced Social Media Link Discovery & Broken Link Hijacking Detection Tool
Find, verify, and analyze social media links across 15+ platforms with automatic vulnerability detection
- Overview
- What is Broken Link Hijacking?
- Features
- Installation
- Configuration
- Usage
- Broken Link Detection
- Database & History
- Proxy Support
- Custom Rules
- Color Support
- Results & Interpretation
- Troubleshooting
- Contributing
- Disclaimer
- Resources
- Acknowledgments
- License
SOCMED v2.0 is an advanced tool for discovering, verifying, and analyzing social media links on websites. It is specifically designed to help cybersecurity professionals identify potential Broken Link Hijacking vulnerabilities through automated validation.
Broken Link Hijacking is an exploitation technique where an attacker takes advantage of social media links that are no longer active (broken/dead links). When a website has links to a social media account that has been deleted or deactivated:
- An attacker can re-register that username
- Hijack the website's visitor traffic
- Carry out phishing or further attacks
- Damage the company's reputation and brand trust
- Security auditing & penetration testing
- OSINT (Open Source Intelligence) gathering
- Brand protection monitoring
- Vulnerability assessment
- Digital footprint analysis
- Compliance checking
| Feature | Description | Status |
|---|---|---|
| Multi-Platform | Supports 15+ social media platforms | Yes |
| Broken Link Detection | Automatically identifies broken/dead links | Yes |
| Database Storage | SQLite database for scan history | Yes |
| Proxy Support | HTTP/HTTPS proxy with authentication | Yes |
| Rate Limiting | Automatic rate limiting to avoid detection | Yes |
| User-Agent Rotation | Random User-Agent for each request | Yes |
| Hex Color Support | True Color & 256 color terminal display | Yes |
| Concurrent Processing | Multi-threaded for maximum speed | Yes |
| Custom Rules | YAML-based custom search rules | Yes |
| Multiple Export Formats | JSON, CSV, TXT, and SQLite | Yes |
| Progress Bar | Real-time visual progress indicator | Yes |
| Redirect Handling | Automatic redirect following | Yes |
| Selective Scanning | Choose specific platforms or scan all | Yes |
| Verbose Mode | Detailed debugging information | Yes |
| Scan History | View and analyze past scans | Yes |
# Python 3.6 or later
python --version
# Install pip
pip --versionClone Repository
# Clone the repository
git clone https://github.com/CayberMods/SocMed.git
cd SocMedInstall Dependencies
# Install all required packages
pip install -r requirements.txtconfig/config.yaml
Create a config/config.yaml file for advanced configuration:
proxy:
enabled: false
type: http
host: 1.1.1.1
port: 8080
username: "cm"
password: "cm"
rate_limit:
enabled: true
time_window: 60
max_requests: 50
auto_adjust: true
user_agents:
- "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
- "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
- "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
- "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1"
- "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/121.0"
database:
enabled: true
path: scans.dbUsing Config
python socmed.py -l domains.txt -config config/config.yaml -allBasic Usage
python socmed.py -l <domains.txt> [OPTIONS]Usage Examples
Scan All Platforms
python socmed.py -l domains.txt -allScan Specific Platforms
# Scan Instagram & Telegram only
python socmed.py -l domains.txt -ig -tele
# Scan Instagram, YouTube, Twitter
python socmed.py -l domains.txt -ig -yt -twWith Custom Rules
python socmed.py -l domains.txt -custom custom_rules.yaml -vWith Proxy
python socmed.py -l domains.txt -all --proxy http://user:pass@127.0.0.1:8080Export Results
# JSON export
python socmed.py -l domains.txt -all --json -o results
# CSV export
python socmed.py -l domains.txt -all --csv -o results
# Save to database
python socmed.py -l domains.txt -all --dbView History
python socmed.py --historyTest Color Support
python socmed.py --test-colorsFull Parameter List
Parameter Shorthand Description Default
- --list -l Domain list file (required)
- --output -o Output results file
- --timeout -t Request timeout (seconds) 10
- --workers -w Number of concurrent workers 20
- --verbose -v Verbose mode False
- --test-colors Test color support
- --json Export results to JSON False
- --csv Export results to CSV False
- --db Save results to database False
- --history Show scan history False
- --proxy Proxy URL
- --config Configuration file (YAML)
- --instagram -ig Scan Instagram False
- --telegram -tele Scan Telegram False
- --youtube -yt Scan YouTube False
- --tiktok -tt Scan TikTok False
- --twitter -tw Scan Twitter/X False
- --facebook -fb Scan Facebook False
- --linkedin -in Scan LinkedIn False
- --github -gh Scan GitHub False
- --reddit -rd Scan Reddit False
- --discord -dc Scan Discord False
- --spotify -sp Scan Spotify False
- --medium -md Scan Medium False
- --twitch -tc Scan Twitch False
- --all -all Scan all platforms False
- --custom-method -custom Custom rules YAML file
Supported Platforms
- Platform Flag Detection Pattern Broken Detection
- Instagram -ig instagram.com/[username] Yes
- Telegram -tele t.me/[username] Yes
- YouTube -yt youtube.com/@[channel] Yes
- TikTok -tt tiktok.com/@[username] Yes
- Twitter/X -tw twitter.com/[username] Yes
- Facebook -fb facebook.com/[username] Yes
- LinkedIn -in linkedin.com/in/[username] Yes
- GitHub -gh github.com/[username] Yes
- Reddit -rd reddit.com/user/[username] Yes
- Discord -dc discord.gg/[invite] Yes
- Spotify -sp open.spotify.com/[id] Yes
- Medium -md medium.com/@[username] Yes
- Twitch -tc twitch.tv/[username] Yes
How It Works
SOCMED v2.0 uses intelligent detection algorithms to verify if social media links are active or broken:
- HTTP Status Code Check - Detects 404, 410, and other error codes
- Content Analysis - Parses HTML for error messages and patterns
- Title Verification - Checks for "Page Not Found" and similar titles
- Meta Tag Inspection - Analyzes OG tags for error indicators
- Element Detection - Searches for error-specific HTML elements
Detection Methods by Platform
Platform Detection Methods
- Instagram Status code, title check, meta tags, error keywords
- Twitter/X Status code, title check, error keywords
- YouTube Status code, title check, iframe detection
- Facebook Status code, title check, meta tags, error keywords
- LinkedIn Status code, title check, H1 tags, error keywords
- GitHub Status code, title check, error keywords
- Discord Status code, title check, invite validation
- TikTok Status code, title check, content analysis
- Telegram Status code, title check, content analysis
Real Output Example
[BROKEN-INSTAGRAM] https://instagram.com/deleteduser -> https://site.com - HTTP 404
[ACTIVE-INSTAGRAM] https://instagram.com/activeuser -> https://site.com
[BROKEN-TWITTER] https://twitter.com/suspendedaccount -> https://site.com - Content Check: Error keywords found
[ACTIVE-TWITTER] https://twitter.com/realuser -> https://site.com
[BROKEN-YOUTUBE] https://youtube.com/@deletedchannel -> https://site.com - HTTP 404
Database Features
- · SQLite Storage - Lightweight, portable database
- · Scan History - Track all past scans
- · Timestamps - Record when each link was found
- · Metadata - Store status, platform, response times
- · Query Support - View and filter historical data
View History
# Show recent scans
python socmed.py --history
# Output example:
# 2026-07-07 10:30:45 | example.com | instagram | https://instagram.com/user
# 2026-07-07 10:30:46 | example.com | twitter | https://twitter.com/userDatabase Schema
CREATE TABLE scans (
id INTEGER PRIMARY KEY AUTOINCREMENT,
timestamp TEXT,
domain TEXT,
status INTEGER,
platform TEXT,
link TEXT,
server TEXT,
response_time REAL
);Proxy Configuration
SOCMED supports HTTP/HTTPS proxies with authentication:
# Basic proxy
python socmed.py -l domains.txt -all --proxy http://127.0.0.1:8080
# Authenticated proxy
python socmed.py -l domains.txt -all --proxy http://user:pass@127.0.0.1:8080
# HTTPS proxy
python socmed.py -l domains.txt -all --proxy https://127.0.0.1:8080Proxy Configuration in config/config.yaml
proxy:
enabled: true
type: http
host: 127.0.0.1
port: 8080
username: "username"
password: "password"YAML File Format
- name: platform_name
description: Optional description
creator: YourName
color: '#HEXCODE'
regex:
- 'regex_pattern_1'
- 'regex_pattern_2'Example custom_rules.yaml
# Custom rules for additional platforms
- name: instagram
description: Find Instagram profiles
creator: CayberMods
color: '#E4405F'
regex:
- 'instagram\.com\/([a-zA-Z0-9_\.]+)'
- 'instagr\.am\/([a-zA-Z0-9_\.]+)'
- name: twitter
description: Find Twitter profiles
creator: CayberMods
color: '#1DA1F2'
regex:
- 'twitter\.com\/([a-zA-Z0-9_]+)'
- 'x\.com\/([a-zA-Z0-9_]+)'
- name: threads
description: Find Threads profiles
creator: CayberMods
color: '#FF0080'
regex:
- 'threads\.net\/(@[a-zA-Z0-9_\.]+)'
- name: bluesky
description: Find Bluesky profiles
creator: CayberMods
color: '#1185FE'
regex:
- 'bsky\.app\/profile\/([a-zA-Z0-9_\.]+)'Using Custom Rules
# Scan with custom rules
python socmed.py -l domains.txt -custom custom_rules.yaml -all
# Verbose for debugging
python socmed.py -l domains.txt -custom custom_rules.yaml -vTrue Color (24-bit)
Supported terminals:
- · iTerm2
- · VS Code Terminal
- · Windows Terminal
- · GNOME Terminal
- · Konsole
- · Kitty
- · Alacritty
- · WezTerm
256 Color Mode
Fallback for terminals that don't support True Color:
- · xterm-256color
- · Most SSH clients
- · Legacy terminals
Test Color Support
python socmed.py --test-colorsOutput:
Testing color support...
True color supported
Testing hex colors:
████ #FF0000 RGB(255, 0, 0)
████ #00FF00 RGB(0, 255, 0)
████ #0000FF RGB(0, 0, 255)
████ #FF00FF RGB(255, 0, 255)
████ #FFFF00 RGB(255, 255, 0)
████ #00FFFF RGB(0, 255, 255)
████ #FF6B6B RGB(255, 107, 107)
████ #4ECDC4 RGB(78, 205, 196)
Status Codes
- Code Description
- 200 Website active, link found
- 301-302 Redirect, followed automatically
- 303 See Other redirect
- 400 Bad Request
- 401 Unauthorized
- 403 Forbidden
- 404 Not Found
- 500 Internal Server Error
- 502 Bad Gateway
- 503 Service Unavailable
Connection Issues
# Increase timeout
python socmed.py -l domains.txt -all -t 30
# Reduce workers
python socmed.py -l domains.txt -all -w 5
# Use proxy
python socmed.py -l domains.txt -all --proxy http://127.0.0.1:8080Color Issues
# Test color support
python socmed.py --test-colors
# Force 256 colors
export TERM=xterm-256color
python socmed.py -l domains.txt -all
# Disable colors
export NO_COLOR=1
python socmed.py -l domains.txt -allYAML Issues
# Check YAML syntax
python -c "import yaml; yaml.safe_load(open('custom_rules.yaml'))"
# Verbose mode for debugging
python socmed.py -l domains.txt -custom custom_rules.yaml -vRate Limiting
# Disable rate limiting
# Edit config/config.yaml: rate_limit.enabled: false
# Adjust rate limits
# Edit config/config.yaml: rate_limit.max_requests: 20Database Issues
# Reset database
rm scans.db
python socmed.py -l domains.txt -all --db
# Check database
sqlite3 scans.db "SELECT * FROM scans;"We warmly welcome contributions from the community!
How to Contribute
- Fork the repository
- Create a new branch: git checkout -b feature/AmazingFeature
- Commit your changes: git commit -m 'Add AmazingFeature'
- Push to the branch: git push origin feature/AmazingFeature
- Open a Pull Request
Areas That Need Contribution
-
· Bug fixes & issue reporting
-
· New features & enhancements
-
· Documentation & tutorials
-
· UI/UX improvements
-
· Performance optimization
-
· Security improvements
-
· New platform support
-
[!] but the contribution here is not available yet, I just listed it for the future.
-
Source Code: Source Code
IMPORTANT: This tool was created for EDUCATIONAL purposes and ETHICAL SECURITY TESTING.
Use of this tool:
Permitted:
- · On websites you have permission to test
- · For legitimate purposes such as security auditing
- · Must comply with applicable laws
Prohibited:
- · For illegal or malicious activity
- · For disrupting website operations
- · For unauthorized access
The author is not responsible for:
- · Use of this tool for illegal purposes
- · Any damage or loss incurred
- · Legal violations committed by users
By using this tool, you agree to:
- · Take full responsibility for your use of the tool
- · Comply with all applicable laws and regulations
- · Use this tool ethically and responsibly
Official Documentation
- · Python Official Docs
- · Requests Library
- · Colorama Docs
- · YAML Specification
Security Resources
- · OWASP Broken Link Hijacking
- · HackerOne Reports
- · Bug Bounty Tips
- · Python Community - For an amazing programming language
- · Requests Team - For a powerful HTTP library
- · Colorama Developers - For terminal color support
- · Security Researchers - For sharing knowledge and best practices
- · Open Source Community - For tools and inspiration
Version History
Version Date Changes
- 2.0 2026-07-07 Major update: Database, Proxy, Broken Link Detection, Export formats
- 1.0 2026-06-22 Initial release with basic features
What's New in v2.0
- · SQLite database for scan history
- · Proxy support with authentication
- · Advanced broken link detection
- · JSON, CSV export formats
- · Rate limiting
- · User-Agent rotation
- · Progress bar
- · Enhanced color support
- · Comprehensive logging
- · Config file support
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2026 CayberMods
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Made with love for the cybersecurity community
Stay safe, stay secure, stay ethical!