# osintverse-community/shodan-host

Shows what Shodan has seen on an IP: open ports, services, banners, vulnerabilities, location

## Install and run

```sh
ot install osintverse-community/shodan-host
ot run osintverse-community/shodan-host ip:1.1.1.1
```

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/shodan-host","inputs":{"ip":"1.1.1.1"}}
```

## Inputs

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

## Outputs

Finds: other, location, organization.

## What a run does

- Does not contact the target.
- Does not collect personal data.
- Needs an account (it logs in, or uses an account or API key of yours).
- Connects to the internet.

An agent needs the person's consent before running this tool, because it uses the person's own account or API key. See https://otinstaller.com/docs/agents#consent.

## API keys

- `SHODAN_API_KEY` (required): Your Shodan API key Get one at https://account.shodan.io

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

## Trust

- Latest version: 1.31.0
- Signed: yes
- Verified publisher: yes
- Health: healthy
- Installs in the last 30 days: 0
- License: MIT
- Runtime: Docker image, pinned by digest
- Repository: https://github.com/osintverse-community/shodan-host
- Packaged by the community from a third-party tool

## Links

- Web page: https://otinstaller.com/osintverse-community/shodan-host
- JSON: https://api.otinstaller.com/v1/tools/osintverse-community/shodan-host
- README: https://github.com/osintverse-community/shodan-host#readme
- Homepage: https://github.com/achillean/shodan-python
- Security details: https://otinstaller.com/osintverse-community/shodan-host/security