scopez 0.0.4

Scopez is a Python scope analysis tool built with simplicity in mind. It is intended to help verify the scope during bug bounty programs and penetration testing.

Scopez is a Python-based target analysis tool built with simplicity in mind.

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
• Multiple input support - STDIN/FILE/CIDR/IP/FQDN/URL
• Multiple output support - TABLE/JSON/TXT/STDOUT

(back to top)

TODOs

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

(back to top)

Installation

You can install scopez using pip.

pip 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:
  -output  File to write output to (optional).
  -json    Write output in JSON lines format.
  -table   Write output in Table format.

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

(back to top)

Building Standalones

Follow the instructions below to build a standalone scopez executable.

Note: currently only elf standalone executables are supported.

Linux

> python3 -m venv .venv
> source .venv/bin/activate
> (.venv) pip install -e .
> (.venv) pip install --upgrade cx_Freeze
> (.venv) python3 setup_cx.py build

(back to top)

Dependencies

• click
• requests
• rich
• pydantic
• ipwhois
• fqdn
• cx_Freeze

(back to top)

Inspirations

• naabu

(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)