otx-indicators

v0.1.0Verified publisher
Report a problem

Looks up an IP, domain, URL or file hash in AlienVault OTX: the threat reports that mention it, malware, tags

Run

Through ot mcp, an agent calls run_tool with this; ot asks you before anything that goes online or touches a target. Set it up: ot mcp install claude (or cursor, vscode, codex, gemini).

{"tool":"osintverse-community/otx-indicators"}

Or just say: "Run osintverse-community/otx-indicators on … with OTInstaller." The registry's read-only MCP server at api.otinstaller.com/mcp can find tools without installing anything.

ot run osintverse-community/otx-indicators --format table
ot install osintverse-community/otx-indicators

Docker image in a read-only container · talks to otx.alienvault.com · no key · up to 2 min. The first ot run installs the tool after asking once. Drop --format table for JSON.

Don't have ot? Install it in one line
curl -fsSL https://get.otinstaller.com/ot | sh
What this script does
  1. Downloads the latest ot release for your machine from GitHub Releases.
  2. Checks its SHA-256 against checksums.txt, and the Ed25519 signature on that file against the key built into the script.
  3. Puts ot in /usr/local/bin or ~/.local/bin. Nothing else is written. Read the script.
irm https://get.otinstaller.com/ot.ps1 | iex
What this script does
  1. Downloads the latest ot release for your machine from GitHub Releases.
  2. Checks its SHA-256 against checksums.txt, and the Ed25519 signature on that file against the key built into the script.
  3. Puts ot in %LOCALAPPDATA%\Programs\ot, and adds it to your PATH. Nothing else is written. Read the script.
  • Pinnedimage sha256:bc8f09cc…ba16fd. The same bytes on every install; ot pulls by digest, never by tag.
  • Signedby https://github.com/osintverse-community/otx-indicators/.github/workflows/otinstaller-release.yml@refs/heads/main via token.actions.githubusercontent.com, verified by the registry on 24 Oct 2026. ot checks the same identity before every install and refuses another signer.
  • Scanned24 Oct 2026: 0 critical, 44 high, 63 medium, 62 low vulnerabilities; 0 embedded secrets, 0 malware heuristics; SBOM with 99 packages.
  • Workssmoke test passed on 24 Oct 2026 (exit 0 in 2.2 s, offline sandbox); the nightly health check has not run yet.
  • Backed upa copy of this image is on the registry's mirror. If the original registry refuses it, ot pulls the same digest from the mirror and checks the same signature.
  • Reviewedosintverse-community is a verified publisher: the registry confirmed who runs it, and a person reviewed its first release against the acceptable-use rules.

From the community

Issues →

Not health-checked yet; 0.1.0 came out today; nobody has said yet whether it works.

0.1.0 is in its first week. Nobody has said whether it works yet.

Used 0.1.0?It's broken for me

What you get back

Result envelope →
{
  "envelope": 1,
  "tool": "osintverse-community/otx-indicators@0.1.0",
  "runtime": "docker",
  "input": {
    "ip": "8.8.8.8"
  },
  "started_at": "2026-10-24T17:00:06Z",
  "exit_code": 0,
  "entities": [
    {
      "type": "ip",
      "value": "8.8.8.8",
      "source": "alienvault-otx",
      "confidence": "low",
      "attrs": {
        "pulses": 0,
        "malware_families": [],
        "adversaries": [],
        "industries": [],
        "validation": [
          "Known False Positive",
          "Whitelisted IP"
        ],
        "link": "https://otx.alienvault.com/indicator/ip/8.8.8.8",
        "reputation": 0,
        "asn": "AS15169 google llc",
        "country": "United States of America"
      }
    },
    {
      "type": "organization",
      "value": "AS15169 google llc",
      "source": "alienvault-otx",
      "confidence": "medium",
      "attrs": {
        "role": "network owner"
      }
    },
    {
      "type": "location",
      "value": "United States of America",
      "source": "alienvault-otx",
      "confidence": "low",
      "attrs": {
        "latitude": 37.751,
        "longitude": -97.822,
        "basis": "IP geolocation"
      }
    }
  ],
  "warnings": []
}

Recorded from the registry's own run of version 0.1.0 on its test input, 24 Oct 2026. --format table to read it; ot extract and ot auto to continue.

otx-indicators

Looks up an IP address, domain, URL or file hash in AlienVault OTX (Open Threat Exchange). It reports how many community threat reports ("pulses") mention the indicator and lists up to 20 of them, each with its name, tags, malware families, adversary, targeted countries, references, author and link, plus the malware families, adversaries and industries OTX relates to it, and any allow-list notes such as "Whitelisted IP". For an IP address it adds the network and location OTX has. Uses AlienVault's official Python client, OTXv2. Only OTX's own data is read, so the target is not contacted.

ot run osintverse-community/otx-indicators --domain example.com

Inputs

Give exactly one.

Input Required
ip one of these IP address
domain one of these Domain or host name; a name with more than two labels is looked up as both a domain and a host name, as OTX files them apart
url one of these URL
hash one of these MD5, SHA-1 or SHA-256 of a file

Keys

None needed. OTX_API_KEY (ot keys set OTX_API_KEY), from a free OTX account, raises the rate limits: https://otx.alienvault.com/settings.

Notes

Pulses are written by OTX's community. Treat their names and tags as claims to check, not verdicts: very common names such as example.com appear in thousands of them, which is why OTX's allow-list notes are reported too. An indicator OTX doesn't know gives no entities and a note on stderr.

Next steps

Open a pulse's link to see every indicator it lists, or look the target up in osintverse-community/virustotal.

Development

pip install OTXv2==1.5.12
python -m unittest
ot validate

Releases are built, signed and published by the otinstaller release workflow (Actions tab, with the version to release).

License

MIT

What next

otx-indicators finds ip, domain, url, document, other, organization, location. Tools that take those:

ip → 10 toolsdomain → 10 toolsurl → 10 toolsorganization → 6 toolsot auto, with a saved result

Other ip address tools

All ip address tools →

Alternatives to otx-indicators that also take an ip address; ot auto runs every installed one on the same value.

osintverse-community/ipwhois

Looks up who holds an IP address through RDAP: network, ASN, organisation and contacts

Takes ip address → finds organization, other
No key · Docker
Worked todayVerified publisher

osintverse-community/naabu

Lists an IP's open ports passively from Shodan InternetDB, without scanning it

Takes ip address → finds other
No key · Docker
Worked todayVerified publisher

osintverse-community/shodan-host

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

Takes ip address → finds location, organization, other
Key required · Docker
Worked todayVerified publisher

osintverse-community/greynoise

Looks up an IP address in GreyNoise to see whether it is internet background noise or a known benign service

Takes ip address → finds ip, organization, other
Key required · Python wheel
Worked todayVerified publisher

osintverse-community/dnsanity

Checks whether DNS resolvers answer correctly by comparing them with trusted resolvers on a test template

Takes ip address → finds ip
No key · Docker
Worked todayVerified publisher
Esc

Try

↑ ↓ to move↵ to open