**🎮主菜单结构**
当你运行 `python3 truecall_condor.py` 时，你将看到一个包含以下选项的交互式菜单：
```
┌─────────────────────────────────────────────────────┐
│ 🎯 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 │
└─────────────────────────────────────────────────────┘
```
### 每个选项的说明：
| 选项 | 功能 | 具体作用是什么？ |
|--------|---------|------------------------|
| **[1]** | 添加电话号码 | 提示你输入一个号码（例如：+34987790957），并保存其前缀和大概位置。 |
| **[2]** | 添加域名或 URL | 提示你输入一个域名（例如：seguridad-falsa.top）或完整的 URL，并提取 IP、WHOIS 和 MX。 |
| **[3]** | 添加电子邮件 | 提示你输入一个电子邮件（例如：soporte@falso.com），并分析其域名和 MX 服务器。 |
| **[4]** | 查看最近 10 条记录 | 显示最近添加的 10 条数据，包括其类型、日期和备注。 |
| **[5]** | 生成完整报告 | 创建 `reports/README.md`（统计数据）和 `reports/scam_export.csv`（提供给当局的 CSV）。 |
| **[6]** | 为当局导出 CSV | 仅生成 CSV（如果你不需要 Markdown 报告，这会很有用）。 |
| **[7]** | 关于 / 说明 | 显示有关该工具的信息、其理念和实用命令。 |
| **[8]** | 退出 | 关闭该工具。 |
```
---
**Ahora sí, ya tienes el menú explicado en el README.** ¿Falta algo más o ya estamos listos, jefe? 🦅
# 🦅 TrueCall_Condor
**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.
---
## 📌 这款工具到底能做什么？
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:
1. **Recibes una llamada, SMS o correo** sospechoso.
2. **Abres la herramienta** y añades el número, dominio, URL o email.
3. **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
4. **Acumulas datos durante la semana** (lunes a jueves).
5. **El viernes**, generas un informe completo y un CSV exportable.
6. **Publicas el informe en GitHub, Telegram, o lo entregas a las autoridades** (INCIBE, Fiscalía, AbuseIPDB, etc.).
7. **Repites el ciclo** cada semana.
---
## 🧠 它的内部是如何工作的？
### 1. 智能类型检测
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**
### 2. 自动丰富（无需人工干预）
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 |
| **Email** | Dominio asociado y sus servidores MX |
### 3. 结构化存储
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
### 4. 报告生成
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.
### 5. 手动流程（你的机器不连接互联网）
La herramienta **no sube nada automáticamente a ningún lado**. Eso es una decisión tuya. El flujo manual es:
1. Generas los informes en tu máquina local.
2. 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.
3. 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)
### 依赖项
```bash
pip install -r requirements.txt
```
`requirements.txt` 文件包含：
- `python-whois` → 用于域名的 WHOIS 查询。
- `dnspython` → 用于 DNS 解析和查询 MX 记录。
- `requests` → 用于未来的扩展（例如：与外部 API 的集成）。
### 从 GitHub 安装（可选）
```
git clone https://github.com/Condor2026/TrueCall_Condor
cd TrueCall_Condor
pip install -r requirements.txt
```
## 🚀 完整用法
### 交互模式（日常使用推荐）
```
python3 truecall_condor.py
```
这将显示一个包含以下选项的菜单：
1. **添加电话号码** → 输入带或不带前缀的号码。
2. **添加域名或 URL** → 输入域名或完整的 URL。
3. **添加电子邮件** → 输入可疑的电子邮件。
4. **查看最近 10 条记录** → 显示最近添加的数据。
5. **生成完整报告** → 创建 `reports/README.md` 和 `reports/scam_export.csv`。
6. **为当局导出 CSV** → 仅生成 CSV（如果你不需要 Markdown 报告，这会很有用）。
7. **关于 / 说明** → 在工具内显示此信息。
8. **退出**
### 快速模式（用于自动化或脚本）
```
python3 truecall_condor.py "+34987790957" "Llamada silenciosa reportada en TrueCaller"
```
这将直接添加带有指定备注的号码，无需经过菜单。
### 手动生成报告
如果你只想重新生成报告而不想打开菜单：
```
python3 generate_report.py
```
## 📂 生成的文件结构
| 文件 | 描述 |
|---------|-------------|
| `scam_db.json` | 包含所有记录条目的本地数据库。**切勿上传至公开仓库**，因为其中包含调查数据。 |
| `reports/README.md` | 自动生成的统计报告。包含：威胁类型细分、最常用的 TLD、重复出现的电话前缀、频繁出现的 IP 以及最近添加的 10 条记录。 |
| `reports/scam_export.csv` | 结构化的 CSV，用于提交给当局。包含所有相关字段。 |
## 📘 实际使用示例（每周流程）
1. **星期一：** 你接到一个来自号码 `+34 987 790 957` 的电话。你打开 TrueCall_Condor，选择选项 `[1]`，输入 `+34987790957` 并添加备注：`"无声来电，在 TrueCaller 上被举报为诈骗"`。
2. **星期二：** 你收到一条包含 `seguridad-falsa.top` 链接的短信。你打开该工具，选择选项 `[2]`，输入 `seguridad-falsa.top` 并添加备注：`"短信网络钓鱼，他们伪装成我的银行"`。
3. **星期三：** 你收到一封来自 `soporte@bancoseguro-falso.com` 的邮件。选择选项 `[3]`，输入 `soporte@bancoseguro-falso.com` 并添加备注：`"网络钓鱼，要求更新数据"`。
4. **星期四：** 你再对 5 个号码和 2 个域名重复此过程。
5. **星期五下午：** 你打开该工具，选择选项 `[5]`（生成完整报告）。系统将创建：
- `reports/README.md`，包含全周的统计数据。
- `reports/scam_export.csv`，包含所有结构化数据。
6. **星期五晚上：** 你从公共计算机或使用 Tor 将文件上传到 GitHub。该报告即可供其他研究人员使用。
7. **下个星期一：** 你重复此循环。
## ⚖️ 法律与道德声明
**本工具基于 GNU 通用公共许可证 (GPLv3) 分发。**
其用途仅限于：
- **安全调查**
- **举报欺诈活动**
- **公民教育和意识提升**
**严禁**将其用于：
- 垃圾信息、骚扰或任何形式的攻击
- 未经同意侵犯自然人隐私的活动
- 任何违反现行立法的目的
收集的所有数据均来自**公开来源**（WHOIS、DNS、TrueCaller、公民报告），不涉及对私有系统的未授权访问。
## 📜 许可证
本项目基于 **GPLv3** 授权。
有关更多详细信息，请查阅 `LICENSE` 文件或访问：
[https://www.gnu.org/licenses/gpl-3.0.html](https://www.gnu.org/licenses/gpl-3.0.html)
## 📌 项目理念
TrueCall_Condor 诞生于对符合道德规范且易于获取的工具的需求，旨在打击数字欺诈而不陷入非法行为。其开发遵循以下原则：
- **透明度**：开源代码，流程清晰。
- **协作**：任何人都可以做出贡献。
- **责任心**：符合道德和合法的使用。
- **高效**：自动化重复性任务，专注于分析。
## 🦅 结语
**TrueCall_Condor** 是一个持续发展的项目。如果你有任何想法、改进建议或发现任何错误，**请提交一个 issue 或发起一个 pull request**。
感谢您的阅读。 🚀
**由 [Condor2026](https://github.com/Condor2026) 用 ❤️ 和咖啡开发**
[](https://github.com/Condor2026/TrueCall_Condor/stargazers)
[](https://github.com/Condor2026/TrueCall_Condor/network/members)
[](https://github.com/Condor2026/TrueCall_Condor/watchers)