# /filescan


> Escanea archivos y URLs con VirusTotal.


- URL: https://nearsecurity.citymoon.org/docs/comandos/utilidades/filescan
- Sección: Comandos de servidor y utilidades
- Idioma: Español
- Comando: `/filescan`
- Palabras clave: filescan, utilidades, filescan, virustotal, malware, archivo, url

Permite analizar un adjunto o una URL. El resultado se muestra en un panel con los motores que detectaron amenazas.


La API key de VirusTotal es global del despliegue: se configura una vez en el host del bot con `/filescan config` y se reutiliza en todos los servidores. El archivo adjunto puede pesar hasta 32 MB.


> **Permisos**
> Requiere `Gestionar mensajes` para configurar y ejecutar escaneos.


### Subcomandos


| Subcomando | Qué hace |
| --- | --- |
| [/filescan config](#cmd-filescan-config) | Configura la API key de VirusTotal |
| [/filescan scan](#cmd-filescan-scan) | Escanea un archivo adjunto |
| [/filescan scanurl](#cmd-filescan-scanurl) | Escanea un archivo desde una URL |


#### /filescan config


Configura la API key de VirusTotal


Guarda la API key global de VirusTotal en el host del bot. No es una clave por servidor: se usa en todos los escaneos posteriores del despliegue.


```
/filescan config <apikey>
```


| Opción | Tipo | Obligatoria | Descripción |
| --- | --- | --- | --- |
| apikey | Texto | Sí | Tu API key de VirusTotal |


> **Permisos**
> Requiere `Gestionar mensajes`.


> **Cuidado**
> - La API key es un secreto y se guarda en el servidor donde corre el bot. No la compartas en canales públicos.


#### /filescan scan


Escanea un archivo adjunto


Analiza un archivo adjunto con VirusTotal y muestra el resultado de los motores.


```
/filescan scan <archivo>
```


| Opción | Tipo | Obligatoria | Descripción |
| --- | --- | --- | --- |
| archivo | Archivo | Sí | El archivo que quieres escanear |


> **Permisos**
> Requiere `Gestionar mensajes`.


#### /filescan scanurl


Escanea un archivo desde una URL


Analiza una URL con VirusTotal. La URL se envía al servicio externo.


```
/filescan scanurl <url>
```


| Opción | Tipo | Obligatoria | Descripción |
| --- | --- | --- | --- |
| url | Texto | Sí | URL del archivo a escanear |


> **Permisos**
> Requiere `Gestionar mensajes`.


### Notas


- El archivo o la URL se envía a VirusTotal, un servicio externo. No escanees documentos privados sin autorización.


### Ejemplo


```
/filescan
```


> **Sigue leyendo**
> - [Guía relacionada](https://nearsecurity.citymoon.org/docs/utilidades/servidor.md)
> - [Índice completo de comandos](https://nearsecurity.citymoon.org/docs/referencia/comandos.md)
