Descripcion   |   Instalacion   |   Website   |   Modulos   |   Issues   |   Supporting

iKy

Descripcion

iKy es una herramienta OSINT que colecta informacion a partir de una direccion de e-mail u otros selectores y muestra los resultados en una interface visual.

Instalacion

Prerequisitos

• Docker
• Docker Compose (incluido con Docker Desktop)
• (Opcional) just ejecutor de tareas

Inicio rapido

git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
just build
just up

Abra su navegador en http://localhost:4300

Para detener todos los servicios:

just down

just up inicia backend, iky-frontend y redis. No se levanta ningun otro servicio por defecto.

Sin Docker (nativo)

Si no puede usar Docker, iKy puede correr de forma nativa: Caddy sirve el frontend pre-compilado y Redis + Celery + Uvicorn corren como procesos locales. Requiere redis-server, Python 3.12, curl y tar en el host (Caddy se descarga automaticamente).

just setup          # crear el venv
just up-native      # instala deps, descarga Caddy + frontend, levanta todo

Abra su navegador en http://localhost:4300. Detenga con Ctrl-C o just down-native.

El frontend se descarga del ultimo release de GitHub — sin build de Node. tor no se levanta en modo nativo; solo el modulo darkweb lo necesita.

Arquitectura

Modulos

iKy enruta 26 modulos a traves de backend/module_registry.py:

API Keys

Una vez cargada la aplicacion en el navegador, deberia obtener la mayoria de las APIs y/o cookies de sesion del navegador. A continuacion se muestra una tabla con todos los campos a rellenar

Las APIs marcadas con 🍪 usan cookies de sesion del navegador; el resto usan tokens de servicio.

Cookies de sesion

Algunos modulos (LinkedIn, Twitter, TikTok) necesitan cookies de sesion de su navegador para obtener informacion. Las cookies se guardan en backend/cookies/ (montado en el contenedor como /app/cookies) y persisten entre reinicios. Hay dos formas de cargarlas, ambas mediante just.

Las cookies son tokens de sesion personales: no las comparta ni las suba al repositorio (backend/cookies/ esta ignorado por git).

Opcion A: Importar un export del navegador

Exporte las cookies del sitio con una extension tipo Cookie-Editor a un archivo JSON e importelo:

just cookies-import linkedin ~/Descargas/linkedin_cookies.json

Opcion B: Obtenerlas automaticamente del navegador

Extrae las cookies directamente de su navegador local. Cierre el navegador antes de ejecutarlo (un navegador abierto bloquea su base de cookies):

# Prueba todos los navegadores instalados (firefox, chrome, brave, edge)
just cookies-grab linkedin linkedin.com

# O uno especifico
just cookies-grab linkedin linkedin.com brave

El comando informa, navegador por navegador, que pudo leer y que no, y escribe el archivo solo si encuentra las cookies que el modulo necesita. Por ejemplo, LinkedIn requiere li_at y JSESSIONID.

Las cookies vencen cada cierto tiempo (las de LinkedIn duran entre 1 y 3 meses). Cuando un modulo deje de autenticarse, vuelva a ejecutar el comando.

Desarrollo

El flujo de desarrollo utiliza un virtualenv para linting/pre-commit hooks y Docker (o el flujo nativo just up-native) para compilar y ejecutar la aplicacion.

Configurar el entorno de desarrollo

Instale just, luego:

just setup
source .venv/bin/activate

Esto crea un virtualenv de Python con pre-commit y ruff, e instala los git hooks.

Recetas comunes

Actualizar iKy

Descargue los ultimos cambios y reconstruya las imagenes Docker:

git pull
just rebuild

Para preservar sus API keys entre actualizaciones, use las opciones de Exportar/Importar en el menu de apikeys de la interface grafica.

Wiki

• iKy Wiki (En actualización)

Video Demo

Vimeo

Apoyar el proyecto

Aviso Legal

Todo aquel que contribuya o haya contribuido con el proyecto, incluyendome, no somos responsables por el uso de la herramienta (Ni el uso legal ni el uso ilegal, ni el "otro" uso).

Tenga en cuenta que este software fue inicialmente escrito para una broma, luego con fines educativos (para educarnos a nosotros mismos), y ahora el objetivo es colaborar con la comunidad haciendo software libre de calidad, y si bien la calidad no es excelente (a veces ni siquiera buena) nos esforzamos en perseguir la excelencia.

Considere que toda la informacion recolectada esta libre y disponible por internet, la herramienta solo intenta descubrirla, recolectarla y mostrarla. Muchas veces la herramienta ni siquiera puede lograr su objetivo de descubrimiento y recoleccion. Por favor, cargue las APIs necesarias antes de acordarse de mi madre. Si aun con las APIs no muestra cosas "lindas" que usted espera ver, pruebe con otros e-mails antes de acordarse de mi madre. Si aun probando con otros e-mails no ve las cosas "lindas" que usted espera ver, puede crear un issue, contactarnos por e-mail o por cualquiera de las RRSS, pero tenga en cuenta que mi madre no es ni la creadora ni contribuye con el proyecto.

No reembolsamos su dinero si no esta satisfecho.

Espero que disfrute la utilizacion de la herramienta tanto como nosotros disfrutamos hacerla. El esfuerzo fue y es enorme (Tiempo, conocimiento, codificacion, pruebas, revisiones, etc) pero lo hariamos de nuevo.

No use la herramienta si no puede leer claramente las instrucciones y/o el presente Aviso Legal.

Por cierto, para quienes insistan en acordarse de mi madre, ella murio hace muchos anos pero la amo como si estuviera aqui mismo.