Security Spy 💣

⚠️ Este sistema fué desarrollado únicamente por fines educativos, no me hago responsable por el el uso inadecuado y poco ético de quien lo use.

Descripción 📝

Security Spy es un proyecto que se encarga de realizar consultas a la página web oficial de Shodan por medio del método GET a las facetas, con el objetivo de obtener hasta 1000 datos por cada consulta que se haga, lo que resulta ser una alternativa a la API de consultas de Shodan, facilitando la obtención de datos que en un momento, solo se podían obtener usando una API KEY.

usage: Security Spy [-h] [--query QUERY] [--limit LIMIT] [--facet FACET]
              [--template TEMPLATE] [-ip IP] [--output OUTPUT] [--api_key API_KEY]

Security Spy es un script diseñado para realizar consultas al sistema de Shodan a través
de un Bypass que scrapea el apartado de las facetas, lo cual obtiene los mismos
datos que en la API oficial.

options:
  -h, --help            show this help message and exit
  --query QUERY, -q QUERY
                        Realizar una consulta a través del Bypass.
  --limit LIMIT, -l LIMIT
                        Indica un límite de datos que se procesarán por consulta.
                        (max: 1000) (default: 30)
  --facet FACET, -f FACET
                        Los datos que va a buscar. (default: ip)
  --template TEMPLATE, -T TEMPLATE
                        Indica una plantilla para mostrar los resultados.
  -ip IP                Realizar una consulta de la dirección IP usando la API
                        oficial.
  --output OUTPUT, -o OUTPUT
                        Indica el formato en el que se va a mostrar el contenido.
  --api_key API_KEY     Clave de API para realizar consultas.

Objetivos 🎯

Crear una alternativa gratuita a la API de Shodan, por medio de un scraper que recolecta información a través de las facetas que éste ofrece a través de su página web de facetas, lo que permite obtener exactamente los mismos datos que se obtiene al realizar una consulta a la API de Shodan, buscando fomentar el análisis en la seguridad informática, teniendo la capacidad de realizar consultas ilimitadas obteniendo hasta 1000 datos por consulta.

Funcionalidades 💡

El sistema Security Spy cuenta con dos funcionalidades principales que buscan un enfoque gratuito y de calidad:

• IPQuery: Un sistema que se encarga de realizar consultas a la API de shodan (Es gratuito) con la API KEY del usuario.
• Search: Un scraper que realiza la consulta automáticamente a la página de las facetas de shodan.

Requisitos 🛠️

• shodan Librería para la interacción con la API de Shodan.
• rich Librería para enviar mensajes con una estéticos.
• bs4 Librería para el procesamiento de código HTML.

Instalación 💻

Para instalar correctamente el script, sigue los siguientes pasos:

1. Clonar este repositorio:
   • git clone https://github.com/TechAtlasDev/SecuritySpy

2. Entrar al directorio:
   • cd Security Spy

3. Instalar python si no lo tienes instalado:
   • Para Ubuntu: sudo apt install python3 -y
   • Para Termux: apt install python3 -y

4. Instalar las dependencias y configurar el sistema Security Spy:
   • El setup es tan simple como poner el siguiente comando: bash setup.sh

5. Brindarle permisos de ejecución al sistema:
   • chmod +x src/Security Spy

Compatibilidad 🔨

Entorno	Es compatible	Probado en
Windows	❌	❌
Linux	✅	✅
Termux	✅	✅

Idiomas 🗣️

Idioma	Disponibilidad
Español	✅
Ingles	❌

Screenshot 📸