search_shodan

search_shodan

Query Shodan's database to identify internet-connected devices and services, specifying facets, fields, and pagination for targeted cybersecurity research and threat intelligence.

Instructions

Search Shodan's database for devices and services

Input Schema

Name	Required	Description
`facets`	No	List of facets to include in the search results (e.g., ['country', 'org'])
`fields`	No	List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name'])
`max_items`	No	Maximum number of items to include in arrays (default: 5)
`page`	No	Page number for results pagination (default: 1)
`query`	Yes	Shodan search query (e.g., 'apache country:US')
`summarize`	No	Whether to return a summary of the results instead of the full data (default: false)

Input Schema (JSON Schema)

{
  "properties": {
    "facets": {
      "description": "List of facets to include in the search results (e.g., ['country', 'org'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "fields": {
      "description": "List of fields to include in the results (e.g., ['ip_str', 'ports', 'location.country_name'])",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "max_items": {
      "description": "Maximum number of items to include in arrays (default: 5)",
      "type": "number"
    },
    "page": {
      "description": "Page number for results pagination (default: 1)",
      "type": "number"
    },
    "query": {
      "description": "Shodan search query (e.g., 'apache country:US')",
      "type": "string"
    },
    "summarize": {
      "description": "Whether to return a summary of the results instead of the full data (default: false)",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Shodan MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Shodan MCP Server

Related Tools