BLHify 🕵️‍♂️

Broken Link Hunter — a lightweight, async toolkit for discovering and verifying broken social media links across large web scopes.

🚀 Features

• 🔍 Scans pages or entire domain lists for social links (Instagram, TikTok, X/Twitter, Facebook)
• ✅ Detects broken profiles automatically
• 🧭 Validates which pages contain the broken links
• 💾 Saves results progressively — no data loss if interrupted
• ⚡ Built on async I/O (fast and lightweight)

🧰 Installation

git clone https://github.com/yourusername/BLHify.git
cd BLHify
pip install -r requirements.txt

💡 Usage

1️⃣ Scan for Social Links

Extract all social links from a single URL or list of URLs.

python3 scanner.py -s https://example.com
python3 scanner.py -f urls.txt -o social_links.txt

2️⃣ Check if Links Are Broken

Check which social media profiles no longer exist or are misconfigured.

python3 check.py -i social_links.txt -o broken_links.txt

3️⃣ Validate Broken Link Locations

Identify which page(s) contain the broken links.

python3 validate.py -b broken_links.txt -u urls.txt

⚙️ Example Workflow

# Step 1: Collect URLs
cat scope.txt | katana -silent > urls.txt

# Step 2: Scan for social links
python3 scanner.py -f urls.txt

# Step 3: Check for broken profiles
python3 check.py -i social_links.txt

# Step 4: Validate which pages reference broken links
python3 validate.py -b broken_links.txt -u urls.txt

🧠 Notes

• Recommended concurrency: -c 5 (to avoid overloading servers)
• Always get permission before testing live targets
• Ideal for recon, bug bounty, and digital hygiene

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

👨‍💻 Author

Aaditya Vinayak
Penetration Tester & Security Researcher
https://vaadi.site

🛡️ Disclaimer

BLHify is intended for ethical security testing and educational use only.
The author assumes no liability for misuse or damage caused by this tool.