FIRERPA Android ｜ Automatización impulsada por IA

Un framework de automatización Android todo en uno que combina servicios en el dispositivo, agentes listos para IA e invocación extensible de herramientas.

Documentación | 使用文档 | TELEGRAM | Grupo QQ | SKILLS | llms-full.txt | 中文版本

FIRERPA es una plataforma todo en uno de control de dispositivos Android. El servidor se ejecuta directamente en el dispositivo sin dependencias de ejecución adicionales; admite múltiples generaciones de Android y funciona con o sin root. En el lado del PC, la librería cliente de Python orquesta automatización de UI, operaciones remotas, captura de tráfico, ingeniería inversa basada en Hook, proxy de red, redes distribuidas, agentes de IA y MCP a través de un único servicio y API. En comparación con unir Appium, mitmproxy, frida-server, adb, uiautomator2 y scripts y herramientas de operaciones ad-hoc, FIRERPA ofrece una única fuente de capacidades, configuración unificada, flujos de trabajo conectados y una pila construida para uso de producción multidispositivo y de larga duración.

Escritorio remoto y transmisión en vivo

FIRERPA proporciona un escritorio remoto basado en navegador: ve y controla el dispositivo en tiempo real sin instalar un cliente de PC dedicado, por LAN o a través de redes. La transmisión admite tanto MJPEG como H.264, con backends de codificación por software y hardware. La tasa de cuadros (hasta 60fps), la escala de resolución, el bitrate y la calidad se pueden ajustar según la capacidad del dispositivo y las condiciones de la red—reduciendo el ancho de banda y mejorando la fluidez en enlaces débiles. También se admite WebRTC, con servidores STUN/TURN configurables para un mejor cruce de NAT y menor latencia de extremo a extremo en configuraciones públicas o entre regiones.

El escritorio remoto admite acceso concurrente para múltiples usuarios para depuración colaborativa, demostraciones y formación. Se incluyen portapapeles bidireccional compartido y audio en vivo (Android 10+), junto con una terminal integrada, carga por arrastrar y soltar, y navegación y descarga de archivos desde el navegador—todo a través de un único puerto. La inspección visual de diseño integrada resalta los elementos, admite navegación con Tab, muestra coordenadas y valores RGB, y exporta el árbol de diseño XML para que puedas validar selectores y lógica de automatización en la misma interfaz, acortando el ciclo de la pantalla al script.

El escritorio remoto y RPC admiten TLS de extremo a extremo y control de acceso mediante certificados de servicio, con contraseñas de inicio de sesión del WebUI opcionales para reducir la exposición en redes públicas. Las capacidades del escritorio remoto también se pueden integrar en tus propias aplicaciones web a través de WebSocket (video en vivo, táctil, terminal, teclas, etc.), con allow_origin para integración entre orígenes—adecuado para productizar el control de dispositivos reales.

Automatización de UI

FIRERPA proporciona un sistema de automatización completo basado en selectores: texto, resourceId, descripción, scrollable y otros matchers comunes, además de encadenamiento hijo / hermano para elementos duplicados, jerarquías profundas o controles sin atributos distintivos. A nivel de elemento: capturas de pantalla, espera de aparición/desaparición, coordenadas de esquinas/centro, comprobaciones de existencia, entrada Unicode, deslizamientos escalonados, scroll por fling, desplazamiento hasta el final y más. Puede coexistir con otros servicios de accesibilidad en Android 8.0+ y mejora el descubrimiento de nodos WebView para aplicaciones híbridas.

El UI Watcher escucha los cambios de UI en tiempo real y ejecuta clics, eventos de teclado o contadores cuando coinciden las condiciones—útil para descartar automáticamente acuerdos, avisos de actualización, anuncios y otras interrupciones. Se admiten múltiples condiciones de selector y habilitación/deshabilitación por evento; las pantallas transitorias se pueden contar.

Virtual Display es un diferenciador: crea pantallas de fondo aisladas en el dispositivo y ejecuta aplicaciones y automatización allí sin afectar a la pantalla principal—por ejemplo, respuesta automática en una pantalla virtual mientras usas el teléfono con normalidad. La API de pantalla virtual espejo de la API principal del dispositivo (d.xxx → vd.xxx); los Watchers se pueden limitar a una pantalla virtual. El WebUI admite vista de múltiples pantallas y cambio entre ellas en el escritorio remoto—ideal para tareas en segundo plano, trabajo paralelo y automatización con humano en el bucle combinada con máquinas.

Para escenas sin un árbol de vistas estándar (juegos, UI dibujada a medida), FIRERPA ofrece OCR y emparejamiento de imágenes. El OCR admite paddleocr, easyocr y backends HTTP personalizados; en clústeres, el reconocimiento puede ejecutarse de forma centralizada en lugar de cargar modelos en cada PC, con aceleración por GPU y emparejamiento flexible de texto. El emparejamiento de imágenes se ejecuta en el dispositivo (plantilla o SIFT), sin consumir recursos del PC; SIFT es robusto a la rotación, la escala y la iluminación. Multi-touch admite grabación, reproducción, construcción programática y persistencia binaria para gestos complejos y presión.

Arquitectónicamente, FIRERPA usa un modelo cliente/servidor—mejor para programación centralizada, control de versiones y gestión de flotas que los ejecutores de scripts en el dispositivo como AutoJS; más ligero que Appium; más estable que uiautomator2 en escenarios multidispositivo. La documentación lo posiciona como un superconjunto funcional de las pilas comunes de automatización de Android—automatización, captura, Hook y operaciones se pueden encadenar en código en una sola plataforma sin cambiar de herramienta.

Captura de paquetes y MITM

FIRERPA ofrece captura MITM con un solo clic: instalación automática de la CA raíz del sistema, configuración del proxy, gestión de las diferencias entre versiones de Android y restauración automática de la red al salir—sin alternar certificados o proxies manualmente. Se admiten captura global, captura por paquete, edición en vivo de solicitudes/respuestas, mitmweb compartido y proxy HTTP ascendente para tráfico internacional. El degradado de QUIC integrado reduce la interferencia de QUIC. La captura sigue funcionando cuando el PC y el dispositivo solo comparten un único puerto FIRERPA (por ejemplo, conexión ADB o reenvío frp).

Más allá de los scripts de un solo clic, MITM es completamente impulsado por API: instalar/desinstalar CA del sistema compatibles con mitmproxy, Fiddler, Charles, etc.; integrar la captura en pipelines de automatización junto con pasos de UI y hooks de Frida. Hay un startmitm.exe para Windows disponible sin instalación de Python.

Red, proxy y conectividad

En el dispositivo, FIRERPA proporciona soporte completo de proxy: HTTP / HTTPS / SOCKS5 / Shadowsocks (múltiples cifrados), proxy por aplicación (incluidos clones multiusuario), proxy DNS, proxy UDP, bypass de LAN, coexistencia con OpenVPN y auto-conexión a los proxies configurados al iniciar. Los proxies admiten IPv6 y UDP para redes complejas.

Proxy de puente HTTP del dispositivo (tunnel2) proporciona capacidad de proxy inverso: apunta el proxy HTTP de tu PC o navegador al teléfono y el tráfico se reenvía a través de la salida de red del teléfono; la IP de salida coincide con la del teléfono. Se puede elegir Wi‑Fi o celular (rmnet) como interfaz de salida—útil para depuración conjunta, aplicaciones internacionales y pools de IP multidispositivo.

Un cliente OpenVPN integrado admite certificado, nombre de usuario/contraseña y autenticación mixta, junto con proxy del sistema; una imagen Docker de OpenVPN y generadores de configuración producen código del lado del dispositivo y ajustes de inicio automático. Un cliente frp integrado reenvía los servicios del dispositivo a un servidor público a través de fwd.*, con cifrado y TLS.

El descubrimiento mDNS permite el acceso a {device_id}.local al escritorio remoto y otros servicios, con metadatos TXT opcionales (modelo, ABI, ID de dispositivo) para el descubrimiento de flotas en LAN.

Frida e ingeniería inversa

FIRERPA incluye el último Frida—sin frida-server separado. Usa las herramientas de frida desde la terminal del escritorio remoto sin -U, -H, etc. Los parches de ocultación integrados (código abierto más internos) se mantienen contra la detección; las conexiones usan autenticación por token a través del puerto FIRERPA. Los parches de objection y los helpers de java-bridge de Frida 17.x facilitan la migración.

Scripts persistentes de Frida se reinyectan tras el cierre o bloqueo de la aplicación; persistencia offline YAML con vigilancia de directorio y recarga en caliente. RPC de Frida se asigna a métodos de Python y llamadas remotas HTTP + JSON-RPC 2.0 en hilos JVM, de UI principal o JS puros. Los datos emit del script pueden ir a HTTP / Redis / RabbitMQ (MQTT) con metadatos del dispositivo/aplicación, compresión zlib, reintentos HTTP y TLS de MQTT.

ADB, SSH y terminal integrada

FIRERPA incluye un ADB integrado independiente—ADB inalámbrico de alto privilegio sin activar las Opciones de desarrollador del sistema, útil cuando las aplicaciones detectan el modo desarrollador. Los módulos de Magisk pueden preinstalar adb_keys para autorización predeterminada. SSH integrado más ssh.sh / scp.sh para shell remoto y transferencia de archivos.

La terminal integrada incluye strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper y pilas de Python como Crypto, cv2, unicorn, capstone, keystone, redis y grpc. sqlite3 admite wxsqlite / sqlcipher / sqlcrypto para leer bases de datos cifradas de aplicaciones como WeChat, WeCom y clientes de la familia Alibaba. Un solo entorno entre escritorio remoto, SSH y ADB—analiza y controla en el dispositivo con menos traslado al PC.

Gestión distribuida y multidispositivo

FIRERPA StarLink Platform (Hub + hub-bridge) proporciona acceso centralizado multidispositivo para dispositivos locales y remotos con gestión unificada y acceso P2P—ideal para «dispositivo en casa, operador en otro lugar» y colaboración multidispositivo. hub v3 usa SAPI para solicitudes unificadas a dispositivos locales y remotos. Además de Hub, también se admiten reenvío frp y malla OpenVPN como opciones auto-alojadas, con documentación completa y soporte Docker.

Desde 9.0, se admiten la conectividad entre pares P2P Bridge y un sistema de tareas distribuidas integrado; desde 7.50, está disponible un servicio de suscripción de red para que no tengas que auto-alojar frp/OpenVPN. Diseñado para pools de teléfonos en la nube, granjas de dispositivos y clústeres de emuladores—dispositivos por lotes, siempre activos, operación sin supervisión.

IA / MCP / Agente

FIRERPA incluye un servidor MCP (/mcp/) en streamable-http, con llamadas a herramientas, lecturas de recursos, prompts, notificaciones de progreso y registros—compatible con Claude, Cursor y otros clientes MCP. Las extensiones MCP oficiales viven en ~/modules/extension.

El comando agent integrado impulsa el dispositivo en lenguaje natural a través de cualquier API compatible con OpenAI con llamadas a herramientas, incluido el modo visión, además de un ejecutor de tareas semánticas OpenAI. Combínalo con crontab para tareas de IA programadas en dispositivos reales.

Control del sistema y extensiones

Más de 160 APIs de Python cubren operaciones de aplicaciones, E/S de archivos, ejecución de comandos, estado del dispositivo, WiFi, proxy, OpenVPN, apagado/reinicio, registros de servicios y más. setprop puede escribir propiedades de solo lectura ro.*; las APIs de Settings ajustan el brillo, el modo desarrollador, etc.; SELinux: creación de dominios, modo permisivo y permitir/denegar de grano fino. APIs completas de aplicaciones con múltiples instancias, concesión/revocación silenciosa de permisos, lanzamiento de actividades no exportadas y deshabilitación de aplicaciones para ahorrar recursos.

Parcheo binario (comodines hex, rutas glob, dryrun) y métricas de ejecución para disco, batería, CPU, memoria y E/S de red. Reproducción de WAV y APIs de almacenamiento interno. tflite-runtime en el dispositivo con cómputo acelerado por hardware para inferencia en el borde.

Un entorno virtual Debian ejecuta Debian completo con apt—compila BPF, despliega OpenSSH, instala dependencias arbitrarias de Python más allá de los límites de la terminal integrada.

Despliegue, seguridad y gobernanza

Despliega mediante APP de un solo clic (root o Shizuku), módulo Magisk con inicio automático, extracción manual o integración en ROM—diseñado para funcionamiento 24/7. La APP puede generar automáticamente certificados de servicio; los zips de Magisk pueden incluir propiedades, lamda.pem y adb_keys. Configuración de servicio INI centraliza puerto, WebUI, certificados, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns, etc.; el WebUI ofrece edición visual, texto sin formato y Recargar servicio, además de carga de archivos de configuración remotos.

Identidades de root y shell; arm64, armeabi-v7a, x86, x86_64; dispositivos reales, emuladores (LDPlayer, Nox, etc.), Redroid, WSA, AVD, teléfonos en la nube. Rutas de desinstalación limpias. Bloqueo exclusivo de API evita la contención entre clientes. Política de privacidad: no se recopilan contactos, SMS, ubicación, etc.; licenciamiento offline admitido.

Herramientas y evolución

Más de seis años de desarrollo continuo, con correcciones de compatibilidad para Android 14–16 y trabajo continuo en escritorio remoto multiusuario, APIs de táctil estandarizadas, MCP, versiones y sigilo de Frida, proxy IPv6/UDP, P2P Bridge y tareas distribuidas.

La fortaleza de FIRERPA no es ninguna característica individual, sino la integración de escritorio remoto (WebRTC/H.264/multiusuario), automatización de UI (pantalla virtual, Watcher, OCR, emparejamiento de imágenes, multi-touch), captura con un solo clic, Frida integrado, proxy de pila completa y VPN/frp/P2P, ADB/SSH/terminal integrada, MCP/Agente de IA, control a nivel de sistema, Debian virtual, KV persistente y cifrado de scripts en un solo dispositivo Android, un solo servicio y un solo cliente de Python—para que las pruebas de seguridad, el análisis de cumplimiento, la recuperación de protocolos, la gestión de flotas y la automatización se ejecuten en un solo pipeline en lugar de muchas herramientas pegadas.