# osintverse-community/urlscan-search

Searches urlscan.io's existing scans of a domain, IP or URL: each page's title, server, IP, network and country

## Install and run

```sh
ot install osintverse-community/urlscan-search
ot run osintverse-community/urlscan-search d:example.com
ot run osintverse-community/urlscan-search ip:8.8.8.8
ot run osintverse-community/urlscan-search url:https://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/urlscan-search","inputs":{"domain":"example.com"}}
```

## Inputs

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `domain` | domain | no |  | Scans of pages on this host name (give exactly one of domain, ip, url or query) |
| `ip` | ip | no |  | Scans of pages served from this IP address (give exactly one of domain, ip, url or query) |
| `url` | url | no |  | Scans of this exact page (give exactly one of domain, ip, url or query) |
| `query` | string | no |  | Any urlscan.io search query, such as page.asn:AS15169 (give exactly one of domain, ip, url or query) |
| `limit` | integer | no | `50` | Most scans to return (up to 1000) |

## Outputs

Finds: url, ip, domain, subdomain.

- `url`: Scanned pages, with title, server, IP, network, country and links to the scan and screenshot

## 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 5 seconds.
- Connects to urlscan.io.

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

## API keys

- `URLSCAN_API_KEY` (optional, free): Your urlscan.io API key; optional, it raises the search rate limits Get one at https://urlscan.io/user/profile/

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

## Trust

- Latest version: 0.1.0
- Signed: yes
- Verified publisher: yes
- Health: unknown
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/urlscan-search

## Links

- Web page: https://otinstaller.com/osintverse-community/urlscan-search
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/urlscan-search
- README: https://github.com/osintverse-community/urlscan-search#readme
- Security details: https://otinstaller.com/osintverse-community/urlscan-search/security
- Report a problem: https://otinstaller.com/osintverse-community/urlscan-search/report