Skip to content
SirAntuansPublic

About

Escáner de dispositivos en red local. Detección vía ARP scan y ping sweep, identificación de fabricante por MAC (OUI IEEE), resolución de hostname y modo pasivo de escucha. Exportación a JSON/CSV. CLI sencilla + librería.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

25 Commits

Folders and files

Repository files navigation

APSoft (APNetScan)

Escáner de dispositivos en red local escrito en Python.

Características

  • Detección de hosts mediante ARP scan (scapy) con fallback a ping sweep.
  • Identificación de fabricante a partir de la dirección MAC (OUI de IEEE).
  • Detección de hostname por DNS reverso.
  • Modo pasivo: escucha ARP en la red sin enviar tráfico (requiere root).
  • Exportación de resultados a JSON y CSV.
  • CLI sencilla con argparse; también usable como librería Python.

Instalación

pip install .

Con el backend ARP (recomendado):

pip install .[arp]

Uso

# Escanear la red a la que pertenece una IP (auto-detecta interfaz y CIDR)
apnetscan --target 192.168.1.1

# Escanear un rango CIDR concreto
apnetscan --target 192.168.1.0/24

# Escanear varias redes
apnetscan --target 192.168.1.0/24 10.0.0.0/24

# Solo ping sweep (sin scapy)
apnetscan --target 192.168.1.0/24 --method ping

# Modo pasivo (escucha ARP durante 60 s, requiere root)
apnetscan --passive --duration 60

# Exportar resultados
apnetscan --target 192.168.1.0/24 --json out.json --csv out.csv

Salida de ejemplo:

IP                MAC                FABRICANTE              HOSTNAME
192.168.1.1       aa:bb:cc:dd:ee:ff  Vendor Name             router.local
192.168.1.10      11:22:33:44:55:66  Other Vendor             laptop.local

Como librería

from apnetscan import Scanner

scanner = Scanner(method="arp")
results = scanner.scan("192.168.1.0/24")
for host in results:
    print(host.ip, host.mac, host.vendor)

Requisitos

  • Python 3.9+
  • El escaneo ARP y el modo pasivo requieren privilegios de root/administrador (acceso a sockets raw).

Aviso legal

Usa APNetScan únicamente en redes propias o para las que tengas autorización. Escanear redes de terceros sin permiso puede ser ilegal.

Novedades v0.3.0

  • Estimación de SO por TTL (Windows / Linux-Unix-macOS / IoT) en cada host detectado.
  • Inventario persistente (scan --save) en ~/.apnetscan/inventory.json con comparación de deltas (scan --diff): dispositivos nuevos (+), desaparecidos (-) y modificados (~) en MAC o hostname.
  • Modo watch (apnetscan watch -t 192.168.1.0/24 --interval 30): re-escanea periódicamente y refresca la lista de dispositivos.

v1.0.0 — APSoft

  • Rebrand de la app compilada a APSoft: nuevo comando apsoft (se mantiene apnetscan como alias) y banner ASCII con el título APSoft.
  • Salida gráfica tipo panel: tabla con bordes box-drawing (┌─┬─┐) y colores ANSI que se desactivan automáticamente en pipes/CI para máxima estabilidad.

v1.1.0 — Rangos de puertos y panel TUI

  • Escaneo de rangos de puertos: --port-range 1-1024, --port-range 80 o --port-range 20-25,80,443 en scan, watch y tui.
  • Panel TUI interactivo (apsoft tui, requiere pip install apnetscan[tui]): tabla viva con navegación ↑/↓, r para refrescar, w para enviar WOL al dispositivo seleccionado y q para salir. Se re-escanea automáticamente cada --interval segundos.

v1.4.0 — Menú gráfico al abrir la app

  • Al ejecutar apnetscan (sin subcomando) se abre un menú interactivo con banner APSoft y panel de opciones: escanear red, puertos comunes, rango de puertos, WOL, panel TUI, guardar/comparar inventario y modo pasivo.
  • Renderizado con rich (paneles redondeados, colores); fallback automático a texto plano si rich no está instalado.
  • Los subcomandos directos (apnetscan scan ...) siguen funcionando igual.

v1.5.0 — MACs sin scapy y detección mejorada

  • MAC + fabricante en el backend ping: tras el ping sweep se lee la tabla ARP del sistema (ip neigh / arp -a, multiplataforma), que el propio ping acaba de poblar. Ya no se necesita scapy ni root para obtener MACs.
  • Menú: la opción "Escanear red" pregunta si comprobar puertos comunes.
  • TTL 254 reinterpretado como "router/IoT (TTL alto)" (etiqueta más precisa).

v1.8.0 — Diagnóstico de tarjetas de red

  • Nuevo comando diag (opción 9 del menú): estado de los adaptadores (up/down/IP), dispositivos de red con error del Administrador de dispositivos de Windows (WMI ConfigManagerErrorCode, con descripción legible del problema) y avisos (adaptador activo sin IP, etc.).
  • Limpiezas: flush de caché DNS y tabla ARP en Windows/Linux/macOS, y --winsock-reset opcional en Windows (requiere admin y reinicio).
  • Multiplataforma: en Windows usa netsh/ipconfig/PowerShell, en Linux ip y en macOS ifconfig.

About

Escáner de dispositivos en red local. Detección vía ARP scan y ping sweep, identificación de fabricante por MAC (OUI IEEE), resolución de hostname y modo pasivo de escucha. Exportación a JSON/CSV. CLI sencilla + librería.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages