MCPcopy Index your code
hub / github.com/DEMON1A/zzl

github.com/DEMON1A/zzl @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
11 symbols 26 edges 5 files 8 documented · 73%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

zzl

Zzl is a reconnaissance tool that collects subdomains from SSL certificates in IP ranges

Install zzl

Using go

go install github.com/DEMON1A/zzl/cmd/zzl@latest

Build from source

Windows
git clone https://github.com/DEMON1A/zzl
cd zzl\
go build cmd\zzl\main.go
main.exe -h
Linux
git clone https://github.com/DEMON1A/zzl
cd zzl/
go build cmd/zzl/main.go
./main -h

Usage

IP ranges

zzl automatically generates IP addresses between ranges, you just need to specify the start and the end point for the IP generation function

go run cmd\zzl\main.go -start-ip 141.95.90.0 -end-ip 141.95.90.255

You can only use -start-ip too, zzl is made to generate the end up dynamiclly if it isn't provided, for example if the start ip is 192.168.1.0 zzl would set the end ip dynamically to 192.168.1.255

go run cmd\zzl\main.go -start-ip 141.95.90.0

Domain

You can still use zzl to grab SANs from a single domain

go run cmd\zzl\main.go -domain x.com

Here is a one liner for bash to automate this process with many domains

for i in `cat domains.txt`; do zzl -domain $i; done

Validation

zzl do validate every single IP address found inside the IP range for both protocols HTTP and HTTPs so it never misses a result, you can set zzl to use a single protocol for validation

go run cmd\zzl\main.go -domain x.com -only-https
go run cmd\zzl\main.go -domain x.com -only-http

Timeout

You can choose the timeout in seconds, By default it's set to 1

go run cmd\zzl\main.go -domain x.com -timeout 3

Credits

This tool is inspired by Zwink's University "Python and Bug bounty" episode, zzl is an enchanced version of his script sslDomain_v3.py

Core symbols most depended-on inside this repo

IsAlive
called by 4
pkg/utils/validate.go
RemoveWildcardAndDuplicates
called by 2
pkg/utils/validate.go
SANs
called by 2
pkg/ssl/ssl.go
IsAliveNormal
called by 1
pkg/utils/validate.go
RemoveWildcard
called by 1
pkg/utils/validate.go
GenerateIPs
called by 1
pkg/ip/ip.go
GenerateEndIP
called by 1
pkg/ip/ip.go
incrementIP
called by 1
pkg/ip/ip.go

Shape

Function 10
Struct 1

Languages

Go100%

Modules by API surface

pkg/utils/validate.go4 symbols
pkg/ip/ip.go3 symbols
pkg/args/args.go2 symbols
pkg/ssl/ssl.go1 symbols
cmd/zzl/main.go1 symbols

For agents

$ claude mcp add zzl \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact