Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Euronymou5 authored Apr 13, 2024
1 parent 677a30e commit d3cfd6c
Showing 1 changed file with 72 additions and 26 deletions.
98 changes: 72 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,57 +1,103 @@
# Dark-Hydro (BETA)
**Dark-Hydro es una herramienta de osint completa para un numero telefonico.**
# Dark-Hydro

**Con Dark-Hydro puedes obtener:**
Dark-Hydro es una herramienta de OSINT creada en Python con el objetivo de recopilar información sobre un número de teléfono utilizando APIs públicas y técnicas de Google Dorking.

*- Codigo del pais*
Con Dark-Hydro es pobible obtener:

*- Nombre del pais*
>- Codigo del pais_
*- Ubicacion del numero de telefono (Ciudad)*
> - Nombre del pais_
*- Transportador*
>- Ubicacion del numero de telefono (Ciudad)_
*- Latitud y Longitud*
> - Transportador_
*- Busquedas de dorking archivos pdf, redes sociales, donde el numero telefonico ha sido encontrado*
>- Latitud y Longitud_
## Probado en:
>- Búsquedas de dorking archivos pdf, redes sociales, paginas web, donde el numero telefónico ha sido encontrado
* Kali Linux
## Configuracion

* Parrot OS
Antes de utilizarlo, es necesario configurar algunas claves API, entre las API:

* Ubuntu
- [Numverify](https://numverify.com)
- [Opencage](https://opencagedata.com)
- [Abstract API](https://www.abstractapi.com/api/phone-validation-api)
- [VeriPhone](https://veriphone.io)

# Configuracion
Una vez obtenida nuestra clave API, es necesario colocar cada una en orden en el archivo `config.json` de la siguiente forma:

**Antes de usar la herramienta es necesario configurar las apikeys de:**
```json
{
"OpencageKey": "ReemplazarPorApikeyOpencage",
"Numverifykey": "ReemplazarPorApikeyNumverify",
"Abstract": "ReemplazarPorApikeyAbstract",
"VeriPhone": "ReemplazarPorApikeyVeriPhone"
}
```
## Instalacion

**https://numverify.com/**
> Clonamos el repositorio.
````
git clone https://github.com/Euronymou5/Dark-Hydro
````

**https://opencagedata.com/**
> Ejecutamos el instalador de las dependecias.
```
sudo bash install.sh
```

**Despues de tener las apikeys es necesario colocarlas en el archivo** *config.json* **En orden cada una.**
### Ejemplos de uso

# Instalacion
> Mostrar ayuda.
```
git clone https://github.com/Euronymou5/Dark-Hydro
python3 main.py -h
```
```
cd Dark-Hydro
usage: main.py [-h] [-phoneinfoga] [-numero NUMERO] [-phonenumbers] [-numverify] [-opencage] [-abstract] [-veriphone]
[-dork DORK]
options:
-h, --help show this help message and exit
-phoneinfoga Añadir escaneo de la tool phoneinfoga.
-numero NUMERO, -n NUMERO
Agregar numero telefonico.
-phonenumbers Añadir escaneo de la libreria phonenumbers.
-numverify Agregar escaneo de numverify.
-opencage Agregar escaneo con opencage.
-abstract Agregar escaneo con abstract api.
-veriphone Agregar escaneo con VeriPhone.
-dork DORK Agregar escaneo con google dorks.
```


> Ejemplo de uso basico
```
pip3 install -r requirements.txt
python3 main.py -n +19496660724 -phonenumbers
```
>Mas de una api en el escaneo
```
python3 main.py
python3 main.py -n +19496660724 -veriphone -numverify -phoneinfoga
```
> Uso del argumento dork
```
python3 main.py -n +19496660724 -dork 15
```
El argumento "dork" recibe un valor entero, en este caso el número 15. Este número será la cantidad de resultados que nos dará al realizar un escaneo con Google Dorking sobre el número de teléfono.

**Aclaracion!**

A veces, no se mostrará ningún resultado utilizando el dorking, lo que indica que el número telefónico no ha sido encontrado en ningún sitio de internet.

## Imagenes

<img src="https://media.discordapp.net/attachments/995599976463859713/1066133545468305418/image.png?width=675&height=295">
![image](https://github.com/Euronymou5/Dark-Hydro/assets/85043356/029821e2-db56-40a8-b7ea-d1c83c7a30e5)


## :globe_with_meridians: Contacto :globe_with_meridians:
[![discord](https://img.shields.io/badge/Discord-euronymou5-a?style=plastic&logo=discord&logoColor=white&labelColor=black&color=7289DA)](https://discord.com/users/452720652500205579)

# Contacto
![email](https://img.shields.io/badge/ProtonMail-mr.euron%40proton.me-a?style=plastic&logo=protonmail&logoColor=white&labelColor=black&color=8B89CC)

*Discord: Euronymou5#3155*
[![Twitter](https://img.shields.io/badge/Twitter-@Euronymou51-a?style=plastic&logo=twitter&logoColor=white&labelColor=black&color=1DA1F2)](https://twitter.com/Euronymou51)

0 comments on commit d3cfd6c

Please sign in to comment.