### Install uv

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Installs the uv package manager. This is a prerequisite for using the recommended installation method.

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

--------------------------------

### Install Dependencies with uv

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Installs project dependencies and creates a virtual environment using uv.

```bash
uv sync
```

--------------------------------

### Install Development Dependencies

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Installs development-specific dependencies using uv sync with the 'dev' extra.

```bash
uv sync --extra dev
```

--------------------------------

### Start DNSRecon REST API

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Starts the DNSRecon REST API service.

```bash
uv run restdnsrecon
```

--------------------------------

### Run Linting and Formatting with uv

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Runs linting and formatting checks using uv run with ruff.

```bash
uv run ruff check
```

```bash
uv run ruff format
```

--------------------------------

### Run DNSRecon with uv

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Executes the DNSRecon tool using the uv run command.

```bash
uv run dnsrecon
```

--------------------------------

### Set DNSRECON_WORDLIST_DIRS Environment Variable

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Configures custom directories for DNSRecon to search for wordlist files.

```bash
export DNSRECON_WORDLIST_DIRS="/opt/dnsrecon-wordlists:/srv/shared-wordlists"
```

--------------------------------

### Run Tests with uv

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Executes the test suite using uv run and pytest.

```bash
uv run pytest
```

--------------------------------

### REST API: General Enum with Shodan Expansion

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Calls the /general_enum endpoint with Shodan expansion enabled. Requires Shodan API key.

```bash
curl -s \
  -H "X-Shodan-Api-Key: $SHODAN_API_KEY" \
  "http://127.0.0.1:5000/general_enum?domain=example.com&do_spf=true&do_whois=true&do_shodan=true"
```

--------------------------------

### Clone DNSRecon Repository

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Clones the DNSRecon repository from GitHub and navigates into the project directory.

```bash
git clone https://github.com/darkoperator/dnsrecon.git
cd dnsrecon
```

--------------------------------

### DNSRecon CLI: Shodan with Environment Variable

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Performs DNS enumeration with Shodan enrichment, using the Shodan API key set as an environment variable.

```bash
export SHODAN_API_KEY="your-shodan-api-key"
uv run dnsrecon -d example.com -t std -s -w --shodan
```

--------------------------------

### DNSRecon CLI: Passive Shodan Enrichment

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Performs standard DNS enumeration with Shodan enrichment using SPF and WHOIS data. Requires Shodan API key.

```bash
uv run dnsrecon -d example.com -t std -s -w --shodan --shodan-key "$SHODAN_API_KEY"
```

--------------------------------

### DNSRecon CLI: Active Shodan Validation

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Performs standard DNS enumeration with Shodan enrichment and active validation of results. Requires Shodan API key.

```bash
uv run dnsrecon -d example.com -t std -s -w --shodan --shodan-active --shodan-key "$SHODAN_API_KEY"
```

--------------------------------

### General DNS Enumeration with Shodan Enrichment

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Performs general DNS record enumeration for a given domain and can optionally enrich results using Shodan data. Supports both passive (SPF/WHOIS) and active validation of Shodan results.

```APIDOC
## GET /general_enum

### Description
Performs general DNS record enumeration (MX, SOA, NS, A, AAAA, SPF, TXT) for a specified domain. It can optionally integrate with Shodan to expand netblocks found in SPF and WHOIS data, and can perform active validation of Shodan results.

### Method
GET

### Endpoint
`/general_enum`

### Parameters
#### Query Parameters
- **domain** (string) - Required - The domain to perform enumeration on.
- **do_spf** (boolean) - Optional - If true, checks for SPF records.
- **do_whois** (boolean) - Optional - If true, checks WHOIS data.
- **do_shodan** (boolean) - Optional - If true, enables Shodan enrichment.
- **shodan_active** (boolean) - Optional - If true and `do_shodan` is true, performs active validation of Shodan results.

### Request Example
```json
{
  "example": "curl -s -H \"X-Shodan-Api-Key: $SHODAN_API_KEY\" \"http://127.0.0.1:5000/general_enum?domain=example.com&do_spf=true&do_whois=true&do_shodan=true\""
}
```

### Response
#### Success Response (200)
- **(Structure not explicitly defined in source, but implies DNS records and potentially Shodan data)**

#### Response Example
```json
{
  "example": "(Response body structure not explicitly defined in source)"
}
```

### Headers
- **X-Shodan-Api-Key** (string) - Required if `do_shodan` is true - Your Shodan API key.
```

--------------------------------

### REST API: General Enum with Active Shodan Validation

Source: https://github.com/darkoperator/dnsrecon/blob/master/README.md

Calls the /general_enum endpoint with Shodan expansion and active validation enabled. Requires Shodan API key.

```bash
curl -s \
  -H "X-Shodan-Api-Key: $SHODAN_API_KEY" \
  "http://127.0.0.1:5000/general_enum?domain=example.com&do_spf=true&do_whois=true&do_shodan=true&shodan_active=true"
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.