disclo

Buscador de contactos de dominio. Dale un dominio, obtén cada correo electrónico, handle y lead asociado con él, a través de 12 fuentes pasivas, en paralelo.

$ python disclo.py gitlab.com

disclo -> gitlab.com
----------------------------------------------------------------------

  [hackerone]
    https://hackerone.com/gitlab  (url)  <- Direct H1 handle match

  [nvd_cve]
    [email protected]  (email)  <- CVE sourceIdentifier (CVE-2021-22262)

  [security.txt]
    https://hackerone.com/gitlab/  (url)
    https://about.gitlab.com/security/disclosure/  (url)

  [twitter]
    https://twitter.com/gitlab  (twitter)  <- GitLab - Build software faster...

  Total: 30 contacts found

---

Instalación

git clone https://github.com/Chaelsoo/disclo
cd disclo
pip install -r requirements.txt

---

Uso

python disclo.py <domain>

Ejemplos:

python disclo.py example.com
python disclo.py tawk.to
python disclo.py speakylink.com

---

Fuentes

Fuente	Qué encuentra
security.txt	Correos electrónicos y URLs de contacto
security_page	Correos de las páginas /security, /contact, /about
dns_dmarc	Correos de registros DMARC rua/ruf
crtsh	Correos incrustados en campos CN/emisor de certificados
hackerone	Páginas de programas de H1 y Bugcrowd
github	Correos de miembros de la organización, enlaces SECURITY.md
npm / pypi	Correos de mantenedores de paquetes
job_posting	URLs de empleos en Lever y Greenhouse
nvd_cve	Correos del sourceIdentifier de CVE, referencias H1/Bugcrowd
twitter	Handles vía API de sindicación (sin autenticación)
sitecrawl	Correos y nombres de autores de un rastreo basado en sitemap
appstore	Información de desarrollador de App Store coincidente por ID de paquete

---

Variables de entorno opcionales

Se leen automáticamente, no se necesitan flags.

Variable	Efecto
GITHUB_TOKEN	Aumenta los límites de tasa de la API de GitHub (5000 req/h vs 60)
LINKEDIN_USER + LINKEDIN_PASS	Habilita el enriquecimiento de contactos de LinkedIn mediante la API de sesión
TWITTER_BEARER_TOKEN	Habilita la búsqueda de la API de Twitter v2

export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
python disclo.py target.com

---

Tipos de salida

• email - dirección de correo electrónico
• url - enlace de plataforma o aviso
• twitter - handle de Twitter/X
• linkedin - perfil de LinkedIn
• github - perfil de GitHub
• other - nombre de la persona

---

Estructura del proyecto

disclo/
├── disclo.py
├── requirements.txt
├── disclo/
│   ├── core/
│   │   ├── runner.py      # async orchestrator
│   │   ├── store.py       # contact deduplication
│   │   └── utils.py       # email validation
│   ├── sources/           # one file per data source
│   │   ├── security_txt.py
│   │   ├── security_page.py
│   │   ├── dns_records.py
│   │   ├── crtsh.py
│   │   ├── hackerone.py
│   │   ├── github.py
│   │   ├── npm.py
│   │   ├── jobs.py
│   │   ├── nvd.py
│   │   ├── twitter.py
│   │   ├── sitecrawl.py
│   │   └── appstore.py
│   └── output/
│       └── printer.py

Para agregar una nueva fuente: crea disclo/sources/mysource.py con una función async def run(client, domain, store), luego impórtala y agrégala a disclo/core/runner.py.