DorkScout

The Ultimate OSINT Hunter – Find digital footprints across 30+ platforms. Direct checks, Google search, Tor rotation, advanced dorking, and browser automation.

---

📸 Screenshots

DorkScout in action – live scanning output

Detailed intelligence report with confidence scores

Visible browser mode for JavaScript-heavy sites

---

✨ Features

• ⚡ Direct Profile Checking – Instantly verify if a username exists on supported platforms.
• 🔍 Google Search – Full web search with optional API (100 free queries/day, no captcha).
• 🧅 Tor Proxy Rotation – Rotate IPs via Tor to avoid rate limits and detection.
• 🎯 Advanced Dorking – Use filetype:, intitle:, inurl: for deep discovery.
• 🌐 Browser Mode – Render JavaScript‑heavy pages with Selenium (visible browser).
• 📊 Deep Extraction – Bio, location, followers, emails, phone numbers, usernames.
• 🎚️ Confidence Scoring – Each result gets a 0–100% score based on multiple verifications.
• 🚀 Multi‑threaded – Fast concurrent crawling with configurable threads.
• 💾 JSON / TXT Export – Save reports for later analysis.
• 🛡️ Partial Save on Ctrl+C – Never lose progress.

---

💻 Supported Platforms

Platform	Status	Notes
Kali Linux	✅ Fully tested	Pre‑installed Python, Chromium, Tor available.
Parrot OS	✅ Fully tested	Same as Kali – all dependencies available.
Ubuntu / Debian	✅ Works	Install Python 3.7+, pip, and optional tools (Tor, Chromium).
macOS	✅ Works	Python 3.7+ via Homebrew; install Chromium separately.
Windows	✅ Works	Python 3.7+ and Chrome required; Tor optional.

Quick Setup for Different OS

Kali / Parrot / Debian / Ubuntu

# Install dependencies
sudo apt update
sudo apt install tor chromium -y
pip install -r requirements.txt

macOS

# Install Homebrew first, then:
brew install tor chromium
pip install -r requirements.txt

Windows

• Install Python 3.7+ from python.org
• Install Chrome from google.com/chrome
• (Optional) Install Tor Browser or run Tor daemon.
• Open Command Prompt as Administrator and run:

pip install -r requirements.txt

---

📦 Installation

# Clone the repository
git clone https://github.com/TnYtCoder/DorkScout.git
cd DorkScout

# Install dependencies
pip install -r requirements.txt

Note: For Tor proxy support, install Tor (sudo apt install tor) and start the service (sudo systemctl start tor). For browser mode, ensure Chrome/Chromium is installed (Selenium will use it).

---

🚀 Quick Start

# Basic investigation
python dorkscout.py --username johndoe

# With name and email
python dorkscout.py --username johndoe --name "John Doe" --email john@example.com

# Use Tor proxy rotation
python dorkscout.py --username johndoe --tor

# Deep dorking (filetype, intitle, inurl)
python dorkscout.py --username johndoe --deep-dork

# Browser mode (renders JavaScript)
python dorkscout.py --username johndoe --no-headless

# Use Google API (no captcha)
python dorkscout.py --username johndoe --api YOUR_API_KEY --cx YOUR_CX

# Save results automatically
python dorkscout.py --username johndoe --output

---

⚙️ Command Reference

Argument	Description
--username	Username to investigate
--name	Full name
--email	Email address
--phone	Phone number
--delay	Delay between requests (default: 2.0s)
--threads	Number of concurrent threads (default: 5)
--max-results	Max results per query (default: 20)
--verbose	Verbose output
--tor	Enable Tor proxy rotation
--deep-dork	Enable advanced dorking (filetype, intitle, inurl)
--no-headless	Use visible browser (Selenium)
--output	Automatically save results without prompt
--api-key	Google Custom Search API key
--cx	Google Custom Search Engine ID
--force	Skip legal warning (use only when authorized)

---

🔧 Advanced Options

Google API Setup (Captcha‑Free)

1. Create a project at Google Cloud Console.
2. Enable Custom Search API.
3. Generate an API key.
4. Create a Programmable Search Engine at cse.google.com (you can use * as the site).
5. Copy the Search Engine ID (cx).
6. Run with --api-key YOUR_KEY --cx YOUR_CX.

Tor Proxy Rotation

• Install Tor and start the service.
• DorkScout automatically uses ports 9050, 9051, 9052 if available.
• Add --tor to enable rotation.

Browser Mode

• Requires Selenium and Chrome/Chromium.
• Use --no-headless to see the browser window (helpful for debugging or captcha challenges).

---

📊 Output

Upon completion, DorkScout displays:

• Direct Hits – profiles found via direct URL check.
• Search Results – total URLs discovered.
• Verified Profiles – profiles with confidence ≥50%.
• Documents – documents (PDFs, spreadsheets, etc.).
• Contact Information – emails, phone numbers, usernames.

You can save the report as JSON and/or TXT when prompted, or use --output to save automatically.

---

📚 Documentation

Full documentation, examples, and API reference are available on our GitHub Pages site.

---

🐛 Reporting Issues

Found a bug or have a feature request? Please open an issue on GitHub.

---

⚖️ Legal Disclaimer

This tool is for AUTHORIZED OSINT investigations only.
You must have explicit permission to investigate any target. Unauthorized use may violate privacy laws and terms of service. The author assumes no liability for misuse.

By using this software, you agree that you are solely responsible for complying with all applicable laws and regulations.

---

📄 License

MIT License – see LICENSE file for details.

---

🤝 Contributing

Contributions are welcome! Open an issue or pull request.

---

🙏 Acknowledgments

• Built with Python, requests, BeautifulSoup, Selenium, and colorama.
• Inspired by the OSINT community.

---

Documentation | Report Bug | Request Feature