Skip to content

Home

Jump to bottom
alzzdev edited this page Jun 12, 2026 · 2 revisions

Welcome to Atdork

WindowsTerminal_toSzpIzjnI

Atdork is a lightweight OSINT and security research tool that leverages the DuckDuckGo metasearch engine (and others) to run advanced search queries — often called dorks — from the command line.
It helps penetration testers, bug bounty hunters, and OSINT analysts efficiently discover publicly exposed documents, directories, login panels, and other valuable information.

Why Atdork?

  • Fast & flexible – interactive prompts or pure CLI for scripting.
  • Multi‑engine – query Google, Bing, DuckDuckGo, Yandex, and more.
  • Batch ready – run dozens of dorks from a file or a single string.
  • Anonymity built‑in – proxy rotation, Tor fallback, and strict mode to protect your IP.
  • Smart handling – automatic retries, delays, User‑Agent rotation, and dead proxy removal.
  • Clean output – results can be saved as TXT, JSON, or CSV, either combined or per query.

Quick Start

# Interactive mode (asks for query and options step by step)
python main.py --interactive

# Command-line mode (single search)
python main.py -q "site:gov filetype:pdf" -r 20

# Batch mode from a file
python main.py --batch-file dorks.txt -r 10 --format json -o results.json

Key Features

  • Interactive & non‑interactive modes – answer prompts or provide all arguments directly.
  • Multiple search backends – choose from auto, google, bing, duckduckgo, brave, yandex, startpage, wikipedia, and more.
  • Batch processing – load queries from a .txt file (one per line) or from a comma/semicolon separated string.
  • Proxy pool with rotation – supply proxies via file, command line, or enable Tor; set cooldown and failure thresholds.
  • Strict anonymity – prevent any direct connection when proxies are mandatory (--strict).
  • User‑Agent rotation – a built-in pool of modern User‑Agent strings that changes automatically.
  • Output flexibility – export to TXT, JSON, or CSV; save individual query results or a combined file.
  • Throttling & retries – control request delay, timeout, and retry attempts to stay under rate limits.
  • Debug mode – verbose logging to troubleshoot proxy or engine issues.

Navigating the Wiki

Page Description
Installation Requirements and step-by-step setup
Quick Start Minimal examples to get you running
Usage Guide Deep dive into interactive, CLI, batch, and proxy modes
Command Reference Complete list of all command-line flags
Examples & Use Cases Real‑world scenarios (bug bounty, recon, reporting)
Troubleshooting & FAQ Common issues and answers
Contributing How to report bugs, request features, and contribute code

Ethical Use

This tool is intended for legal and authorised security testing only.
Always ensure you have proper permission before scanning or collecting information from any target. Misuse is the responsibility of the user.

License & Credits

Atdork is released under the MIT License.
Created by alzzmarket.
If you find this project helpful, consider giving it a ⭐ on GitHub.

Clone this wiki locally