+2
日增长
18,326
stars
2,738
forks
347
watchers
2,129
prs
498
issues
38
releases
README
theHarvester !theHarvester logo theHarvester gathers open-source intelligence about a domain or organization from search engines, certificate transparency logs, DNS datasets, code repositories, threat-intelligence platforms, and other public sources. It normalizes hostnames, email addresses, IP addresses, URLs, ASNs, people, breach names, and structured evidence from optional actions. Use theHarvester during the early reconnaissance stage of an authorized security assessment. Run it only against targets you own or have explicit permission to test. Quick start theHarvester requires Python 3.14 and uv. The repository's .python-version lets uv select the required Python version automatically: bash git clone https://github.com/laramies/theHarvester.git cd theHarvester uv sync uv run theHarvester -d example.com -b crtsh,certspotter This first run uses two P0 passive sources that need no API key. Passive means the target is not contacted directly, but the selected providers still receive the target string. The terminal reports each source outcome and any retained findings. A source can complete with zero findings, stop early with partial evidence, or fail without erasing evidence retained by other sources. See the installation guide for packaged distributions and platform-specific setup. Choose how to work | Interface | Best for | Start with | | --- | --- | --- | | CLI | One-off reconnaissance and shell workflows | uv run theHarvester -h | | HarvestView | Local run history, evidence review, hostname changes, and schedules | uv run harvestview | | REST API | Authenticated local automation and integrations | http://127.0.0.1:5000/docs | The CLI, REST API, and HarvestView share one finite-run engine and normalized evidence model. HarvestView provides the local browser interface. Common workflows Query several P0 passive sources: bash uv run theHarvester -d example.com -b crtsh,certspotter,commoncrawl Three discovery sources run at once by default. Use -j or --source-workers to change the worker count. Every selected source still runs. Run every source that can contribute subdomains: bash uv run theHarvester -d example.com -b subdomains Combine capability selectors, or mix them with explicit source names: bash uv run theHarvester -d example.com -b emails,urls,certspotter Capability selectors form a union and choose which sources run. They do not discard other result types returned by those sources. Available selectors are subdomains, emails, ips, asns, urls, people, and breaches. -b all runs every cataloged P0 passive source. P1 DNS and P2 direct sources require explicit selection. Pass --limit 0 to remove the shared per-source result cap and local page ceilings. Provider quotas and runtime safeguards still apply. If a provider or safety limit stops a source after retaining results, the run keeps them and records a partial outcome with the stop reason. Exclude hostname results while retaining other result types: bash uv run
Top issues
#1501PyPI package4 comments · 2023-07-31#2413Add Lunar Domain Exposure API as an optional enrichment source1 comments · 2026-07-24#2666[Bug]: Uncaught ssl.SSLError and socket OSErrors escape _probe() in VirtualHost discovery1 comments · 2026-11-13#2664[Bug]: Unhandled ValidationError in ScheduleDispatcher._enqueue_targets() aborts batch dispatch1 comments · 2026-11-13#2665[Bug]: State transition race condition and un-gated status overwrite in RunLifecycleStore.fail()0 comments · 2026-11-13
Latest release
4.11.1 4.11.1 2026-06-03[4.11.1] - 2026-06-03 Added - Add Sherlockeye as an API-key source module by @A1S0N in https://github.com/laramies/theHarvester/pull/2347 Changed - Updated runtime dependencies: aiohttp to 3.14.0, fastapi to 0.136.3, and uvicorn to 0.48.0. - Updated development dependencies: pytest-asyncio to 1.4.0, ruff to 0.15.15, and ty to 0.0.42. - Updated CI and container maintenance pins, including actions/checkout, github/codeql-action, Docker build/login/metadata actions, and the Python Docker base image digest. - Updated the package version to 4.11.1. New Contributors @A1S0N made th