Ingeniería inversa de Android y extracción de API — Habilidad de Claude Code

Una habilidad de Claude Code que descompila archivos APK/XAPK/JAR/AAR de Android y extrae las API HTTP utilizadas por la aplicación — endpoints de Retrofit, llamadas de OkHttp, URLs codificadas, patrones de autenticación — para que puedas documentarlas y reproducirlas sin el código fuente original.

Soporte de primera clase para Kotlin: las aplicaciones modernas de Android son Kotlin/KMP, fuertemente ofuscadas con R8. Esta habilidad recupera los nombres de clase originales de Kotlin a partir de metadatos que R8 no puede eliminar, y extrae API de Ktor, Apollo (GraphQL) y Koin — no solo del clásico stack Retrofit/OkHttp. Consulta Recuperación de nombres de Kotlin más abajo.

Soporte para Windows / PowerShell (experimental): Los scripts *.ps1 junto a los de bash son una contribución reciente de la comunidad, aún en proceso de estabilización. Para cualquier problema, por favor abre un issue en este repositorio (no en los forks upstream de los contribuyentes): los scripts de PowerShell son mantenidos aquí por @SimoneAvogadro.

Tabla de contenidos

• Qué hace
• Requisitos
• Instalación
• Uso
• Estructura del repositorio
• Referencias
• Agradecimientos
• Descargo de responsabilidad
• Licencia

Qué hace

Capacidad	Descripción
Huella primero (Fase 0)	Clasifica un APK/XAPK en segundos — detecta el framework (Flutter / React Native / Cordova / Xamarin / Kotlin nativo), el stack HTTP, el nivel de ofuscación y las librerías nativas antes de dedicar tiempo a una descompilación completa
Descompilar	Archivos APK, XAPK, JAR y AAR usando jadx y Fernflower/Vineflower (motor único o comparación lado a lado)
Recuperar nombres de Kotlin	Reconstruye los nombres de clase originales *Repository / *ViewModel / *UseCase a partir de binarios ofuscados con R8 usando metadatos de Kotlin que R8 no puede eliminar
Extraer API	Retrofit, OkHttp, Volley y stacks modernos de Kotlin/KMP: Ktor, Apollo (GraphQL), Koin DI — endpoints, URLs codificadas, cabeceras de autenticación, tokens y esquemas de firma de peticiones HMAC
Rastrear flujos de llamadas	Desde Activities/Fragments a través de ViewModels y repositorios hasta las llamadas HTTP
Analizar estructura	Manifest, paquetes, patrones de arquitectura
Manejar ofuscación	Extracción de rutas/URLs resistente a R8 más estrategias para navegar la salida de ProGuard/R8

Requisitos

Requerido:

• Java JDK 17+
• jadx (CLI)

Opcional (recomendado):

• Vineflower o Fernflower — mejor salida en código Java complejo
• dex2jar — necesario para usar Fernflower en archivos APK/DEX

Consulta plugins/android-reverse-engineering/skills/android-reverse-engineering/references/setup-guide.md para instrucciones detalladas de instalación.

Instalación

Desde GitHub (recomendado)

Dentro de Claude Code, ejecuta:

/plugin marketplace add SimoneAvogadro/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

La habilidad estará disponible permanentemente en todas las sesiones futuras.

Desde un clon local

git clone https://github.com/SimoneAvogadro/android-reverse-engineering-skill.git

Luego en Claude Code:

/plugin marketplace add /path/to/android-reverse-engineering-skill
/plugin install android-reverse-engineering@android-reverse-engineering-skill

Uso

Comando slash

/decompile path/to/app.apk

Esto ejecuta el flujo de trabajo completo: verificación de dependencias, descompilación y análisis inicial de estructura.

Lenguaje natural

La habilidad se activa con frases como:

• "Descompila este APK"
• "Haz ingeniería inversa de esta aplicación Android"
• "Extrae los endpoints de API de esta aplicación"
• "Sigue el flujo de llamadas desde LoginActivity"
• "Analiza esta librería AAR"

Scripts manuales

Los scripts también se pueden usar de forma independiente:

# Check dependencies
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/check-deps.sh

# Install a missing dependency (auto-detects OS and package manager)
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh jadx
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/install-dep.sh vineflower

# Fingerprint an APK/XAPK BEFORE decompiling (Phase 0 triage):
# framework, HTTP stack, obfuscation level, native libs, notable SDKs
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/fingerprint.sh app.apk

# Decompile APK with jadx (default)
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app.apk

# Decompile XAPK (auto-extracts and decompiles each APK inside)
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh app-bundle.xapk

# Decompile with Fernflower
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine fernflower library.jar

# Run both engines and compare
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/decompile.sh --engine both --deobf app.apk

# Find API calls — defaults to a full scan across every supported stack
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --retrofit
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --urls

# Modern Kotlin/KMP stacks and obfuscation-resistant extraction
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --ktor    # Ktor client
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --apollo  # Apollo / GraphQL
bash plugins/android-reverse-engineering/skills/android-reverse-engineering/scripts/find-api-calls.sh output/sources/ --paths   # quoted path literals that survive R8 inlining

Recuperación de nombres de Kotlin (desofuscación de R8)