# wodxgod/gdorks architecture

> Architecture diagram of the GitHub repository wodxgod/gdorks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wodxgod/gdorks
- Repository: https://github.com/wodxgod/gdorks

## Overview

##### Project type and purpose
- This is an open-source command-line security tool (written in Python) called gDorks.
- Its purpose is to automate Google Dork queries to discover potentially vulnerable URLs (SQLi, XSS, file exposure, phpinfo leaks, etc.).

##### File structure
- Top-level:
- gdorks.py           ← main CLI entry point and orchestration script
- requirements.txt    ← Python dependencies (e.g., requests, BeautifulSoup)
- payloads/           ← lists of dork strings categorized by vulnerability type
- images/             ← assets for README (logo, screenshot)
- README.md           ← project description, usage, options
- No separate “frontend” or “backend” directories—this is a single-module CLI tool.
- No build or deployment scripts—runs directly under Python.

##### README for additional insights
- The tool accepts options (scrape, custom dork, timeout, proxy flags, proxyscrape).
- It plans to support proxy rotation and selective vulnerability scanning.

## Diagram (Mermaid)

```mermaid
graph TB
    %% External User
    User["User"]:::external

    %% gDorks CLI Tool Modules
    subgraph "gDorks CLI Tool"
        CLI["CLI Parser Module"]:::internal
        DM["Dork Manager / Payload Loader"]:::internal
        SE["Scraper Engine"]:::internal
        HC["HTTP Client"]:::internal
        PM["Proxy Manager"]:::internal
        RP["HTML Response Parser"]:::internal
        OF["Output Formatter"]:::internal
    end

    %% Data Store
    Payloads[(Payloads/*.txt)]:::datastore

    %% External Services
    Google["Google Search Engine"]:::external
    ProxyScrape["ProxyScrape API"]:::external

    %% Data Flow
    User -->|"invoke python gdorks.py [options]"| CLI
    CLI -->|"parsed options"| DM
    DM -->|"load payloads"| Payloads
    Payloads -->|"payload list"| DM
    DM -->|"dork list"| SE
    SE -->|"construct queries"| HC
    HC -->|"HTTP request"| Google
    HC -->|"route via proxy"| PM
    PM -->|"proxy list"| HC
    HC -->|"HTML response"| RP
    RP -->|"extracted URLs"| OF
    OF -->|"display results"| User

    %% Click Events
    click CLI "https://github.com/wodxgod/gdorks/blob/master/gdorks.py"
    click DM "https://github.com/wodxgod/gdorks/tree/master/payloads/"
    click SE "https://github.com/wodxgod/gdorks/blob/master/gdorks.py"
    click HC "https://github.com/wodxgod/gdorks/blob/master/gdorks.py"
    click PM "https://github.com/wodxgod/gdorks/blob/master/gdorks.py"
    click RP "https://github.com/wodxgod/gdorks/blob/master/gdorks.py"
    click OF "https://github.com/wodxgod/gdorks/blob/master/gdorks.py"

    %% Styles
    classDef internal fill:#ADD8E6,stroke:#333,stroke-width:2px
    classDef external stroke:#f66,stroke-dasharray:5 5,fill:#FFF
    classDef datastore fill:#FFE4B5,stroke:#333,stroke-width:2px
```
