scopez 0.1.0

Scopez verifies connectivity to target servers, reveals CDN presence, and provides detailed target insights like reachability and RDAP.

Scopez verifies connectivity to target servers, reveals CDN presence, and provides detailed target insights like reachability and RDAP.

Report Bug · Request Feature · PyPI

Features

• Parses a file filled with targets
• Does IP networks math
• Captures RDAP data
• Pings IPs and FQDNs
• Displays DNS chains
• Unix friendly input/output
• Threads support
• Multiple input support - STDIN/FILE/CIDR/IP/FQDN/URL
• Multiple output support - TABLE/JSON/TXT/STDOUT
• Single executable file using nuitka - easy installation

(back to top)

TODO

• Input support - IP with port, FQDN with port
• Proxies support for URL probing
• Markdown output
• Configuration YAML file

(back to top)

Installation

You can install scopez using uv.

uv tool install scopez

(back to top)

Usage

Usage: scopez [OPTIONS]

DEBUG:
  -version   Show the version and exit.
  -no-color  Disable colors in CLI output.
  -silent    Display only results in output.
  -simulate  Display the parsed targets.

INPUT:
  -target           Targets to analyze (comma-separated).
  -list             List of targets to analyze (file).
  -exclude-targets  Targets to exclude from analysis (comma-separated).
  -exclude-file     List of targets to exclude from analysis (file).

OUTPUT:
  -json   Write output in JSON lines format.
  -table  Write output in Table format.

TWEAK:
  -threads  The max number of worker threads.

OTHER:
  -help  Show this message and exit.

(back to top)

Developing

In order to start developing you will need to to follow the instructions below.

> pyenv install 3.12.6
> pyenv global 3.12.6
> python3 -m venv .venv
> source .venv/bin/activate
> (.venv) pip install ruff pre-commit
> (.venv) pip install -e .
> (.venv) scopez --version
> (.venv) ruff check --fix

(back to top)

Dependencies

• click
• requests
• rich
• pydantic
• ipwhois
• fqdn
• geoip2-ipv4
• nuitka

(back to top)

Contributing

Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project.
2. Create your Feature Branch (git checkout -b feature/AmazingFeature).
3. Commit your Changes (git commit -m 'Add some AmazingFeature').
4. Push to the Branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

(back to top)