Files
osint/scripts/python/README.md
T
cedry2k1992andClaude Sonnet 5 bb15f13bac Add Holehe collector for email targets
Closes the email target-type gap (previously had zero collectors).
Checks whether an email is registered on 120+ sites via the
password-reset-oracle technique. Shares the Sherlock/whois venv.

HoleheRunner gates success on the CSV file existing rather than the
process exit code: holehe's CLI calls Python's exit("message") right
after writing results on its normal success path, which always yields
exit code 1 regardless of outcome — discovered while verifying this
end-to-end against the real dev server and queue worker.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-20 11:49:09 +03:00

24 lines
722 B
Markdown

# Python OSINT scripts
## Setup
```
scripts/python/setup.sh
```
Sets up:
- `scripts/python/.venv` — Sherlock (`sherlock-project`), `python-whois`,
and Holehe, all lightweight and dependency-compatible.
- `scripts/python/.venv-theharvester` — theHarvester, isolated because it
pulls in a much heavier dependency set (playwright, censys, shodan,
fastapi). Vendored from `theharvester-src/` at tag `4.6.0` (the last
release compatible with Python 3.9+; 4.7+ requires 3.12).
Neither venv nor `theharvester-src/` is committed — re-run `setup.sh` on
any new machine.
## How runners find these
`config/osint.php` has the paths; each `App\Osint\Runners\*` class reads
from there rather than hardcoding a path.