Skip to content

Latest commit

 

History

History
98 lines (69 loc) · 4 KB

README.md

File metadata and controls

98 lines (69 loc) · 4 KB

Image

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:

  1. Entrar al directorio:
    • cd Security Spy

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

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

  1. 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 📸

Image