Skip to content

dharmstm/SurfaceHunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

16 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸ•΅οΈβ€β™‚οΈ SurfaceHunter

Advanced OSINT & Reconnaissance Automation Platform

License: MIT OSINT Recon Platform

A powerful browser-based reconnaissance tool for penetration testers, bug bounty hunters, and security researchers.

πŸš€ Live Demo β€’ πŸ“– Documentation β€’ 🀝 Contribute


SurfaceHunter Banner


πŸ“‹ Table of Contents


🎯 Overview

SurfaceHunter automates the reconnaissance phase of security assessments by eliminating manual Google Dorking and parameter hunting. Built for efficiency and ease of use, it accelerates the discovery of hidden attack surfaces across web applications.

Why SurfaceHunter?

Reconnaissance is the foundation of every successful security assessment. Instead of manually crafting hundreds of Google queries, SurfaceHunter provides:

  • βœ… 250+ Pre-built Google Dorks across 24+ vulnerability categories
  • βœ… OWASP Top-25 Parameter Discovery with 150+ high-risk patterns
  • βœ… Zero Configuration β€” Works directly in your browser
  • βœ… Bug Bounty Optimized β€” Professional recon workflow
  • βœ… Educational Resource β€” Learn OSINT & reconnaissance techniques

⚠️ Note: This tool performs reconnaissance only. It does NOT exploit vulnerabilities.


✨ Key Features

πŸ” Advanced Google Dork Engine

Discover hidden assets with 250+ curated Google Dorks covering:

24+ Vulnerability Categories (Click to expand)
  • πŸ” Admin & Login Panels
  • πŸ’‰ SQL Injection (SQLi)
  • 🎯 Cross-Site Scripting (XSS)
  • πŸ“ Local File Inclusion (LFI)
  • 🌐 Server-Side Request Forgery (SSRF)
  • β†ͺ️ Open Redirect
  • πŸ’Ύ Backup & Configuration Files
  • πŸ—„οΈ Exposed Databases
  • πŸ”Œ API Endpoints & Documentation
  • ☁️ Cloud Storage Buckets (AWS S3, Azure, GCP)
  • πŸ”§ Git Repositories & Version Control
  • πŸ“‚ Directory Listings
  • πŸ”Œ WordPress Security Issues
  • πŸ› Debug & Error Pages
  • πŸ”‘ Sensitive Files (.env, .log, .bak, .sql)
  • πŸ“Š Analytics & Tracking Scripts
  • 🎫 Session Tokens & Credentials
  • πŸ“± Mobile App Endpoints
  • πŸ” Authentication Bypass Vectors
  • And many more...

πŸ›‘οΈ OWASP Top-25 Parameter Scanner

Hunt vulnerable parameters with 150+ high-risk patterns mapped to:

Vulnerability Type Example Parameters
🌐 SSRF url=, uri=, path=, dest=
πŸ“ LFI file=, document=, folder=, pg=
πŸ’‰ SQL Injection id=, user=, product=, cat=
β†ͺ️ Open Redirect redirect=, return=, next=, goto=
🎯 XSS q=, search=, keyword=, query=
⚑ RCE cmd=, exec=, command=, ping=

⚑ Professional Recon Workflow

  • Severity Classification: 🟒 Low β€’ 🟑 Medium β€’ 🟠 High β€’ πŸ”΄ Critical
  • One-Click Search: Automated Google query execution
  • Copy-Paste Ready: Instant query generation
  • Cyber-Themed UI: Professional, hacker-aesthetic interface
  • Real-Time Results: No backend, no delays

🌐 Fully Client-Side Architecture

  • βœ… No Backend Required β€” Pure client-side JavaScript
  • βœ… No API Keys Needed β€” Direct browser execution
  • βœ… Privacy First β€” Zero data collection
  • βœ… Instant Deployment β€” GitHub Pages compatible
  • βœ… Cross-Platform β€” Works on any modern browser

🧠 How It Works

Step-by-Step Workflow

graph LR
    A[Enter Target Domain] --> B[Select Recon Module]
    B --> C[Google Dork / OWASP Params]
    C --> D[Generate Queries]
    D --> E[Execute Search]
    E --> F[Manual Testing]
Loading

1️⃣ Enter Target Domain

Example: testphp.vulnweb.com

2️⃣ Select Recon Module

Choose from:

  • πŸ” Google Dork Categories (Admin Panels, SQLi, XSS, etc.)
  • πŸ›‘οΈ OWASP Parameter Scanner (SSRF, LFI, Open Redirect, etc.)

3️⃣ Automated Query Generation

SurfaceHunter generates optimized Google queries:

site:example.com inurl:login
site:example.com inurl:id=
site:example.com filetype:env
site:example.com inurl:admin intitle:"login"

4️⃣ Manual Testing Phase

Use discovered assets with:

  • πŸ”§ Burp Suite β€” Intercept & modify requests
  • 🌐 Browser DevTools β€” Analyze responses
  • πŸ’‰ Payload Injection β€” Test for vulnerabilities
  • πŸ§ͺ Business Logic Testing β€” Manual verification

πŸ› οΈ Technology Stack

Frontend Technologies

Technology Purpose
HTML5 Semantic structure & accessibility
CSS3 Cyberpunk UI, neon effects, animations
Vanilla JavaScript Dynamic rendering & automation

Design & UX

  • 🎨 Google Fonts β€” Orbitron, JetBrains Mono
  • 🎭 Font Awesome β€” Professional iconography
  • 🌌 Canvas API β€” Animated Matrix-style background

Security Concepts

Google Search Operators:

site:     # Restrict to specific domain
inurl:    # Search within URL
intitle:  # Search page titles
filetype: # Find specific file types

OWASP Testing Guide Integration:

  • Parameter fuzzing patterns
  • Common vulnerability vectors
  • Real-world bug bounty techniques

πŸš€ Getting Started

Quick Start (3 Steps)

  1. Visit the Live Demo

    https://dharmendrastm.github.io/GoogleDork/
    
  2. Enter Your Target Domain

    example.com
    
  3. Start Hunting

    • Select a dork category
    • Click "Search Google"
    • Analyze results

Self-Hosting (GitHub Pages)

# Fork this repository
git clone https://github.com/dharmendrastm/GoogleDork.git
cd GoogleDork

# Enable GitHub Pages
# Settings β†’ Pages β†’ Source: main branch

# Your instance will be live at:
# https://yourusername.github.io/GoogleDork/

Local Development

# Clone the repository
git clone https://github.com/dharmendrastm/GoogleDork.git
cd GoogleDork

# Open in browser
open index.html
# or
python -m http.server 8000

πŸ’Ό Use Cases

For Penetration Testers

  • Accelerate reconnaissance phase
  • Discover forgotten subdomains
  • Find exposed admin panels
  • Identify configuration errors

For Bug Bounty Hunters

  • Uncover hidden endpoints
  • Hunt vulnerable parameters
  • Discover sensitive file exposures
  • Optimize recon workflow

For Security Students

  • Learn OSINT techniques
  • Understand Google Dorking
  • Practice reconnaissance methodology
  • Build portfolio projects

For Red Teamers

  • Initial access research
  • Target profiling
  • Asset discovery
  • Attack surface mapping

πŸ›£οΈ Roadmap

Upcoming Features

  • Wayback Machine Integration β€” Historical URL discovery
  • Subdomain Enumeration β€” Automated subdomain finder
  • Parameter Brute-Force β€” Custom wordlist support
  • Export Functionality β€” CSV/TXT/JSON reports
  • Recon Notes System β€” Built-in note-taking
  • CVSS Integration β€” Severity scoring
  • Dark Mode Toggle β€” UI customization
  • Multi-Target Support β€” Batch domain scanning
  • API Rate Limiting β€” Respect search quotas
  • Custom Dork Builder β€” User-defined queries

Long-Term Vision

  • Browser extension version
  • Mobile app (PWA)
  • Integration with Burp Suite/OWASP ZAP
  • Community dork database
  • AI-powered query optimization

🀝 Contributing

Contributions make the open-source community thrive! Here's how you can help:

Ways to Contribute

  1. ⭐ Star this repository β€” Show your support
  2. 🍴 Fork & improve β€” Add new features
  3. πŸ› Report bugs β€” Help us improve
  4. πŸ’‘ Suggest ideas β€” Feature requests welcome
  5. πŸ“ Improve docs β€” Better documentation

Contribution Ideas

  • Add new Google Dork categories
  • Expand OWASP parameter lists
  • UI/UX enhancements
  • Performance optimizations
  • Internationalization (i18n)
  • Accessibility improvements

How to Contribute

# 1. Fork the repository
# 2. Create your feature branch
git checkout -b feature/AmazingFeature

# 3. Commit your changes
git commit -m 'Add some AmazingFeature'

# 4. Push to the branch
git push origin feature/AmazingFeature

# 5. Open a Pull Request

βš–οΈ Legal Disclaimer

🚨 READ CAREFULLY

This tool is intended ONLY for:

  • βœ… Educational purposes
  • βœ… Authorized security testing
  • βœ… Legal penetration testing engagements
  • βœ… Bug bounty programs with explicit permission

❌ Prohibited Use

DO NOT use this tool:

  • Without explicit written authorization
  • Against systems you don't own or have permission to test
  • For any illegal activities
  • To cause harm or disruption

Legal Responsibility

  • Unauthorized access is illegal in most jurisdictions
  • You are solely responsible for your actions
  • The developer assumes NO LIABILITY for misuse
  • Always obtain written permission before testing
  • Follow responsible disclosure practices

πŸ” Use ethically. Test responsibly. Hack legally.


πŸ“œ License

This project is licensed under the MIT License β€” see the LICENSE file for details.

MIT License

Copyright (c) 2025 Dharmendra Kumar

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

πŸ‘¨β€πŸ’» Author

Dharmendra Kumar

Penetration Tester | Security Researcher | OSINT Enthusiast

LinkedIn GitHub

Also known as: dharmendrahacker β€’ dharmendracyberhack


πŸ’¬ Let's Connect

Have questions? Want to collaborate? Reach out!

πŸ“§ Professional inquiries: LinkedIn
πŸ› Bug reports: GitHub Issues
πŸ’‘ Feature requests: Discussions


🌟 Acknowledgments

  • OWASP Foundation β€” For security testing guidelines
  • Bug Bounty Community β€” For reconnaissance best practices
  • Open Source Contributors β€” For making security accessible

πŸ”₯ Made with ❀️ by Dharmendra Kumar

SurfaceHunter β€” Hunt the Attack Surface, Not the Vulnerabilities

Star History Follow


If this project helped you, consider giving it a ⭐

Β© 2025 SurfaceHunter | All Rights Reserved


πŸ›‘οΈ Security Notice

Found a security issue? Please report responsibly via private disclosure.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages