https://github.com/kennbroorg/iky
OSINT Project. Collect information from a mail. Gather. Profile. Timeline.
https://github.com/kennbroorg/iky
email github gitlab hacking iky infosec intelligence keybase leaks linkedin mastodon osint privacy profile recon reddit spotify timeline twitch twitter
Last synced: 20 days ago
JSON representation
OSINT Project. Collect information from a mail. Gather. Profile. Timeline.
- Host: GitHub
- URL: https://github.com/kennbroorg/iky
- Owner: kennbroorg
- License: gpl-3.0
- Created: 2018-12-14T17:20:15.000Z (over 7 years ago)
- Default Branch: iKy
- Last Pushed: 2024-07-17T15:34:10.000Z (almost 2 years ago)
- Last Synced: 2025-05-16T11:06:04.715Z (11 months ago)
- Topics: email, github, gitlab, hacking, iky, infosec, intelligence, keybase, leaks, linkedin, mastodon, osint, privacy, profile, recon, reddit, spotify, timeline, twitch, twitter
- Language: HTML
- Homepage: https://kennbroorg.gitlab.io/ikyweb/
- Size: 64.7 MB
- Stars: 892
- Watchers: 22
- Forks: 151
- Open Issues: 17
-
Metadata Files:
- Readme: README.es.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
---
---
[Descripcion](#description) | [Instalacion](#installation) | [Website][website] | [Modulos](#modules) | [Issues][issues] | [Supporting](#sponsor)
---
[website]:https://kennbroorg.gitlab.io/ikyweb/
[issues]:https://gitlab.com/kennbroorg/iKy/-/issues/new?issue%5Bassignee_id%5D=&issue%5Bmilestone_id%5D=
[readmees]: README.es.md
[readmeen]: README.md
iKy
Descripcion
El proyecto iKy es una herramienta que colecta informacion a partir de una direccion de e-mail y muestra los resultados en una interface visual.
Visite el Gitlab Page del [Projecto](https://kennbroorg.gitlab.io/ikyweb/)
Modulos
Instalacion
### Prerequisitos
- [Docker](https://docs.docker.com/get-docker/)
- [Docker Compose](https://docs.docker.com/compose/install/) (incluido con Docker Desktop)
- (Opcional) [just](https://github.com/casey/just#installation) ejecutor de tareas
### Inicio rapido
```shell
git clone https://gitlab.com/kennbroorg/iKy.git
cd iKy
docker compose build
docker compose up -d
```
O, si tiene `just` instalado:
```shell
just build
just up
```
Abra su navegador en [http://localhost:4200](http://localhost:4200)
Para detener todos los servicios:
```shell
docker compose down
# o
just down
```
Desarrollo
El flujo de desarrollo utiliza un **virtualenv para linting/pre-commit hooks** y **Docker para compilar y ejecutar** la aplicacion.
### Configurar el entorno de desarrollo
Instale [just](https://github.com/casey/just#installation), luego:
```shell
just setup
source .venv/bin/activate
```
Esto crea un virtualenv de Python con `pre-commit` y `ruff`, e instala los git hooks.
### Recetas comunes
| Comando | Descripcion |
|---------|-------------|
| `just build` | Compilar imagenes Docker |
| `just up` | Iniciar todos los servicios |
| `just down` | Detener todos los servicios |
| `just logs` | Seguir logs del backend (`just logs frontend` para frontend) |
| `just ps` | Mostrar contenedores en ejecucion |
| `just shell-backend` | Abrir una shell en el contenedor del backend |
| `just shell-frontend` | Abrir una shell en el contenedor del frontend |
| `just lint` | Ejecutar ruff linter y verificacion de formato |
| `just fmt` | Auto-formatear codigo Python |
| `just restart backend` | Reiniciar un servicio especifico |
| `just rebuild` | Detener, recompilar e iniciar todos los servicios |
| `just clean` | Eliminar contenedores, volumenes e imagenes locales |
# 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
| **Modulo** | **Status** | **Campo en apikey** | **Descripcion** |
| :------------- | :--------: | :--------- | :--------- |
| Fullcontact | :octagonal\_sign: | | Discontinuado |
| PeopleDataLabs | :ok: | peopledatalabs\_key | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#peopledatalabs) |
| Linkedin | :ok: | linkedin\_li\_at / linkedin\_JSESSIONID [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) Metodo. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#linkedin) |
| Twitter | :ok: | twitter\_user / twitter\_pass [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) o usuario/password. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#twitter) |
| Instagram | :ok: | instagram\_user / instagram\_pass [\(***\)](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#postdata) | :free: Cookie browser(:cookie:) o user/pass. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#instagram) |
| HaveIBeenPwned | :ok: | haveibeenpwned\_key |:heavy\_dollar\_sign: API **Paid**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#haveibeenpwned) |
| Emailrep | :ok: | emailrep\_key | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#emailrep) |
| Leaklookup | :ok: | leaklookup\_key | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#leaklookup) |
| Spotify | :ok: | spotify\_client\_id / spotify\_client\_secret | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#spotify) |
| Twitch | :ok: | twitch\_client\_id / twitch\_client\_secret | :free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#twitch) |
| CSE (Google) | :ok: | cse\_api\_key / cse\_cx |:free: API **Free**. Explicado [aqui](https://gitlab.com/kennbroorg/iKy/-/wikis/APIs/ApiKeys-get#cse) |
| Reddit | :warning: | | En revision |
| Tiktok | :ok: | | Obtenida de su browser preferido. Solo logueese en tiktok |
Actualizar iKy
Descargue los ultimos cambios y reconstruya las imagenes Docker:
```shell
git pull
docker compose build
docker compose up -d
```
O con `just`:
```shell
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](https://gitlab.com/kennbroorg/iKy/-/wikis/home)
# Video Demo
Vimeo
Apoyar el proyecto
Ya sea que use este proyecto, haya aprendido algo de el o simplemente le guste, por favor considere apoyarlo comprandome un cafe, para que pueda dedicar mas tiempo a proyectos de codigo abierto como este.
# 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.