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>
24 lines
722 B
Markdown
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.
|