# theHarvester OSINT Email and Subdomain Intelligence Gatherer

> theHarvester is an open-source OSINT tool for gathering emails, subdomains, hosts, employee names, open ports, and banners from public sources. Used during reconnaissance in penetration testing and red team assessments, it queries search engines, PGP key servers, the Shodan API, and other data sources to map an organization's external threat surface.

- Skill: `agentskillexchange/theharvester-osint-email-and-subdomain-intelligence-gatherer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/theharvester-osint-email-and-subdomain-intelligence-gatherer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/theharvester-osint-email-and-subdomain-intelligence-gatherer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Security
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/theharvester-osint-email-and-subdomain-intelligence-gatherer

---


# theHarvester OSINT Email and Subdomain Intelligence Gatherer

theHarvester is an open-source OSINT tool for gathering emails, subdomains, hosts, employee names, open ports, and banners from public sources. Used during reconnaissance in penetration testing and red team assessments, it queries search engines, PGP key servers, the Shodan API, and other data sources to map an organization's external threat surface.

## Installation

Use the upstream install or setup path that matches your environment:
- git clone https://github.com/laramies/theHarvester
- uv sync
- uv run theHarvester
- uv sync --all-groups

Requirements and caveats from upstream:
- ![TheHarvester CI](https://github.com/laramies/theHarvester/workflows/TheHarvester%20Python%20CI/badge.svg) ![TheHarvester Docker Image CI](https://github.com/laramies/theHarvester/workflows/TheHarvester%20Docker%20Im...
- Python 3.12 or higher.

Basic usage or getting-started notes:
- ------------------------
- https://github.com/laramies/theHarvester/wiki/Installation
- bash

- Source: https://github.com/laramies/theHarvester
- Extracted from upstream docs: https://raw.githubusercontent.com/laramies/theHarvester/HEAD/README.md

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/theharvester-osint-email-subdomain-intelligence/)