search_shodan
Query Shodan's database to discover internet-connected devices and services. Analyze results with customizable fields, facets, and pagination for cybersecurity research and threat intelligence.
Instructions
Search Shodan's database for devices and services
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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"
}