Dorkwright - Google Dorking Tool

Dorkwright ist ein leistungsstarkes Python-basiertes Google-Dorking-Tool, das das Extrahieren von Dateilinks aus Google-Suchergebnissen automatisiert und diese optional herunterlädt. Es verwendet Playwright für die Browserautomatisierung und beinhaltet CAPTCHA-Handling, Fortschrittsanzeigen und eine saubere CLI-Oberfläche.

Funktionen

Automatisiertes Google-Dorking (Suchergebnis-Scraping)
Extrahiert Datei-URLs (PDF, DOC, XLS, etc.)
Optionales automatisches Herunterladen von Dateien
CAPTCHA-erkennend (wartet auf Benutzerlösung)
Speichert Ergebnisse in einer Ausgabedatei
Unterstützung für Massen-Downloads
Proxy-Unterstützung für Downloads
FlareSolverr-Integration zur Umgehung des Cloudflare-Schutzes
Schnell und Playwright-gestützt

Verwendung

╔═══════════════════════════════════════════════════════════════════════════════╗
║                          DORKWRIGHT - Google Dorker                           ║
║         Extract file links from Google search results and download them       ║
╚═══════════════════════════════════════════════════════════════════════════════╝

options:
  -h, --help            show this help message and exit
  -q, --query QUERY     Google search query (e.g., "site:example.com filetype:doc")
  -p, --pages N         Maximum number of result pages to scrape (default: 10)
  -d, --delay SECONDS   Delay between page requests to avoid CAPTCHA (default: 3)
  -o, --output FILE     Output file for extracted links (default: file_links.txt)
  --download            Download files after extracting links
  --download-dir DIR    Directory to save downloaded files (default: downloads)
  --input-file FILE     Input file with URLs to download (skip search if provided)
  --proxy URL           Proxy server URL (e.g., http://127.0.0.1:8080)
  --flaresolverr URL    FlareSolverr endpoint for bypassing Cloudflare

Beispiele

Suchen und Links speichern

dorkwright.py -q "site:example.com filetype:doc OR filetype:docx OR filetype:dot"
dorkwright.py -q "site:example.com filetype:pdf" -p 5 -o results.txt

Suchen und sofort herunterladen

dorkwright.py -q "site:example.com filetype:doc" --download --download-dir downloads

Aus vorhandener Dateiliste herunterladen

dorkwright.py --input-file file_links.txt --download-dir my_files

Mit Proxy herunterladen

# Verwendung eines HTTP-Proxys
dorkwright.py --input-file file_links.txt --proxy http://127.0.0.1:8080

# Verwendung eines SOCKS5-Proxys
dorkwright.py --input-file file_links.txt --proxy socks5://127.0.0.1:1080

Mit FlareSolverr herunterladen (Cloudflare-Umgehung)

# Aus vorhandener Datei mit FlareSolverr herunterladen
dorkwright.py --input-file file_links.txt --flaresolverr http://localhost:8191

# Suchen und mit FlareSolverr herunterladen
dorkwright.py -q "site:example.com filetype:pdf" --download --flaresolverr http://localhost:8191

Installation

git clone https://github.com/San-Tus/Dorkwright
cd Dorkwright
python -m venv .venv

Aktivieren Sie die virtuelle Umgebung:

OS	Befehl
Windows	`.venv\Scripts\activate`
Linux/macOS	`source .venv/bin/activate`

Installieren Sie die erforderlichen Pakete:

pip install -r requirements.txt
playwright install chromium

FlareSolverr-Einrichtung (Optional)

FlareSolverr ist ein Proxy-Server, der Cloudflare-Herausforderungen löst und Ihnen das Herunterladen von Dateien von Cloudflare-geschützten Websites ermöglicht.

Installations- und Einrichtungsanweisungen finden Sie in der offiziellen Dokumentation: https://github.com/FlareSolverr/FlareSolverr

Ausführen des Skripts

python dorkwright.py -h

Beispiel für die reale Nutzung:

python dorkwright.py -q "site:gchq.gov.uk filetype:doc OR filetype:docx OR filetype:xls OR filetype:xlsx OR filetype:pdf" -p 10 --download --download-dir GCHQ

Beispielausgabe (Scraping + CAPTCHA-Handling)

Searching Google for: site:gchq.gov.uk filetype:doc OR filetype:docx OR filetype:xls OR filetype:xlsx OR filetype:pdf
Max pages: 10
Delay between pages: 3s

Searching page 1...

============================================================
CAPTCHA DETECTED!
Please solve the CAPTCHA in the browser window.
Press ENTER here when done...
============================================================

Gefundene Links werden angezeigt als:

Found: https://www.gchq.gov.uk/files/CheltScienceFestivalTranscript.pdf
Found: https://www.gchq.gov.uk/files/NLCChallenge1_WT.pdf
...

Endgültige Liste der extrahierten URLs

============================================================
Found 77 unique file links:
============================================================
https://www.gchq.gov.uk/files/2020%20Christmas%20Card%20Solution.pdf
https://www.gchq.gov.uk/files/2020%20Christmas%20Card.pdf
https://www.gchq.gov.uk/files/2023%20GCHQ%20Christmas%20Challenge.pdf
https://www.gchq.gov.uk/files/2024%20Combined%20Pay%20Gap%20External%20-%20Updated.pdf
https://www.gchq.gov.uk/files/Answers.pdf
...
Saved 77 links to file_links.txt

Automatisierte Download-Ausgabe

Wenn --download aktiviert ist:

Starting downloads...

Found 77 URLs to download
Saving to directory: GCHQ

  ✓  2020 Christmas Card Solution.pdf                       3.30 MB
  ✓  2020 Christmas Card.pdf                                2.45 MB
  ✓  2023 GCHQ Christmas Challenge.pdf                      6.15 MB
  ✓  2024 Combined Pay Gap External - Updated.pdf         489.67 KB
  ✓  Answers.pdf                                         1016.25 KB
...

Beispiel für Download-Statistiken

================================================================================
                              DOWNLOAD STATISTICS
================================================================================
  Total files processed:     77
  Successfully downloaded:   77
  Failed downloads:          0
  Total size:                261.16 MB
  Time elapsed:              35.15s
  Average speed:             7.43 MB/s

  File types downloaded:
    .pdf       :  77 files
================================================================================

Dorkwright

Beliebteste