GDorks Web
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!
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.
Give us a if you find this project helpful!
If you like this project, please consider giving it a star on GitHub. Your support motivates me to keep improving it!
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
aiohttpfor 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
2. Navigate to the Project Directory
3. Set Up a Virtual Environment
4. Activate the Virtual Environment
- On Windows:
venv\Scripts\activate
- On macOS/Linux:
source venv/bin/activate
5. Install Dependencies
6. Configure Environment Variables
Create a .env file in the root directory and add your GitHub Personal Access Token (PAT):
GITHUB_PAT=your_personal_access_token_here
Note: You can create a GitHub Personal Access Token here.
7. Run the Flask Application
Open your browser and go to http://127.0.0.1:5000/ to access the app locally.
Usage
- Choose a Category: Type in the category you want (e.g., "CCTV").
- Specify the Number of Dorks: Enter the number of random dorks you wish to retrieve.
- 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!
Star History
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:
- Fork the repository.
- Create a feature branch (
git checkout -b feature-xyz). - Make your changes.
- Commit and push your changes to your fork.
- Submit a pull request.
License
This project is open-source and available under the MIT License. See the LICENSE file for more details.