https://github.com/cybersecsi/topmostp
A simple CLI tool to retrieve the N top most used ports
https://github.com/cybersecsi/topmostp
frequency hacking nmap ports python tcp udp
Last synced: 3 months ago
JSON representation
A simple CLI tool to retrieve the N top most used ports
- Host: GitHub
- URL: https://github.com/cybersecsi/topmostp
- Owner: cybersecsi
- License: mit
- Created: 2022-10-25T10:52:30.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-01-15T09:45:15.000Z (over 1 year ago)
- Last Synced: 2024-03-15T11:04:52.908Z (over 1 year ago)
- Topics: frequency, hacking, nmap, ports, python, tcp, udp
- Language: Python
- Homepage:
- Size: 108 KB
- Stars: 9
- Watchers: 4
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
topmostp
## Table of Contents
- [Overview](#overview)
- [Install](#install)
- [Usage](#usage)
- [Demo](#demo)
- [Credits](#credits)
- [License](#license)
## Overview
``topmostp`` (**Topmost P**orts) is a tool that allows you to quickly retrieve the **most used ports**. The source of the ranking is the ``nmap-services`` in the [nmap repo](https://raw.githubusercontent.com/nmap/nmap/master/nmap-services).
At [SecSI](https://secsi.io) we found it useful to get this information to use it in a **pipeline of scripts**.
## Install
You can easily install it by running:
```
pip install topmostp
```
## Usage
```
topmostp --help
```
This will display help for the tool. Here are all the commands it supports.
```
Usage: topmostp [OPTIONS] COMMAND [ARGS]...
╭─ Options ─────────────────────────────────────────────────────────────────────────────────────────╮
│ --help -h Show this message and exit. │
╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ────────────────────────────────────────────────────────────────────────────────────────╮
│ find Find info about about a specific service │
│ stats Retrieve stats about a port │
│ top Retrieve list of ports by frequency (TCP, UDP, SCTP or all of them. Defaults to 'all') │
│ update Update ports list │
╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
```
This is the help for the ``topmostp top`` command:
```
Usage: topmostp top [OPTIONS] N
Retrieve list of ports by frequency (TCP, UDP, SCTP or all of them. Defaults
to 'all')
╭─ Arguments ────────────────────────────────────────────────────────────────╮
│ * n INTEGER [default: None] [required] │
╰────────────────────────────────────────────────────────────────────────────╯
╭─ Options ──────────────────────────────────────────────────────────────────╮
│ --type -t [tcp|udp|sctp|all] [default: all] │
│ --silent -s Display only results in output │
│ --help -h Show this message and exit. │
╰────────────────────────────────────────────────────────────────────────────╯
```
This is the help for the ``topmostp find`` command:
```
Usage: topmostp find [OPTIONS] SERVICE
Find info about about a specific service
╭─ Arguments ────────────────────────────────────────────────────────────────╮
│ * service TEXT [default: None] [required] │
╰────────────────────────────────────────────────────────────────────────────╯
╭─ Options ──────────────────────────────────────────────────────────────────╮
│ --help -h Show this message and exit. │
╰────────────────────────────────────────────────────────────────────────────╯
```
This is the help for the ``topmostp stats`` command:
```
Usage: topmostp stats [OPTIONS] PORT PORT_TYPE:{tcp|udp|sctp}
Retrieve stats about a port
╭─ Arguments ────────────────────────────────────────────────────────────────╮
│ * port INTEGER [default: None] [required] │
│ * port_type PORT_TYPE:{tcp|udp|sctp} [default: None] [required] │
╰────────────────────────────────────────────────────────────────────────────╯
╭─ Options ──────────────────────────────────────────────────────────────────╮
│ --help -h Show this message and exit. │
╰────────────────────────────────────────────────────────────────────────────╯
```
A pratical example is the following:
```
naabu -p $(topmostp top 15 -s) -host secsi.io
```
In this snippet the output of ``topmostp`` is used to retrieve the list of the top 15 ports and it is chained with the ``naabu`` port scanning tool.
## Demo
[](https://asciinema.org/a/532210?autoplay=1)
## Credits
Developed by Angelo Delicato [@SecSI](https://secsi.io)
## License
*topmostp* is released under the [MIT LICENSE](https://github.com/cybersecsi/topmostp/blob/main/LICENSE.md)