{
  "id": "naabu",
  "name": "Naabu",
  "homepage": "https://github.com/projectdiscovery/naabu",
  "description": "Naabu is a port scanning tool written in Go that allows you to enumerate valid ports for hosts in a fast and reliable manner.",
  "executables": [
    "naabu"
  ],
  "dotfiles": {
    "paths": [
      "~/.config/naabu/config.yaml"
    ],
    "secret": []
  },
  "commands": {
    "format": 1,
    "label": "Scan ports",
    "description": "Fast port scan of one or more hosts. Host discovery, nmap integration, service-version probing and proxy options are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/projectdiscovery/naabu#usage",
        "revision": "README usage (2026-10-27)",
        "evidence": "   -host string[]              hosts to scan ports for (comma-separated)\n   -list, -l string            list of hosts to scan ports (file)\n   -exclude-hosts, -eh string  hosts to exclude from the scan (comma-separated)\n   -port, -p string              ports to scan (80,443, 100-200)\n   -top-ports, -tp string        top ports to scan (default 100) [full,100,1000]\n   -exclude-ports, -ep string[]  ports to exclude from scan (file or comma-separated)\n   -c int                general internal worker threads (default 25)\n   -rate int             packets to send per second (default 1000)\n   -o, -output string                     file to write output to (optional)\n   -j, -json                              write output in JSON lines format\n   -csv                                   write output in csv format\n   -scan-type, -s string            type of port scan (SYN/CONNECT) (default \"c\")\n   -retries int                    number of retries for the port scan (default 3)\n   -timeout value                  time to wait before timing out (e.g. 500ms, 2s; a bare number is milliseconds) (default 1s)\n   -verify                         validate the ports again with TCP verification"
      }
    ],
    "field": [
      {
        "id": "host",
        "label": "Hosts",
        "description": "Comma-separated hosts or IPs.",
        "type": "string",
        "option": [
          "-host"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "list",
        "label": "Hosts file",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "input"
        },
        "option": [
          "-list",
          "-l"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "exclude_hosts",
        "label": "Exclude hosts",
        "type": "string",
        "option": [
          "-exclude-hosts",
          "-eh"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "port",
        "label": "Ports",
        "description": "For example 80,443 or 100-200.",
        "type": "string",
        "option": [
          "-port",
          "-p"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "top_ports",
        "label": "Top ports",
        "type": "string",
        "option": [
          "-top-ports",
          "-tp"
        ],
        "suggestions": [
          {
            "value": "100",
            "label": "100"
          },
          {
            "value": "1000",
            "label": "1000"
          },
          {
            "value": "full",
            "label": "All ports"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "exclude_ports",
        "label": "Exclude ports",
        "type": "string",
        "option": [
          "-exclude-ports",
          "-ep"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "scan_type",
        "label": "Scan type",
        "type": "string",
        "option": [
          "-scan-type",
          "-s"
        ],
        "suggestions": [
          {
            "value": "c",
            "label": "CONNECT"
          },
          {
            "value": "s",
            "label": "SYN"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "rate",
        "label": "Packets per second",
        "type": "integer",
        "option": [
          "-rate"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "threads",
        "label": "Worker threads",
        "type": "integer",
        "option": [
          "-c"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "retries",
        "label": "Retries",
        "type": "integer",
        "option": [
          "-retries"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "timeout",
        "label": "Timeout",
        "description": "For example 500ms or 2s.",
        "type": "string",
        "option": [
          "-timeout"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "verify",
        "label": "Verify ports with TCP",
        "type": "boolean",
        "option": [
          "-verify"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "json",
        "label": "JSON lines output",
        "type": "boolean",
        "option": [
          "-json",
          "-j"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "csv",
        "label": "CSV output",
        "type": "boolean",
        "option": [
          "-csv"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "output",
        "label": "Output file",
        "type": "path",
        "path": {
          "kind": "file",
          "role": "output"
        },
        "option": [
          "-output",
          "-o"
        ],
        "effect": "overwrite",
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "top",
        "label": "Scan top ports",
        "set": {
          "top_ports": [
            "1000"
          ]
        },
        "fields": [
          "host",
          "top_ports",
          "rate",
          "output"
        ],
        "required": [
          "host"
        ]
      },
      {
        "id": "ports",
        "label": "Scan specific ports",
        "fields": [
          "host",
          "port",
          "scan_type",
          "verify",
          "json",
          "output"
        ],
        "required": [
          "host",
          "port"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "host",
          "list",
          "port",
          "top_ports",
          "output",
          "json"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "exclude_hosts",
          "exclude_ports",
          "scan_type",
          "rate",
          "threads",
          "retries",
          "timeout",
          "verify",
          "csv"
        ]
      }
    ]
  }
}