TrueCall_Condor es una herramienta de OSINT (Open Source Intelligence) diseñada para recopilar, enriquecer y documentar automáticamente números de teléfono, dominios, URLs y correos electrónicos utilizados en estafas, fraudes y campañas de phishing.
Su propósito es investigar y exponer infraestructuras maliciosas desde una perspectiva ética y legal, generando informes estructurados que puedan ser publicados, compartidos o entregados a autoridades.
Cuando ejecutes python3 truecall_condor.py, verás un menú interactivo con las siguientes opciones:
┌─────────────────────────────────────────────────────┐
│ 🎯 ELIGE UNA OPCIÓN │
├─────────────────────────────────────────────────────┤
│ [1] 📞 Añadir número de teléfono │
│ [2] 🌐 Añadir dominio o URL │
│ [3] ✉️ Añadir email │
│ [4] 📋 Ver últimas 10 entradas │
│ [5] 📊 Generar informe completo (README.md) │
│ [6] 📤 Exportar CSV para autoridades │
│ [7] ❓ Acerca de / Explicación │
│ [8] 🚪 Salir │
└─────────────────────────────────────────────────────┘
| Opción | Función | ¿Qué hace exactamente? |
|---|---|---|
| [1] | Añadir número de teléfono | Te pide un número (ej: +34987790957) y lo guarda con su prefijo y localización aproximada. |
| [2] | Añadir dominio o URL | Te pide un dominio (ej: seguridad-falsa.top) o URL completa y extrae IP, WHOIS y MX. |
| [3] | Añadir email | Te pide un email (ej: soporte@falso.com) y analiza su dominio y servidores MX. |
| [4] | Ver últimas 10 entradas | Muestra los 10 últimos datos añadidos, con su tipo, fecha y notas. |
| [5] | Generar informe completo | Crea reports/README.md (estadísticas) y reports/scam_export.csv (CSV para autoridades). |
| [6] | Exportar CSV para autoridades | Solo genera el CSV (útil si no quieres el informe Markdown). |
| [7] | Acerca de / Explicación | Muestra información sobre la herramienta, su filosofía y comandos útiles. |
| [8] | Salir | Cierra la herramienta. |
Ahora sí, ya tienes el menú explicado en el README. ¿Falta algo más o ya estamos listos, jefe? 🦅
TrueCall_Condor está pensada para investigadores de seguridad, periodistas, equipos de Purple Team y ciudadanos preocupados por las estafas digitales.
Su flujo de trabajo típico es:
- Recibes una llamada, SMS o correo sospechoso.
- Abres la herramienta y añades el número, dominio, URL o email.
- La herramienta enriquece automáticamente los datos con:
- IP del servidor (resolución DNS)
- Registrador WHOIS y fecha de creación del dominio
- Servidores MX (para dominios y emails)
- Prefijo telefónico y localización aproximada
- Acumulas datos durante la semana (lunes a jueves).
- El viernes, generas un informe completo y un CSV exportable.
- Publicas el informe en GitHub, Telegram, o lo entregas a las autoridades (INCIBE, Fiscalía, AbuseIPDB, etc.).
- Repites el ciclo cada semana.
El script truecall_condor.py identifica automáticamente si el dato ingresado es:
- Número de teléfono (con o sin prefijo internacional)
- Dominio (ejemplo.com)
- URL completa (https://...)
- Correo electrónico
Para cada tipo de dato, se extrae información pública:
| Tipo de dato | Información extraída |
|---|---|
| Teléfono | Prefijo internacional, localización aproximada, tipo de línea (VoIP/Fijo) |
| Dominio/URL | IP del servidor, registrador WHOIS, fecha de creación, organización propietaria, servidores MX, nameservers |
| Dominio asociado y sus servidores MX |
Los datos se guardan en scam_db.json con un formato JSON indexado, permitiendo:
- Historial completo de todas las entradas
- Metadatos de fecha para análisis temporal
- Notas manuales para contexto adicional
El módulo generate_report.py lee la base de datos y crea:
reports/README.md: Un informe con estadísticas agregadas (TLD más usados, prefijos telefónicos más repetidos, IPs con mayor frecuencia, últimas 10 entradas)reports/scam_export.csv: Archivo CSV con columnas:Tipo,Entidad,Fecha,Notas,IP,Registrar. Diseñado para ser entregado a autoridades sin necesidad de procesamiento adicional.
La herramienta no sube nada automáticamente a ningún lado. Eso es una decisión tuya. El flujo manual es:
- Generas los informes en tu máquina local.
- Los copias a un USB, los subes a un hosting anónimo, los publicas en GitHub desde una máquina pública o los entregas en mano.
- Así proteges tu identidad y controlas qué datos se hacen públicos.
- Python 3.6 o superior
- Conexión a Internet (para consultas WHOIS y DNS)
pip install -r requirements.txtEl archivo requirements.txt incluye:
python-whois→ Para consultas WHOIS de dominios.dnspython→ Para resolución DNS y consulta de registros MX.requests→ Para futuras extensiones (ej. integración con APIs externas).
git clone https://github.com/Condor2026/TrueCall_Condor
cd TrueCall_Condor
pip install -r requirements.txtpython3 truecall_condor.pyEsto mostrará un menú con las siguientes opciones:
- Añadir número de teléfono → Introduce el número con o sin prefijo.
- Añadir dominio o URL → Introduce el dominio o la URL completa.
- Añadir email → Introduce el correo sospechoso.
- Ver últimas 10 entradas → Muestra los últimos datos añadidos.
- Generar informe completo → Crea
reports/README.mdyreports/scam_export.csv. - Exportar CSV para autoridades → Solo genera el CSV (útil si no quieres el informe Markdown).
- Acerca de / Explicación → Muestra esta información dentro de la herramienta.
- Salir
python3 truecall_condor.py "+34987790957" "Llamada silenciosa reportada en TrueCaller"Esto añade el número directamente con la nota especificada, sin pasar por el menú.
Si solo quieres regenerar el informe sin abrir el menú:
python3 generate_report.py| Archivo | Descripción |
|---|---|
scam_db.json |
Base de datos local con todas las entradas documentadas. No se debe subir a repositorios públicos por contener datos de investigación. |
reports/README.md |
Informe estadístico automático. Contiene: desglose por tipo de amenaza, TLDs más usados, prefijos telefónicos repetidos, IPs frecuentes y las últimas 10 entradas añadidas. |
reports/scam_export.csv |
CSV estructurado para entregar a las autoridades. Incluye todos los campos relevantes. |
-
Lunes: Recibes una llamada del número
+34 987 790 957. Abres TrueCall_Condor, opción[1], escribes+34987790957y añades la nota:"Llamada silenciosa, reportado en TrueCaller como estafa". -
Martes: Te llega un SMS con un enlace a
seguridad-falsa.top. Abres la herramienta, opción[2], escribesseguridad-falsa.topy añades la nota:"SMS phishing, simulan ser de mi banco". -
Miércoles: Recibes un correo de
soporte@bancoseguro-falso.com. Opción[3], escribessoporte@bancoseguro-falso.comy notas:"Phishing, piden actualizar datos". -
Jueves: Repites el proceso con 5 números más y 2 dominios.
-
Viernes por la tarde: Abres la herramienta, opción
[5](Generar informe completo). Se crean:reports/README.mdcon estadísticas de toda la semana.reports/scam_export.csvcon todos los datos estructurados.
-
Viernes noche: Subes los archivos a GitHub desde una máquina pública o con Tor. El informe queda disponible para otros investigadores.
-
Lunes siguiente: Repites el ciclo.
Esta herramienta se distribuye bajo la Licencia Pública General de GNU (GPLv3).
Su uso está destinado exclusivamente a:
- Investigación de seguridad
- Denuncia de actividades fraudulentas
- Educación y concienciación ciudadana
Queda terminantemente prohibido su uso para:
- Spam, acoso o ataques de cualquier tipo
- Actividades que vulneren la privacidad de personas físicas sin su consentimiento
- Cualquier fin que contravenga la legislación vigente
Todos los datos recopilados provienen de fuentes públicas (WHOIS, DNS, TrueCaller, reportes ciudadanos) y no implican acceso no autorizado a sistemas privados.
Las contribuciones al proyecto son bienvenidas. Áreas de mejora posibles:
- Integración con APIs externas: AbuseIPDB, VirusTotal, IPQualityScore
- Scraping automático de foros de denuncias o redes sociales
- Nuevos formatos de exportación: JSON, PDF, Excel
- Interfaz gráfica (GUI) opcional
- Soporte para múltiples idiomas
Para contribuir:
- Haz un fork del repositorio.
- Crea una rama con tu mejora:
git checkout -b feature/nueva-funcionalidad - Realiza tus cambios y haz commit:
git commit -m "Añadida funcionalidad X" - Sube tu rama:
git push origin feature/nueva-funcionalidad - Abre un Pull Request describiendo los cambios.
Este proyecto está licenciado bajo GPLv3.
Para más detalles, consulta el archivo LICENSE o visita:
https://www.gnu.org/licenses/gpl-3.0.html
"No ataco. Vigilo. Documento. Denuncio."
TrueCall_Condor nace de la necesidad de contar con herramientas éticas y accesibles para combatir el fraude digital sin caer en prácticas ilegales. Su desarrollo está guiado por los principios de:
- Transparencia: Código abierto, procesos claros.
- Colaboración: Cualquier persona puede contribuir.
- Responsabilidad: Uso ético y legal.
- Eficacia: Automatización de tareas repetitivas para centrarse en el análisis.
Si esta herramienta te ha ayudado a documentar estafas, proteger a otros o simplemente aprender, considera dejar una estrella ⭐ en GitHub.
Cada estrella me motiva a seguir mejorando la herramienta y a mantenerla actualizada.
Si conoces a alguien que pueda beneficiarse de TrueCall_Condor (investigadores, periodistas, víctimas de estafas), compártelo.
Juntos podemos hacer que las estafas sean más difíciles de ocultar.
"No ataco. Vigilo. Documento. Denuncio."
TrueCall_Condor es un proyecto vivo. Si tienes ideas, mejoras o encuentras algún fallo, abre un issue o haz un pull request.
Gracias por llegar hasta aquí. 🚀
Desarrollado con ❤️ y café por Condor2026
