Thanks to visit codestin.com
Credit goes to GitHub.com

Skip to content

DorkEye is a Python script for ethical dorking. The goal is to identify unintentionally exposed resources, such as sensitive files, login panels or indexed directories.

License

Notifications You must be signed in to change notification settings

xPloits3c/DorkEye

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

537309991-f4f59199-d30f-4628-bb92-e6ccf43a6814

DorkEye | Advanced OSINT Dorking Tool πŸ”

Python License Status DuckDuckGo Repo views Stars Forks Issues Last Commit Join Telegram


🐧 Hello, i don't break system, i search for their secrets.

What is DorkEye 🧠

  • DorkEye is an advanced osint automated dorking tool that leverages DuckDuckGo to discover exposed web resources through OSINT (Open Source Intelligence) techniques.
  • It can identify indexed directories, sensitive files, admin panels, databases, backups, and other publicly accessible resourcesβ€”all in an anonymous, efficient, and legal manner.

Why DorkEye

  • βœ… Bypass CAPTCHA and rate-limiting typical of mainstream search engines.
  • βœ… Maintain anonymity and privacy during searches, avoided IP blocks and detection mechanisms.
  • βœ… Access a clean, unfiltered index of web resources.
  • βœ… Dorking, analyze, extract metadata, test sqli vulnerability.

What's New

  • 🧠 SQL Param Vuln Automatically Testing for SQL vulnerabilty after Potenzial SQLi Found
  • πŸ” Advanced File Metadata Analysis - Checks file accessibility, size, and content-type
  • πŸ—‚οΈ Global Deduplication - Removes duplicate URLs across all dorks
  • πŸ“ˆ Detailed Statistics - Comprehensive analytics and category breakdowns
  • βš™οΈ Configuration Files - YAML/JSON config support for advanced customization
  • 🎨 Rich Terminal UI - Beautiful progress bars and formatted output
  • 🎯 File Analysis & Categorization - Automatically categorizes results by file type (documents, archives, databases, backups, configs, scripts, credentials)
  • -- πŸ“„ Documents .pdf, .doc, .docx, .xls, .xlsx, .ppt, .pptx Office documents, reports
  • -- πŸ“¦ Archives .zip, .rar, .tar, .gz, .7z, .bz2 Compressed files, backups
  • -- πŸ—„οΈ Databases .sql, .db, .sqlite, .mdb Database dumps, exports
  • -- πŸ’Ύ Backups .bak, .backup, .old, .tmp Backup files, temp data
  • -- βš™οΈ Configs .conf, .ini, .yaml, .json, .xml Configuration files
  • -- πŸ“œ Scripts .php, .asp, .jsp, .sh, .bat, .ps1 Server-side scripts
  • -- πŸ”‘ Credentials .env, .git, .svn, .htpasswd Sensitive auth files
  • πŸ’Ύ Multiple Export Formats - CSV, JSON, and interactive HTML reports structured data with columns
  • -- URL, Title, Snippet, Dork, Timestamp
  • -- Extension, Category, File Size, Content Type
  • -- Accessibility Status, HTTP Status Code

Feature Description

  • πŸ”Ž Smart Dorking Execute single or multiple dorks from files
  • 🚫 Extension Filtering Blacklist/whitelist specific file types
  • πŸ” File Analysis Check file size, content-type, and accessibility
  • 🎯 Global Deduplication Intelligent URL hash-based duplicate removal
  • ⚑ Rate Limit Protection Smart delays to avoid blocking
  • πŸ“ˆ Detailed Statistics Real-time metrics and category breakdowns
  • βš™οΈ Config Support YAML/JSON configuration files
  • 🎨 Beautiful UI Rich terminal interface with progress tracking
  • πŸ“¦ Automatic Installation

Quick Install

  • πŸ“¦ For full installation instructions on all platforms, follow the complete guide: INSTALL GUIDE
install_dorkeye install_dorkeye0
  • sudo apt update
    
  • sudo apt install -y python3 python3-pip python3-venv git
    
  • git clone https://github.com/xPloits3c/DorkEye.git
    
  • cd DorkEye
    
  • python3 -m venv dorkeye_env
    
  • source dorkeye_env/bin/activate
    
  • sudo chmod +x setup.sh
    
  • ./setup.sh
    

Test:

help_dorkeye
  • python dorkeye.py --help
    

Exit Virtual environment:

  • deactivate
    

Remove Virtual environment:

  • cd DorkEye
    
  • rm -rf dorkeye_env
    

πŸš€ Usage

result_dorkeye

Basic search

  • python3 dorkeye.py -d "inurl:admin" -o results
    

Advanced search with SQLi testing

  • python3 dorkeye.py -d "site:example.com .php?id=" --sqli -o scan
    

Stealth mode for sensitive targets

  • python3 dorkeye.py -d dorks.txt --stealth --sqli -c 100 -o stealth_scan
    

Filter specific file types

  • python3 dorkeye.py -d "site:target.com" --whitelist .pdf .doc .xls -o documents
    

Fast search without file analysis

  • python3 dorkeye.py -d dorks.txt --no-analyze -c 50 -o quick_scan
    

Generate config file

  • python3 dorkeye.py --create-config
    

Simple search

  • python3 dorkeye.py -d "site:example.com filetype:pdf" -o results
    

Multiple dorks from file

  • python3 dorkeye.py -d dorks.txt -c 100 -o output
    

With file analysis

  • python3 dorkeye.py -d "inurl:admin" -o admin_pages
    

Advanced Usage

SQL Injection Test + Stealth

  • python dorkeye.py -d dorks.txt --stealth --sqli -o results
    
  • python dorkeye.py -d "site:example.com .php?id=" --sqli -o results
    
  • python dorkeye.py -d dorks.txt --sqli --stealth -c 100 -o scan
    

Only PDF and Excel files

  • python3 dorkeye.py -d "filetype:pdf OR filetype:xls" --whitelist .pdf .xls .xlsx -o documents
    

Exclude images

  • python3 dorkeye.py -d "site:.com" --blacklist .jpg .png .gif .svg -o no_images
    

Custom configuration

  • python3 dorkeye.py -d dorks.txt --config custom_config.yaml -o results
    

Fast mode (no file analysis)

  • python3 dorkeye.py -d dorks.txt --no-analyze -c 200 -o fast_results 
    

Admin panels

  • inurl:admin intitle:login
    
  • inurl:administrator
    
  • site:.com inurl:wp-admin
    

Sensitive files

  • filetype:sql "MySQL dump"
    
  • filetype:env DB_PASSWORD
    
  • filetype:log inurl:access.log
    

Documents

  • site:.edu filetype:pdf "confidential"
    
  • site:.gov filetype:xls
    
  • inurl:uploads filetype:pdf
    

Configuration files

  • filetype:conf intext:password
    
  • filetype:ini "database"
    
  • ext:xml inurl:config
    

Search for database dumps

  • python3 dorkeye.py -d "filetype:sql" --whitelist .sql -o database_dumps
    

Gather leaked documents

  • python3 dorkeye.py -d "site:.com filetype:pdf confidential" -o leaked_docs
    

Find exposed credentials

  • python3 dorkeye.py -d "filetype:env OR filetype:git" -o credentials
    

Check for exposed backups

  • python3 dorkeye.py -d "site:company.com filetype:bak OR filetype:backup" -o backups
    

Find configuration files

  • python3 dorkeye.py -d "site:company.com ext:conf OR ext:ini" -o configs
    

Multiple targets from file

  • python3 dorkeye.py -d sqli_dorks.txt --stealth --sqli -c 200 -o dorks
    

photo_5_2026-01-18_20-13-17 photo_6_2026-01-18_20-13-17 photo_3_2026-01-18_20-13-17

πŸ”’ Best Practices

  • βœ… Always obtain written permission before testing
  • βœ… Use only on authorized targets or public data
  • βœ… Respect robots.txt and site policies
  • βœ… Follow responsible disclosure for findings
  • ❌ Never access or download unauthorized data
  • ❌ Never use for malicious purposes

πŸš€ Operational Tips

  • πŸ•’ Use appropriate delays to avoid rate limiting
  • πŸ”„ Rotate search terms for better coverage
  • πŸ“Š Analyze HTML reports for visual insights
  • 🎯 Combine with other OSINT tools (Maltego, theHarvester)
  • πŸ’Ύ Keep dork libraries organized and categorized
  • πŸ” Integrate findings with vulnerability scanners (SQLMap, Nuclei, Nikto)

πŸ“ Project Structure

DorkEye/

  • β”œβ”€β”€ dorkeye.py # Main script
  • β”œβ”€β”€ requirements.txt # Python dependencies
  • β”œβ”€β”€ setup.sh # Linux/macOS setup script
  • β”œβ”€β”€ setup.bat # Windows setup script
  • β”œβ”€β”€ run_dorkeye.sh # Quick launcher (Linux/macOS)
  • β”œβ”€β”€ run_dorkeye.bat # Quick launcher (Windows)
  • β”œβ”€β”€ INSTALL.md # Detailed installation guide
  • β”œβ”€β”€ README.md # This file
  • β”œβ”€β”€ dorkeye_config.yaml # Sample configuration
  • β”œβ”€β”€ Dorks4SecTest.txt # Example dorks (security test)
  • β”œβ”€β”€ dorks.txt # Your dorks (optional)
  • β”œβ”€β”€ dorkeye_env/ # Virtual environment
  • └── Dump/ # Output directory (auto-created)
  • β”œβ”€β”€ *.csv # CSV exports
  • β”œβ”€β”€ *.json # JSON exports
  • └── *.html # HTML reports

🧩 Future Roadmap

  • Multi-threaded searching for faster results
  • Active vulnerability scanner integration
  • Interactive TUI with textual
  • Browser extension for quick dorking
  • Cloud storage integration (AWS S3, Google Drive)
  • Custom search engine support (Bing, Shodan)
  • API endpoint for automation
  • Collaborative sharing platform
  • Machine learning for dork optimization

⚠️ Legal Disclaimer

  • READ CAREFULLY BEFORE USE

  • This tool is provided for educational, research, and authorized security testing purposes only.

  • βš–οΈ Unauthorized access to computer systems is illegal in most jurisdictions

  • πŸ”’ Always obtain written permission before testing

  • πŸ“œ Users are solely responsible for compliance with local laws

  • 🚫 The author disclaims all liability for misuse or damages

  • βœ… Use responsibly and ethically at all times

πŸ“œ By using DorkEye, you agree to:

  • Use only on authorized targets or public information
  • Comply with all applicable laws and regulations
  • Not use for malicious, illegal, or unethical purposes
  • Take full responsibility for your actions

πŸ“ž Contact & Support

βœ… Support the Project

  • ⭐ Star this repository
  • πŸ› Report bugs via Issues
  • πŸ’‘ Suggest features via Discussions
  • 🀝 Fork the repository:

πŸ“œ MIT License

  • Copyright (c) 2026 xPloits3c I.C.W.T

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.

If you found DorkEye useful, please 🌟 the repository