Shodan logo

Integrate Shodan with your AI CRM

Shodan provides Internet intelligence for discovering exposed devices and services, searching host data, monitoring network exposure, and consuming real-time collection feeds.

Explore Triggers and Actions

Add Alert Notifier

Attach an existing notifier to a paid Shodan network alert. This changes notification routing: future matching alert events may be delivered to the notifier's external destination. Verify both ids and the destination before calling.

ActionTry it

Add Organization Member

Add a Shodan user to the connected Enterprise organization and upgrade their account, granting organization access. This is an administrative membership mutation. When notify is true, Shodan also sends an external email notification to the user about the invitation or access change; confirm the intended username or email address and access change before calling.

ActionTry it

Count Hosts

Count hosts matching a Shodan search query and optionally return facet counts, without returning banners or consuming query credits for a plain count.

ActionTry it

Create Network Alert

Create continuous Shodan monitoring for specified IP addresses or CIDR ranges. This paid operation changes account monitoring state and consumes monitored-IP capacity for the expanded ranges. Review the complete target set and available capacity before calling; the alert remains active until it expires or is deleted.

ActionTry it

Create Notifier

Create a reusable Shodan notification destination. This does not affect alert routing until the notifier is attached to an alert, and it does not send a test notification. Provider arguments may contain personal contact details or secrets such as webhook URLs, routing keys, and access tokens; confirm the destination and avoid exposing these values.

ActionTry it

Delete Network Alert

Permanently delete a Shodan network alert and stop monitoring its configured IP addresses or CIDR ranges. This destructive paid-account action cannot be undone; verify the alert id before calling it.

ActionTry it

Delete Notifier

Permanently delete a Shodan notification service. This destructive action cannot be undone and can stop delivery for every alert that uses the notifier. Never delete the account's default notifier; verify the notifier id and its alert dependencies before calling.

ActionTry it

Disable Alert Trigger

Disable one or more trigger rules on a paid Shodan network alert. This changes the alert configuration and prevents those trigger types from generating future alert events and notifications; verify the trigger names before calling.

ActionTry it

Enable Alert Trigger

Enable one or more trigger rules on a paid Shodan network alert. This mutates the alert configuration and can cause future matching events to generate notifications; verify the alert id and trigger names before calling.

ActionTry it

Get Account Profile

Return membership status, credits, display name, username, creation time, and additional profile fields for the owner of the connected Shodan API key. This response contains private account identity, contact, and subscription information; disclose or store it only when necessary.

ActionTry it

Get API Plan Information

Return the connected API key's Shodan plan, query and scan credits, monitored-IP allowance, usage limits, and unlocked protocol features.

ActionTry it

Get Domain Information

Return one page of subdomains and DNS records for a domain. Each lookup consumes 1 Shodan query credit and requires Shodan Membership or higher.

ActionTry it

Get Execution Egress IP

Return the public source IP address Shodan observes for this API request. When called through Composio, this is normally the outbound proxy or execution environment address, not the end user's device IP address.

ActionTry it

Get Host Information

Return Shodan's current or historical service observations for one IP address. The main REST API host lookup requires Shodan Membership or higher.

ActionTry it

Get Network Alert

Get one Shodan network alert, including its filters, triggers, and attached notifiers. Paid monitoring capacity is required to have active alerts.

ActionTry it

Get Notifier

Get one Shodan notification service and its provider-specific destination arguments. The response can contain personal or secret routing data.

ActionTry it

Get Observed Request Headers

Return the HTTP request headers Shodan observes for this Composio API call. Use this transport diagnostic to inspect proxy-visible request metadata, not to retrieve headers from an Internet host.

ActionTry it

Get Organization

Return the connected account's Shodan organization, administrators, members, member upgrade, authorized domains, and branding. This Enterprise-only response contains private usernames and email addresses. Accounts without the organization entitlement can receive an HTML 403 response, which this action reports as an entitlement error.

ActionTry it

Get Scan Status

Return the submission or processing status of one Shodan on-demand scan. Creating on-demand scans requires a paid API plan and consumes scan credits.

ActionTry it

Ignore Alert Service

Add one IP:port service to a Shodan network alert trigger's ignore list so matching events no longer notify. This paid-account action changes future notification behavior for the selected trigger.

ActionTry it

List Alert Triggers

List trigger rules that can be enabled on Shodan network alerts. Configuring network alerts requires paid monitoring access.

ActionTry it

List Crawled Ports

List TCP and UDP port numbers currently crawled by Shodan.

ActionTry it

List Dataset Files

List downloadable file metadata for one Shodan bulk dataset. Bulk dataset access is an Enterprise feature; this action returns metadata and does not download the files.

ActionTry it

List Datasets

List bulk Shodan datasets available to the connected account. Bulk data requires a Shodan Enterprise entitlement.

ActionTry it

List Network Alerts

List network alerts on the connected account, optionally including expired alerts. Accounts without monitoring capacity can return an empty list.

ActionTry it

List Notifier Providers

List supported notification providers and the provider-specific argument names each requires.

ActionTry it

List Notifiers

List notification services available on the connected account. Returned provider arguments can contain personal or secret destination data; do not log or expose them unnecessarily.

ActionTry it

List Saved Queries

Return one page of community-saved Shodan search queries, with optional vote or timestamp ordering.

ActionTry it

List Saved Query Tags

List the most popular tags used by community-saved Shodan queries.

ActionTry it

List Scan Protocols

List protocol names and descriptions accepted by Shodan on-demand scan requests.

ActionTry it

List Scans

Return one page of active and recent on-demand scans for the connected Shodan account. Creating scans still requires credits and a paid plan.

ActionTry it

List Search Facets

List facet names accepted by Shodan host search.

ActionTry it

List Search Filters

List filter names accepted in Shodan host-search query syntax.

ActionTry it

Remove Alert Notifier

Detach a notifier from a paid Shodan network alert so future matching events are no longer sent through it. This changes the alert's notification configuration but does not delete the notifier itself.

ActionTry it

Remove Organization Member

Permanently remove a member from the connected Shodan Enterprise organization and downgrade their account. This destructive administrative action immediately changes the user's access and entitlements and cannot be undone automatically. Verify the exact username or email address and obtain explicit authorization before calling.

ActionTry it

Request Internet Scan

Submit an Internet-wide scan for one port and protocol, initiating external network traffic and consuming scan credits. This operation is restricted to approved security researchers and Enterprise Data license holders; call it only with explicit authorization.

ActionTry it

Request Scan

Submit an asynchronous Shodan scan for specified IP addresses or CIDR ranges. This paid operation initiates network traffic and consumes one scan credit per IP. Use it only for systems you own or have explicit authorization to assess; review the full target set before calling.

ActionTry it

Resolve Hostnames

Resolve one or more hostnames to IP addresses. Shodan Membership or higher is required. The response maps each resolved hostname to its IP address.

ActionTry it

Reverse DNS Lookup

Look up hostnames for one or more IP addresses. Shodan DNS API access requires Membership or higher.

ActionTry it

Search Hosts

Return one page of Shodan banners matching a query, with optional facets and field selection. Filters or pages after page 1 can consume query credits and availability varies by plan.

ActionTry it

Search Saved Queries

Return one page of community-saved Shodan queries matching text.

ActionTry it

Tokenize Search Query

Parse a Shodan search query into text, filters, attributes, and syntax errors without running the search.

ActionTry it

Unignore Alert Service

Remove one IP:port service from a Shodan network alert trigger's ignore list so matching events can notify again. Requires a paid network alert.

ActionTry it

Update Network Alert

Replace the complete IP and CIDR range list monitored by an existing Shodan network alert. This changes paid monitoring coverage and may change which future matching events generate notifications; review the full replacement list before calling.

ActionTry it

Update Notifier

Replace provider-specific arguments for an existing Shodan notifier. This changes where future notifications are delivered and can expose notification content to an external email address, webhook, phone number, or chat service. Verify the notifier id and every destination value before calling.

ActionTry it

How the Shodan integration works

The Shodan integration connects your Dench AI CRM directly to Shodan, so agents can read and act on your Shodan data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.

45 actions are available for agents to invoke on your behalf. Every call runs through Shodan's own authorization, scoped to the account you connect.

Set up Shodan in Dench

  1. 1

    Sign in to your Dench workspace and open Integrations.

  2. 2

    Find Shodan and click Connect — you'll authorize access through Shodan's own sign-in flow. No API keys or code required.

  3. 3

    Ask an agent to use Shodan in chat, or call it from an automation.

  4. 4

    Manage or disconnect the connection any time from workspace settings.

Frequently asked questions

How does the Shodan integration work with Dench?

The Dench Shodan integration connects your AI CRM to Shodan, so AI agents can work with your Shodan data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.

What actions can AI agents perform with Shodan via Dench?

The Shodan integration currently exposes 45 actions, including Add Alert Notifier, Add Organization Member, Count Hosts, Create Network Alert, Create Notifier, and Delete Network Alert. Agents invoke them on your behalf from chat or from automations.

Do I need to write code to connect Shodan to Dench?

No. You connect Shodan from your Dench workspace using Shodan's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.

Is the Shodan integration secure?

Connections are authorized through Shodan's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Shodan connection from your workspace settings at any time.

Shodan | Dench AI CRM