Cyberbro

Una aplicación simple que extrae tus IoCs de datos basura y verifica su reputación usando múltiples servicios.
🌐 demo.cyberbro.net

Acerca de

Inspirado en Cybergordon e IntelOwl.

Este proyecto tiene como objetivo proporcionar una forma simple y eficiente de verificar la reputación de tus observables usando múltiples servicios, sin tener que desplegar una solución compleja. Lee la documentación en https://docs.cyberbro.net/

[!TIP] Para crear informes personalizados, usa Cyberbro con tu LLM favorito (Claude, OpenAI gpt-5…) a través de MCP (Model Context Protocol).
Consulta Cyberbro MCP para más información.

Demo

graph_demo

Características

Entrada fácil: Pega logs o IoCs en bruto: análisis y extracción automáticos.
Verificaciones multiservicio: Búsqueda de reputación para IPs, hashes, dominios, URLs e IDs de extensiones de Chrome en numerosos servicios de inteligencia de amenazas.
Informes completos: Búsqueda avanzada, filtrado y exportación a CSV/Excel.
Procesamiento rápido: Multihilo para mayor velocidad.
Pivoting automatizado: Descubre dominios, URLs y IPs relacionados mediante DNS inverso y RDAP / Whois.
Información precisa de dominio y abuso: Consultas RDAP / Whois y contacto de abuso.
Integraciones: Microsoft Defender for Endpoint, CrowdStrike, OpenCTI, Grep.App, Hudson Rock y más.
Proxy y almacenamiento: Soporte de proxy y resultados almacenados en SQLite.
Historial y gráficos: Historial de análisis y vista de gráficos experimental.
Caché: Caché para búsquedas repetidas más rápidas (habilitada a nivel de multi-motores, no por motor individual).

¿Qué hace único a Cyberbro?

Para principiantes: Accesible para todos los niveles de habilidad.
Búsqueda de ID de extensión de Chrome: Obtén nombres de extensiones y datos CTI a partir de IDs.
Despliegue ligero: Configuración y uso simples.
Extracción avanzada de TLD: Detección precisa del dominio raíz para mejores búsquedas.
Recopilación pragmática de datos: Usa GitHub y Google para encontrar IoCs pasados por alto.
Integración de informes CTI: Obtiene informes relacionados con IoCs desde IoC.One.
Integración EDR: Verifica observables contra tus propias herramientas de seguridad (MDE, CrowdStrike).

Primeros pasos - TL;DR

[!TIP] Si eres perezoso, necesitas Docker.
Haz un git clone; copia .env.sample a .env; docker compose up y luego ve a localhost:5000. ¡Sí, así de simple!

Primeros pasos

Para comenzar, clona el repositorio

git clone https://github.com/stanfrbd/cyberbro
cd cyberbro

Editar el archivo de configuración (obligatorio)

cp .env.sample .env

[!NOTE] ¿No tienes claves API? No hay problema, simplemente copia .env.sample a .env y deja los valores opcionales vacíos. Ten cuidado si se usa un proxy.
¡Podrás usar todos los motores gratuitos!

Completa los valores (incluyendo proxy si es necesario) en el archivo .env.

[!WARNING] .env contiene secretos sensibles y nunca debe ser versionado. Para despliegues en producción/equipo, usa SOPS, Vault o un flujo de trabajo equivalente con gestor de secretos.

ABUSEIPDB=token_aqui
ALIENVAULT=token_aqui
CRIMINALIP_API_KEY=token_aqui
CROWDSTRIKE_CLIENT_ID=client_id_aqui
CROWDSTRIKE_CLIENT_SECRET=client_secret_aqui
DFIR_IRIS_API_KEY=token_aqui
DFIR_IRIS_URL=https://dfir-iris.local
GOOGLE_CSE_CX=cx_aqui
GOOGLE_CSE_KEY=key_aqui
GOOGLE_SAFE_BROWSING=token_aqui
HISTER_TOKEN=token_aqui
HISTER_BASE_URL=https://hister.example.com
IPAPI=token_aqui
IPINFO=token_aqui
MDE_CLIENT_ID=client_id_aqui
MDE_CLIENT_SECRET=client_secret_aqui
MDE_TENANT_ID=tenant_aqui
MISP_API_KEY=token_aqui
MISP_URL=https://misp.local
MISP_FEEDBACK_SERVER_URL=https://misp-feedback.local
MISP_FEEDBACK_TOKEN=token_aqui
OPENCTI_API_KEY=token_aqui
OPENCTI_URL=https://demo.opencti.io
PROXY_URL=
RANSOMWARE_LIVE_API_KEY=token_aqui
RL_ANALYZE_API_KEY=token_aqui
RL_ANALYZE_URL=https://spectra_analyse_url_aqui
ROSTI_API_KEY=token_aqui
SHODAN=token_aqui
SPUR_US=token_aqui
THREATFOX=token_aqui
VIRUSTOTAL=token_aqui
WEBSCOUT=token_aqui

[!IMPORTANT] A partir de la versión v0.13.0, Cyberbro ya no soporta secrets.json ni la página /config. Cf. discusión 165.
Si ya tienes un secrets.json legacy, conviértelo a .env con: python3 scripts/secrets_json_to_env.py

Consulta Opciones avanzadas para despliegue en la documentación.

Iniciar la aplicación

Fácil y perezoso - usa docker

[!WARNING] Asegúrate de instalar el plugin compose como docker compose y no docker-compose. En Docker, la aplicación se vincula a 0.0.0.0 dentro del contenedor incluso si tu .env local establece FLASK_HOST=127.0.0.1.

docker compose up # usa -d para ejecutar en segundo plano y --build para reconstruir la imagen

Ve a http://127.0.0.1:5000 y disfruta.

No olvides editar .env antes de construir la imagen.

Consulta Opciones avanzadas para despliegue en la documentación para obtener todas las opciones de despliegue con Docker.

La forma antigua

Clona el repositorio e instala los requisitos.

Quizás quieras crear un venv antes de instalar las dependencias.

pip install -r requirements.txt

Ejecuta la aplicación con gunicorn (modo limpio).

gunicorn -c prod/gunicorn.conf.py app:app

Ejecuta la aplicación en modo de desarrollo.

python3 app.py

Capturas de pantalla

Ver todas las capturas de pantalla

[!CAUTION] Si planeas usar esto en un entorno de producción, utiliza un Proxy Inverso bien configurado + WAF para evitar problemas de seguridad.

Extensión de navegador Cyberbro

API de Cyberbro

La API está disponible en /api/ y se puede acceder a través de la GUI o la línea de comandos.

Actualmente hay 3 endpoints:

/api/analyze - Analiza un texto y devuelve el ID del análisis (JSON).
/api/is_analysis_complete/<analysis_id> - Verifica si el análisis está completo (JSON).
/api/results/<analysis_id> - Recupera los resultados de un análisis anterior (JSON).

curl -X POST "http://localhost:5000/api/analyze" -H "Content-Type: application/json" -d '{"text": "cyberbro.net", "engines": ["reverse_dns", "rdap_whois"]}'

{
  "analysis_id": "e88de647-b153-4904-91e5-8f5c79174854",
  "link": "/results/e88de647-b153-4904-91e5-8f5c79174854"
}

curl "http://localhost:5000/api/is_analysis_complete/e88de647-b153-4904-91e5-8f5c79174854"

{
  "complete": true
}

curl "http://localhost:5000/api/results/e88de647-b153-4904-91e5-8f5c79174854"

[
  {
    "observable": "cyberbro.net",
    "rdap_whois": {
      "abuse_contact": "[email protected]",
      "creation_date": "2024-12-20",
      "data_source": "rdap",
      "emails": [
        "[email protected]"
      ],
      "expiration_date": "2026-12-20",
      "link": "https://rdap.verisign.com/net/v1/domain/CYBERBRO.NET",
      "name_servers": [
        "anderson.ns.cloudflare.com",
        "lisa.ns.cloudflare.com"
      ],
      "organization": null,
      "registrant": null,
      "registrant_country": null,
      "registrant_email": null,
      "registrar": "Cloudflare, Inc.",
      "update_date": "2025-11-20"
    },
    "reverse_dns": {
      "reverse_dns": [
        "172.67.197.226",
        "104.21.42.7"
      ]
    },
    "reversed_success": true,
    "type": "FQDN"
  }
]

[!NOTE] La página de documentación dedicada proporciona todos los nombres de motores utilizables.

API y servicios de terceros

AbuseIPDB
Abusix
Alienvault
CriminalIP
CrowdStrike
crt.sh
DFIR Iris
Github
Google Safe Browsing
Google
Google DNS
Grep.App
Hister
Hudson Rock
ICANN
IPapi
IPinfo
IPquery
Ioc.One
Microsoft Defender for Endpoint
MISP
MISP Feedback
OpenCTI
OpenRDAP
Phishtank
Ransomware.Live
ReversingLabs Spectra Analyze
Rösti - Repackaged Open Source Threat Intelligence
Shodan
Spur.us
ThreatFox
URLscan
VirusTotal
WebScout

[!NOTE] ¿Alguna pregunta? Consulta https://docs.cyberbro.net o abre una incidencia
Para la configuración avanzada (ajuste de supervisord.conf antes del despliegue, selección de motores visibles, cambio del prefijo /api/...), consulta la página de documentación dedicada.

Agradecimientos especiales

Un enorme agradecimiento a todos los increíbles colaboradores que hicieron pull requests y ayudaron a mejorar este proyecto:

Florian PILLOT que rediseñó los motores (refactorización y optimizaciones).
Axel que desarrolla Ioc.One y agregó un User-Agent específico permitiendo el scraping de Ioc[.]One.
Jon Mark Allen que agregó una mejor gestión de secretos y pruebas. Refactorizó mucho e hizo muchas mejoras en el código base, incluyendo CriminalIP.
cirosec GmbH - Felix Friedberger por agregar el motor crt.sh.
Stig Dahl por mejorar el motor crt.sh, agregar la búsqueda DFIR IRIS y corregir problemas de Bandit, corregir el motor MISP, agregar el motor MISP Feedback.
0xffr por corregir el problema #98 - Motor Grep.app roto y comentar correctamente en el motor CriminalIP.
Maxime Berthault - Maxou56800 por desarrollar Cyberbro CLI.

¡Tus contribuciones son muy apreciadas!

Licencia

Licencia MIT

Copyright (c) 2024-2026 stanfrbd

Por la presente se concede permiso, libre de cargos, a cualquier persona que obtenga una copia
de este software y los archivos de documentación asociados (el "Software"), para tratar
el Software sin restricción, incluidos, sin limitación, los derechos
de uso, copia, modificación, fusión, publicación, distribución, sublicencia y/o venta
de copias del Software, y para permitir a las personas a quienes se les proporcione el
Software a hacer lo mismo, sujeto a las siguientes condiciones:

El aviso de copyright anterior y este aviso de permiso se incluirán
en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA
O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD,
IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO
LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑOS U OTRAS
RESPONSABILIDADES, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRO MODO, QUE SURJA
DE, O EN CONEXIÓN CON, EL SOFTWARE O EL USO U OTRO TIPO DE ACCIONES EN EL
SOFTWARE.

Logo

El logo utilizado en este proyecto es gratuito para uso personal y comercial y se puede encontrar aquí.

cyberbro v0.14.2

Categorías