https://github.com/xcalts/scopez
Scopez verifies connectivity to target servers, reveals CDN presence, and provides detailed target insights like reachability and RDAP.
https://github.com/xcalts/scopez
bugbounty cdn curl penetration-testing ping rdap reconnaissance scope
Last synced: 7 months ago
JSON representation
Scopez verifies connectivity to target servers, reveals CDN presence, and provides detailed target insights like reachability and RDAP.
- Host: GitHub
- URL: https://github.com/xcalts/scopez
- Owner: xcalts
- License: mit
- Created: 2025-05-16T15:27:17.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-05-30T14:34:11.000Z (7 months ago)
- Last Synced: 2025-05-30T17:26:10.423Z (7 months ago)
- Topics: bugbounty, cdn, curl, penetration-testing, ping, rdap, reconnaissance, scope
- Language: Python
- Homepage:
- Size: 1.32 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
[![Python][python-shield]][python-url]
[![Linux][linux-shield]][linux-url]
[![MacOS][macos-shield]][macos-url]
[![Stars][stars-shield]][stars-url]
[![Contributors][contributors-shield]][contributors-url]
[![Lint][lint-shield]][lint-url]
[![Issues][issues-shield]][issues-url]
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**
## TODO
- Input support - **IP with port, FQDN with port**
- **Proxies** support for URL probing
- **Markdown** output
- **Configuration** YAML file
## Installation
You can install `scopez` using `pip`.
```
pip install scopez
```
## 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.
```
## Developing
In order to start developing you will need to to follow the instructions below.
```txt
> 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
```
## Dependencies
- [click](https://github.com/pallets/click)
- [requests](https://github.com/psf/requests)
- [rich](https://github.com/Textualize/rich)
- [pydantic](https://github.com/pydantic/pydantic)
- [ipwhois](https://github.com/secynic/ipwhois)
- [fqdn](https://github.com/ypcrts/fqdn)
- [geoip2-ipv4](https://github.com/datasets/geoip2-ipv4)
- [nuitka](https://github.com/Nuitka/Nuitka)
## Inspirations
- [naabu](https://github.com/projectdiscovery/naabu)
## 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.
[contributors-shield]: https://img.shields.io/github/contributors/xcalts/scopez.svg?style=flat
[contributors-url]: https://github.com/xcalts/scopez/graphs/contributors
[lint-shield]: https://img.shields.io/github/actions/workflow/status/xcalts/scopez/ruff.yml?style=flat&label=ruff-lint
[lint-url]: https://github.com/xcalts/scopez/actions/workflows/ruff.yml
[stars-shield]: https://img.shields.io/github/stars/xcalts/scopez.svg?style=flat
[stars-url]: https://github.com/xcalts/scopez/stargazers
[issues-shield]: https://img.shields.io/github/issues/xcalts/scopez.svg?style=flat
[issues-url]: https://github.com/xcalts/scopez/issues
[license-shield]: https://img.shields.io/github/license/xcalts/scopez.svg?style=flat
[license-url]: https://github.com/xcalts/scopez/blob/master/LICENSE
[python-shield]: https://img.shields.io/badge/Python-black?logo=python
[python-url]: https://www.python.org/
[linux-shield]: https://img.shields.io/badge/Linux-black?logo=linux
[linux-url]: https://www.linux.org/
[macos-shield]: https://img.shields.io/badge/Darwin-black?logo=macos
[macos-url]: https://www.apple.com/