quick start

Quick Start

This page gives you a minimal set of commands to start using Atdork immediately.

---

Interactive Mode

The simplest way to run Atdork – the tool will guide you.

python main.py --interactive

You'll be prompted for:

• Your search query (dork)
• Maximum number of results
• Whether to save the output

All other settings (region, safesearch, backend, etc.) will use sensible defaults.

---

Single Query (Command Line)

Provide the query directly with -q:

python main.py -q "site:gov filetype:pdf" -r 20

This searches for PDF files on government sites and returns up to 20 results.
Results are printed to the terminal. Add -o results.json to save them.

---

Batch Processing from a File

Create a text file, dorks.txt, with one query per line:

# Dorks for week 1
intitle:index.of mp3
site:edu filetype:xls
inurl:admin login

Then run:

python main.py --batch-file dorks.txt -r 10 --format json -o batch_results.json

All queries are executed sequentially, and a single JSON file with all results is saved.

---

Batch Processing from a String

You can also pass multiple dorks inline. Use ; as a separator:

python main.py -q "dork1;dork2;dork3" --batch-separator ";" -r 5 --output-dir out --format csv

Each query gets its own .csv file inside the out/ folder.

---

Adding Proxies or Tor

For anonymous searches, use a proxy list or Tor:

# Tor only
python main.py -q "sensitive data" --tor --strict -r 10

# Proxy file
python main.py -q "admin panel" --proxy-file proxies.txt --strict --delay 1.5

--strict ensures your real IP is never used if all proxies fail.

---

Next: Usage Guide for a detailed walk‑through of all modes and options.