{
  "id": "theharvester",
  "name": "theHarvester",
  "homepage": "https://github.com/laramies/theHarvester",
  "description": "theHarvester gathers open-source intelligence about a domain or organization from public sources.",
  "executables": [
    "theHarvester"
  ],
  "dotfiles": {
    "paths": [
      "~/.theHarvester/proxies.yaml"
    ],
    "secret": [
      "~/.theHarvester/api-keys.yaml"
    ],
    "exclude": [],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Gather OSINT for a domain",
    "description": "Query public sources for hosts, emails and IPs of a domain. Active options (brute force, takeover, screenshots, vhost, API scan) are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "src",
        "kind": "help",
        "url": "https://github.com/laramies/theHarvester/blob/master/theHarvester/__main__.py",
        "revision": "master 2026-10",
        "evidence": "'-d', '--domain', help='Company name or domain to search, or an explicit ASN/IP/CIDR target for --routeviews.',\n'-l', '--limit', help='Maximum results requested from each source that supports result limits\n'-S', '--start', help='Result offset for sources that support pagination (default: 0).',\n'-f', '--filename', help='Write NAME.json, NAME.xml, and NAME.jsonl.',\n'-v', '--verbose', help='Show informational diagnostic messages.'\n'-b', '--source', help='Comma-separated source names or source capabilities. Capabilities: subdomains, emails, ips, asns, urls, people, breaches, all.\n"
      }
    ],
    "field": [
      {
        "id": "domain",
        "label": "Domain or company",
        "type": "string",
        "option": [
          "--domain",
          "-d"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "source",
        "label": "Sources or capabilities",
        "description": "Comma-separated source names or capabilities.",
        "type": "string",
        "option": [
          "--source",
          "-b"
        ],
        "suggestions": [
          {
            "value": "all",
            "label": "All sources"
          },
          {
            "value": "subdomains",
            "label": "Subdomains"
          },
          {
            "value": "emails",
            "label": "Emails"
          },
          {
            "value": "ips",
            "label": "IPs"
          }
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "limit",
        "label": "Result limit per source",
        "type": "integer",
        "option": [
          "--limit",
          "-l"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "start",
        "label": "Result offset",
        "type": "integer",
        "option": [
          "--start",
          "-S"
        ],
        "sources": [
          "src"
        ]
      },
      {
        "id": "filename",
        "label": "Output base name",
        "description": "Writes NAME.json, NAME.xml and NAME.jsonl.",
        "type": "string",
        "option": [
          "--filename",
          "-f"
        ],
        "effect": "overwrite",
        "sources": [
          "src"
        ]
      },
      {
        "id": "verbose",
        "label": "Verbose",
        "type": "boolean",
        "option": [
          "--verbose",
          "-v"
        ],
        "sources": [
          "src"
        ]
      }
    ],
    "task": [
      {
        "id": "search",
        "label": "Search a domain",
        "fields": [
          "domain",
          "source",
          "limit",
          "filename"
        ],
        "required": [
          "domain",
          "source"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "domain",
          "source",
          "limit",
          "filename"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "start",
          "verbose"
        ]
      }
    ]
  }
}