Dork Runner (Local Excel Version)
================================

Script name: execute_dork.py

What this is
------------
This tool builds Google dork queries from a local Excel reference library and opens
results in Chrome (or your default browser) in safe batches (10 tabs at a time).

It reads configuration from the `config_settings` tab and sources domains from the
module tabs (social media, code repos, etc.).

IMPORTANT: This version does NOT use Google OAuth. Analysts simply download the
latest spreadsheet as an Excel file and run locally.

Files you should have in the tool folder
----------------------------------------
- execute_dork.py
- master_source_library.xlsx   (MUST be named exactly this)

1) Install dependencies (one-time)
----------------------------------
This project uses uv for dependency management.

Run:
 bash dependancy.sh

What it does:
- checks that `uv` is installed
- creates/uses a uv virtual environment
- installs required Python packages (currently: openpyxl)

If uv is not installed:
- macOS (Homebrew):  brew install uv
- otherwise:         https://github.com/astral-sh/uv

2) Download the Excel file
--------------------------
Download the Google Sheet (https://docs.google.com/spreadsheets/d/1BIK8bhWO7Q9ZStfVQpbNxTSnkci6lGTM/) as an Excel file and save it into this folder as:

  master_source_library.xlsx

If your browser downloads it with a different name (e.g., Master_Source_Library(1).xlsx),
rename it to exactly: master_source_library.xlsx

3) Execute the dork runner
----------------------
Run this command:
  uv run python execute_dork.py

Optional flags:
  --verbose     Prints debug logs to the console.
  --chrome PATH Use a specific Chrome executable (advanced; most users should skip).

Example:
  uv run python execute_dork.py --verbose

Logs
----
Each run writes a detailed log file to:
  ./logs/dork_runner_local_<timestamp>.log
