merklemap-cli 0.5.0

A CLI client for the merklemap.com API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# MerkleMap CLI

A command-line interface (CLI) client for the [merklemap](https://www.merklemap.com/) API. This tool allows you to
search / enumerate subdomains
matching a given query and tail live subdomain discoveries from the Merklemap ingestion pipeline.

<a href="https://asciinema.org/a/dr4PwFmf9t1anDV3vWwFXFZJ5" target="_blank"><img src="https://asciinema.org/a/dr4PwFmf9t1anDV3vWwFXFZJ5.svg" /></a>

## Features

- Search for subdomains matching a specific query
- Tail live subdomain discoveries in real-time

## Installation

To install the MerkleMap CLI, you need to have Rust and Cargo installed on your system. If you don't have them
installed, you can get them from [rustup.rs](https://rustup.rs/).

Once you have Rust and Cargo installed, you can build and install the CLI by running:

```
cargo install merklemap-cli
```

This will compile the project and install the binary in your Cargo bin directory.

## Usage

The MerkleMap CLI provides two main commands:

### Search

To search for subdomains matching a query:

```
merklemap-cli search <QUERY>
```

Replace `<QUERY>` with your search term.

### Tail

To tail live subdomain discoveries:

```
merklemap-cli tail
```

## Output Format

### Search Output

The search command outputs results in the following format:

```
domain=<domain> subject_common_name=<common_name> not_before=<timestamp> human_readable_not_before=<formatted_date>
```

### Tail Output

The tail command outputs results in the following format:

```
hostname=<hostname> timestamp=<ISO8601_timestamp> human_readable_not_before=<formatted_date>
```

## Development

To build the project:

```
cargo build
```

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.