# xkatooo/phonescan architecture

> Architecture diagram of the GitHub repository xkatooo/phonescan, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xkatooo/phonescan
- Repository: https://github.com/xkatooo/phonescan

## Overview

PhoneScan es una herramienta de consola para consultar datos de un teléfono y generar búsquedas de posibles perfiles sociales. El usuario introduce el número; el programa lo limpia y valida su longitud, consulta un servicio externo de validación telefónica y muestra sus datos. Después genera enlaces de búsqueda para que el usuario investigue manualmente. La secuencia se apoya en las llamadas visibles; los enlaces sociales se imprimen, no se consultan automáticamente.

Main entry points: [`src/proceso/motor/scrapeo.py`](https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/scrapeo.py) (Consultar y mostrar datos), [`src/index.py`](https://github.com/xkatooo/phonescan/blob/master/src/index.py) (Punto de entrada), [`src/proceso/get.py`](https://github.com/xkatooo/phonescan/blob/master/src/proceso/get.py) (Entrada telefónica), [`run.py`](https://github.com/xkatooo/phonescan/blob/master/run.py) (Lanzador)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["Interfaz de consola"]
  node_launcher["Lanzador<br/>[run.py]"]
  node_entry["Punto de entrada<br/>[index.py]"]
  node_banner["Banner<br/>[Kato.py]"]
  node_input["Entrada telefónica<br/>[get.py]"]
end

subgraph group_normalization["Preparación del número"]
  node_normalize["Limpiar y validar<br/>[busquedas.py]"]
end

subgraph group_lookup["Consulta telefónica"]
  node_lookup["Consultar y mostrar datos<br/>[scrapeo.py]"]
  node_phone_api["API de validación"]
end

subgraph group_discovery["Búsqueda social"]
  node_dorks["Generar enlaces sociales<br/>[dorkeo.py]"]
end

node_user(("Usuario"))

node_user -->|"inicia"| node_launcher
node_launcher -->|"ejecuta"| node_entry
node_user -.->|"ejecuta directamente"| node_entry
node_entry -->|"muestra"| node_banner
node_entry -->|"carga"| node_input
node_input -->|"solicita número"| node_user
node_user -->|"introduce número"| node_input
node_input -->|"envía número"| node_normalize
node_normalize -->|"llama"| node_lookup
node_lookup -->|"consulta"| node_phone_api
node_lookup -->|"llama"| node_dorks
node_lookup -->|"muestra datos"| node_user
node_dorks -->|"imprime enlaces"| node_user

click node_launcher "https://github.com/xkatooo/phonescan/blob/master/run.py"
click node_entry "https://github.com/xkatooo/phonescan/blob/master/src/index.py"
click node_banner "https://github.com/xkatooo/phonescan/blob/master/src/proceso/estetica/Kato.py"
click node_input "https://github.com/xkatooo/phonescan/blob/master/src/proceso/get.py"
click node_normalize "https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/busquedas.py"
click node_lookup "https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/scrapeo.py"
click node_dorks "https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/dorkeo.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_launcher,node_entry,node_banner,node_input toneBlue
class node_normalize toneAmber
class node_lookup,node_phone_api toneMint
class node_dorks toneRose
class node_user toneIndigo
```

## Components

### Interfaz de consola

- [Lanzador](https://github.com/xkatooo/phonescan/blob/master/run.py): `run.py`
- [Punto de entrada](https://github.com/xkatooo/phonescan/blob/master/src/index.py): `src/index.py`
- [Banner](https://github.com/xkatooo/phonescan/blob/master/src/proceso/estetica/Kato.py): `src/proceso/estetica/Kato.py`
- [Entrada telefónica](https://github.com/xkatooo/phonescan/blob/master/src/proceso/get.py): `src/proceso/get.py`

### Preparación del número

- [Limpiar y validar](https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/busquedas.py): `src/proceso/motor/busquedas.py`

### Consulta telefónica

- [Consultar y mostrar datos](https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/scrapeo.py): `src/proceso/motor/scrapeo.py`
- **API de validación**

### Búsqueda social

- [Generar enlaces sociales](https://github.com/xkatooo/phonescan/blob/master/src/proceso/motor/dorkeo.py): `src/proceso/motor/dorkeo.py`

### Other components

- **Usuario**

## Connections

- Usuario → Lanzador: inicia
- Lanzador → Punto de entrada: ejecuta
- Usuario → Punto de entrada: ejecuta directamente
- Punto de entrada → Banner: muestra
- Punto de entrada → Entrada telefónica: carga
- Entrada telefónica → Usuario: solicita número
- Usuario → Entrada telefónica: introduce número
- Entrada telefónica → Limpiar y validar: envía número
- Limpiar y validar → Consultar y mostrar datos: llama
- Consultar y mostrar datos → API de validación: consulta
- Consultar y mostrar datos → Generar enlaces sociales: llama
- Consultar y mostrar datos → Usuario: muestra datos
- Generar enlaces sociales → Usuario: imprime enlaces