Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ishanoshada/gdorks-web
GDorks Web is a Flask-based web application that allows users to browse and retrieve random Google Dorks from the GDorks repository on GitHub. With asynchronous requests and GitHub API integration, users can select categories and specify how many dorks they want to fetch, all through an intuitive web interface.
https://github.com/ishanoshada/gdorks-web
ceh dork dork-finder dork-generator dork-scanner dork-searcher dorking dorks flask gdorks ghdb google-dork-generator google-dorking google-dorks google-hacking-database hacking infomation-gathering osint python search
Last synced: about 11 hours ago
JSON representation
GDorks Web is a Flask-based web application that allows users to browse and retrieve random Google Dorks from the GDorks repository on GitHub. With asynchronous requests and GitHub API integration, users can select categories and specify how many dorks they want to fetch, all through an intuitive web interface.
- Host: GitHub
- URL: https://github.com/ishanoshada/gdorks-web
- Owner: Ishanoshada
- License: mit
- Created: 2025-01-18T07:43:06.000Z (19 days ago)
- Default Branch: main
- Last Pushed: 2025-01-18T08:20:56.000Z (19 days ago)
- Last Synced: 2025-01-18T08:31:52.494Z (19 days ago)
- Topics: ceh, dork, dork-finder, dork-generator, dork-scanner, dork-searcher, dorking, dorks, flask, gdorks, ghdb, google-dork-generator, google-dorking, google-dorks, google-hacking-database, hacking, infomation-gathering, osint, python, search
- Language: HTML
- Homepage: https://gdork-web.vercel.app
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# GDorks Web
         
[](https://img.shields.io/)
Welcome to **GDorks Web** — your gateway to discovering random Google Dorks straight from the [GDorks repository](https://github.com/Ishanoshada/GDorks)! 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](https://gdork-web.vercel.app/)
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](https://github.com/Ishanoshada).
## 🔑 Main GitHub Repository
The core data for the dorks is fetched from the official GDorks repository: [GDorks GitHub Repo](https://github.com/Ishanoshada/GDorks).
## 🌟 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
```bash
git clone https://github.com/Ishanoshada/GDorks-web.git
```
### 2. Navigate to the Project Directory
```bash
cd GDorks-web
```
### 3. Set Up a Virtual Environment
```bash
python -m venv venv
```
### 4. Activate the Virtual Environment
- On **Windows**:
```bash
venv\Scripts\activate
```
- On **macOS/Linux**:
```bash
source venv/bin/activate
```
### 5. Install Dependencies
```bash
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):
```ini
api/.env
GITHUB_PAT=your_personal_access_token_here
```
**Note**: You can create a GitHub Personal Access Token [here](https://github.com/settings/tokens).
### 7. Run the Flask Application
```bash
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** 
## 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:
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](LICENSE) file for more details.