Skip to content

Latest commit

 

History

History
144 lines (91 loc) · 5.41 KB

README.md

File metadata and controls

144 lines (91 loc) · 5.41 KB

GDorks Web

Language License GitHub Repo Size GitHub Issues GitHub Pull Requests GitHub Contributors GitHub Last Commit GitHub Forks GitHub Stars GitHub Watchers Dorks

Welcome to GDorks Web — your gateway to discovering random Google Dorks straight from the GDorks repository! This web application allows you to explore and retrieve Google Dorks (specific search queries) organized into categories, all powered by GitHub's repository contents.

Give us a ⭐️ if you find this project helpful!

🚀 Live Demo

Check out the live version of GDorks Web hosted on Vercel!

🧑‍💻 Developed by:

Ishan Oshada, a passionate web developer and cybersecurity enthusiast from Sri Lanka. This project is built to combine my skills in Python, Flask, and web security!

Feel free to check out my GitHub: @Ishanoshada.

🔑 Main GitHub Repository

The core data for the dorks is fetched from the official GDorks repository: GDorks GitHub Repo.

🌟 Features

  • Browse Categories: View all available categories (folders) from the GDorks repository.
  • Get Random Dorks: Select a category and retrieve random dorks from files within that category.
  • GitHub Integration: Uses GitHub API to fetch data from the GDorks repository.
  • Asynchronous Requests: Non-blocking requests using aiohttp for fetching data, ensuring a smooth user experience.

⚙️ Technologies Used

  • Flask: A lightweight Python web framework for building the backend.
  • aiohttp: Asynchronous HTTP client for making non-blocking requests to GitHub.
  • GitHub API: Fetching dorks directly from the GDorks repository.
  • HTML/CSS/JS: Frontend for displaying categories and dorks.
  • Python-dotenv: Loading environment variables like GitHub Personal Access Token (PAT).
  • Vercel: Deployment platform for hosting the web app.

💻 Installation

Follow the steps below to get this project running on your local machine.

1. Clone the Repository

git clone https://github.com/Ishanoshada/GDorks-web.git

2. Navigate to the Project Directory

cd GDorks-web

3. Set Up a Virtual Environment

python -m venv venv

4. Activate the Virtual Environment

  • On Windows: 
    venv\Scripts\activate
  • On macOS/Linux: 
    source venv/bin/activate

5. Install Dependencies

pip install -r requirements.txt

6. Configure Environment Variables

Create a .env file in the root directory and add your GitHub Personal Access Token (PAT):

api/.env
    GITHUB_PAT=your_personal_access_token_here

Note: You can create a GitHub Personal Access Token here.

7. Run the Flask Application

python api/index.py

Open your browser and go to http://127.0.0.1:5000/ to access the app locally.

📱 Usage

  1. Choose a Category: Type in the category you want (e.g., "CCTV").
  2. Specify the Number of Dorks: Enter the number of random dorks you wish to retrieve.
  3. Explore Dorks: View the selected category and the corresponding random dorks from the files in that category.

Show Your Support

Give us a ⭐️ if GDorks has been your guide in the vast online landscape!

Disclaimer

This list is for educational purposes only. Use Google dorks responsibly, respect privacy, intellectual property, and abide by all laws and regulations. Let's make the internet safer and more secure together!

Happy dorking! 🌟

Repository Views Views

Star History

Star History Chart

🤝 Contributing

I welcome contributions to improve this project! If you have ideas for new features or bug fixes, feel free to fork the repository and submit a pull request.

How to Contribute:

  1. Fork the repository.
  2. Create a feature branch (git checkout -b feature-xyz).
  3. Make your changes.
  4. Commit and push your changes to your fork.
  5. Submit a pull request.

🔒 License

This project is open-source and available under the MIT License. See the LICENSE file for more details.