{"id":21388674,"url":"https://github.com/cybersecsi/topmostp","last_synced_at":"2025-07-13T15:32:38.038Z","repository":{"id":62096608,"uuid":"557249576","full_name":"cybersecsi/topmostp","owner":"cybersecsi","description":"A simple CLI tool to retrieve the N top most used ports","archived":false,"fork":false,"pushed_at":"2024-01-15T09:45:15.000Z","size":111,"stargazers_count":9,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-03-15T11:04:52.908Z","etag":null,"topics":["frequency","hacking","nmap","ports","python","tcp","udp"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cybersecsi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-10-25T10:52:30.000Z","updated_at":"2024-01-15T09:35:27.000Z","dependencies_parsed_at":"2023-01-22T16:15:10.646Z","dependency_job_id":null,"html_url":"https://github.com/cybersecsi/topmostp","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybersecsi%2Ftopmostp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybersecsi%2Ftopmostp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybersecsi%2Ftopmostp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybersecsi%2Ftopmostp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cybersecsi","download_url":"https://codeload.github.com/cybersecsi/topmostp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225894265,"owners_count":17541028,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["frequency","hacking","nmap","ports","python","tcp","udp"],"created_at":"2024-11-22T12:19:05.680Z","updated_at":"2024-11-22T12:19:06.847Z","avatar_url":"https://github.com/cybersecsi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cbr\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/cybersecsi/topmostp/main/logo.png\" alt= \"topmostp\" width=\"300px\"\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n    \u003cb\u003etopmostp\u003c/b\u003e\n\u003cp\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/cybersecsi/topmostp/blob/main/README.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/Documentation-complete-green.svg?style=flat\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/cybersecsi/topmostp/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-blue.svg\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n## Table of Contents\n- [Overview](#overview)\n- [Install](#install)\n- [Usage](#usage)\n- [Demo](#demo)\n- [Credits](#credits)\n- [License](#license)\n\n## Overview\n``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).\n\nAt [SecSI](https://secsi.io) we found it useful to get this information to use it in a **pipeline of scripts**.\n\n## Install\nYou can easily install it by running:\n```\npip install topmostp\n```\n\n## Usage\n```\ntopmostp --help\n```\n\nThis will display help for the tool. Here are all the commands it supports.\n\n```\n Usage: topmostp [OPTIONS] COMMAND [ARGS]...                                                         \n                                                                                                     \n╭─ Options ─────────────────────────────────────────────────────────────────────────────────────────╮\n│ --help  -h        Show this message and exit.                                                     │\n╰───────────────────────────────────────────────────────────────────────────────────────────────────╯\n╭─ Commands ────────────────────────────────────────────────────────────────────────────────────────╮\n│ find     Find info about about a specific service                                                 │\n│ stats    Retrieve stats about a port                                                              │\n│ top      Retrieve list of ports by frequency (TCP, UDP, SCTP or all of them. Defaults to 'all')   │\n│ update   Update ports list                                                                        │\n╰───────────────────────────────────────────────────────────────────────────────────────────────────╯\n```\n\nThis is the help for the ``topmostp top`` command:\n```\n Usage: topmostp top [OPTIONS] N                                              \n                                                                              \n Retrieve list of ports by frequency (TCP, UDP, SCTP or all of them. Defaults \n to 'all')                                                                    \n                                                                              \n╭─ Arguments ────────────────────────────────────────────────────────────────╮\n│ *    n      INTEGER  [default: None] [required]                            │\n╰────────────────────────────────────────────────────────────────────────────╯\n╭─ Options ──────────────────────────────────────────────────────────────────╮\n│ --type    -t      [tcp|udp|sctp|all]  [default: all]                       │\n│ --silent  -s                          Display only results in output       │\n│ --help    -h                          Show this message and exit.          │\n╰────────────────────────────────────────────────────────────────────────────╯\n```\n\nThis is the help for the ``topmostp find`` command:\n```\n Usage: topmostp find [OPTIONS] SERVICE                                       \n                                                                              \n Find info about about a specific service                                     \n                                                                              \n╭─ Arguments ────────────────────────────────────────────────────────────────╮\n│ *    service      TEXT  [default: None] [required]                         │\n╰────────────────────────────────────────────────────────────────────────────╯\n╭─ Options ──────────────────────────────────────────────────────────────────╮\n│ --help  -h        Show this message and exit.                              │\n╰────────────────────────────────────────────────────────────────────────────╯\n```\n\nThis is the help for the ``topmostp stats`` command:\n```\n Usage: topmostp stats [OPTIONS] PORT PORT_TYPE:{tcp|udp|sctp}                \n                                                                              \n Retrieve stats about a port                                                  \n                                                                              \n╭─ Arguments ────────────────────────────────────────────────────────────────╮\n│ *    port           INTEGER                   [default: None] [required]   │\n│ *    port_type      PORT_TYPE:{tcp|udp|sctp}  [default: None] [required]   │\n╰────────────────────────────────────────────────────────────────────────────╯\n╭─ Options ──────────────────────────────────────────────────────────────────╮\n│ --help  -h        Show this message and exit.                              │\n╰────────────────────────────────────────────────────────────────────────────╯\n```\n\nA pratical example is the following:\n```\nnaabu -p $(topmostp top 15 -s) -host secsi.io\n```\n\nIn 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.\n\n\n## Demo\n[![demo](https://asciinema.org/a/532210.svg)](https://asciinema.org/a/532210?autoplay=1)\n\n## Credits\nDeveloped by Angelo Delicato [@SecSI](https://secsi.io)\n\n## License\n*topmostp* is released under the [MIT LICENSE](https://github.com/cybersecsi/topmostp/blob/main/LICENSE.md)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybersecsi%2Ftopmostp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybersecsi%2Ftopmostp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybersecsi%2Ftopmostp/lists"}