Skip to main content

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.

Project description

Python Contributors Lint Issues


Logo

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

Report Bug · Request Feature

Logo

Features

  • Parses a file filled with targets
  • Does IP networks math
  • Captures RDAP data
  • Pings IPs and FQDNs
  • Displays DNS chains
  • Bash friendly output
  • Multiple input support - STDIN/FILE/CIDR/IP/FQDN
  • Multiple output support - TABLE/JSON/TXT/STDOUT

(back to top)

TODOs

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

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

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

(back to top)

Inspirations

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

scopez-0.0.2.tar.gz (13.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scopez-0.0.2-py3-none-any.whl (14.4 kB view details)

Uploaded Python 3

File details

Details for the file scopez-0.0.2.tar.gz.

File metadata

  • Download URL: scopez-0.0.2.tar.gz
  • Upload date:
  • Size: 13.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for scopez-0.0.2.tar.gz
Algorithm Hash digest
SHA256 0f8c316eeda41b1e8438cc396c394735b04787b3326fb397b98fdc4a5cea365f
MD5 4ccc7977430d19d66d14d97e35c4555e
BLAKE2b-256 f5daf8b0e1211796a069dd06d1f45cc28874a9bba7d9d6f089b824e7ee0a1a56

See more details on using hashes here.

File details

Details for the file scopez-0.0.2-py3-none-any.whl.

File metadata

  • Download URL: scopez-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 14.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for scopez-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3b88c8a2583c1e5889a497c64603dbb86a4ad17ace3808b79e52b961d4f5bda3
MD5 061928846217b5ef27431f32ec6cdf6b
BLAKE2b-256 4dd96d6e0431dcda2df715f65eacf6aab66f444259c617384555a6de8cbccddc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page