v2.9.0 — Censys Integration

What's new

Censys integration

New tool search_censys queries the Censys Search API for internet-facing infrastructure data.

Auto-detects input type:

Input	Endpoint	Returns
IPv4 address	CensysHosts().view()	Open ports, services, ASN, country, last updated
Domain	CensysCerts().search()	Certificate count, issuer, SANs, first/last seen

Available across all three interfaces:

• Interactive REPL (AI agent chains it automatically for IP and domain targets)
• Direct CLI: openosint censys TARGET [-t SECONDS]
• MCP server: search_censys tool

Required environment variables:

CENSYS_API_ID=...
CENSYS_SECRET=...

Get credentials at censys.io/account.

Install the optional dependency:

pip install censys
# or
pip install "openosint[censys]"

Example output — IP:

[Censys] Type: ip
[Censys] IP: 8.8.8.8
[Censys] Open Ports: 53, 443, 853
[Censys] Services: DNS, HTTPS, DNS-over-TLS
[Censys] ASN: AS15169 Google LLC
[Censys] Country: United States
[Censys] Last Updated: 2026-05-18

Example output — domain:

[Censys] Type: domain
[Censys] Domain: example.com
[Censys] Certificates Found: 12
[Censys] Issuer: Let's Encrypt
[Censys] SANs: example.com, www.example.com, api.example.com
[Censys] First Seen: 2020-01-15
[Censys] Last Seen: 2026-05-18

Other changes

• Agent system prompt updated to suggest search_censys for IP and domain infrastructure investigations
• README: tools table, env vars, optional packages, CLI synopsis, new tool section, Integrations table
• docs/index.html: tools table updated
• pyproject.toml: censys>=2.2.0 added as optional dependency (censys and all extras)
• 10 new tests — missing credentials, input detection, graceful error handling
• 110/110 tests passing

Full changelog

See CHANGELOG.md for the complete entry.

Full Changelog: v2.8.0...v2.9.0