DorkScout – OSINT Investigation Tool

Why DorkScout?

⚡

Lightning Fast

Multi‑threaded architecture – hundreds of requests per minute.

🎯

Advanced Dorking

filetype:, intitle:, inurl: – uncover hidden documents and pages.

🧅

Tor Proxy Rotation

Rotate IPs automatically to avoid rate limits and detection.

🌐

Browser Mode

Render JavaScript‑heavy sites with Selenium (visible browser).

🔍

Confidence Scoring

Each result scored 0–100% based on multiple verification methods.

📊

Deep Extraction

Bio, location, followers, emails, phones, usernames.

See It In Action

Report example — Detailed intelligence report

Browser mode — Visible browser mode for JavaScript-heavy sites

📘 Complete User Guide

Installation

git clone https://github.com/TnYtCoder/DorkScout.git
cd DorkScout
pip install -r requirements.txt

For Tor support, install and start Tor: sudo apt install tor && sudo systemctl start tor.
For browser mode, install Chrome/Chromium.

Basic Usage

# Basic username 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 (JavaScript rendering)
python dorkscout.py --username johndoe --no-headless

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

Command Reference

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

📌 Real‑World Examples

Finding a GitHub profile

$ python dorkscout.py --username tnytcoder

[→] 10:30:15 - Searching: github - tnytcoder site:github.com
[✓] 10:30:16 - Direct hit! GITHUB: https://github.com/tnytcoder
[✓✓] 10:30:17 - Verified GITHUB: https://github.com/tnytcoder (Confidence: 100%)

Deep dorking for documents

$ python dorkscout.py --name "John Doe" --deep-dork

[→] 10:31:20 - Searching: documents - "John Doe" filetype:pdf
[✓] 10:31:22 - Found document: https://example.com/resume.pdf
[→] 10:31:23 - Searching: documents - "John Doe" filetype:docx
[✓] 10:31:25 - Found document: https://example.com/biography.docx

Using Tor proxy to avoid captcha

$ python dorkscout.py --username target --tor

[+] 10:32:10 - Proxy detected. Using IP rotation.
[→] 10:32:12 - Searching: github - target site:github.com
[✓] 10:32:15 - Found GITHUB: https://github.com/target

🔑 Google API Setup (Captcha‑Free)

Go to Google Cloud Console and create a project.
Enable the Custom Search API.
Generate an API key.
Create a Programmable Search Engine at cse.google.com (use * as the site).
Copy the Search Engine ID (cx).
Run DorkScout with --api-key YOUR_KEY --cx YOUR_CX.

You get 100 free searches per day – no captcha, no blocks.

🧅 Tor Proxy Rotation

DorkScout can rotate your IP address through the Tor network, helping you avoid rate limits and detection.

# Install Tor
sudo apt install tor

# Start the Tor service
sudo systemctl start tor

# Run DorkScout with Tor
python dorkscout.py --username target --tor

DorkScout automatically uses ports 9050, 9051, and 9052 if multiple Tor instances are running. The tool will fall back to direct mode if Tor is not available.

🌐 Browser Mode

For websites that rely heavily on JavaScript or present complex challenges, DorkScout can launch a real Chrome/Chromium browser to render the page.

# Run with visible browser
python dorkscout.py --username target --no-headless

This mode uses Selenium and requires Chrome or Chromium installed. The browser window is visible, which helps with debugging or solving captchas manually.

⚖️ 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.