# osintverse-community/findomain

Finds a domain's subdomains passively from certificate logs and public APIs

## Install and run

```sh
ot install osintverse-community/findomain
ot run osintverse-community/findomain d:example.com
```

The first `ot run` installs the tool after asking once. New to `ot`? See https://otinstaller.com/docs/getting-started.

From an AI agent, through ot's MCP server (`ot mcp`):

```
run_tool {"tool":"osintverse-community/findomain","inputs":{"domain":"example.com"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `domain` | domain | yes |  |  |

## Outputs

Finds: subdomain.

## What a run does

- Does not contact the target.
- Does not collect personal data.
- Does not need an account.
- Does not notify the target.
- Usually takes about 30 seconds.
- Connects to the internet.

An agent needs the person's consent before running this tool, because it goes online. See https://otinstaller.com/docs/agents#consent.

## API keys

- `FINDOMAIN_VIRUSTOTAL_TOKEN` (optional, free tier): VirusTotal API key; adds VirusTotal as a source Get one at https://www.virustotal.com/gui/my-apikey
- `FINDOMAIN_SECURITYTRAILS_TOKEN` (optional, free tier): SecurityTrails API key; adds SecurityTrails as a source Get one at https://securitytrails.com/app/account/credentials

Store a key with `ot keys set NAME`; it stays in the OS keychain.

## Trust

- Latest version: 10.0.1
- Signed: yes
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: GPL-3.0
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/findomain
- Packaged by the community from a third-party tool

## Links

- Web page: https://otinstaller.com/osintverse-community/findomain
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/findomain
- README: https://github.com/osintverse-community/findomain#readme
- Homepage: https://github.com/Findomain/Findomain
- Security details: https://otinstaller.com/osintverse-community/findomain/security
