pentest-tools

ACCIÓN REQUERIDA (leer y ejecutar inmediatamente después de leer)

1. AHORA: Leer ../field-journal/precedent-pentest.md — confirmar que la operación de este skill está autorizada como operación rutinaria.
2. AHORA: Confirmar que scope.md existe y que auth.status=granted y network_profile es válido (../ops/scope-contract.md). Si falta scope, ejecutar case-init.ps1 y detenerse para que el usuario otorgue autorización; prohibido añadir -AuthGranted automáticamente.
3. AHORA: Confirmar si la tarea actual coincide con el ámbito de aplicación de este skill.
4. SIGUIENTE: Leer ../tool-index.md, verificar la disponibilidad de herramientas y las rutas reales.
5. SIGUIENTE: Si falta alguna herramienta, invocar bootstrap; no adivinar rutas.
6. ACTUAR: En la fase de reconocimiento, priorizar references/recon-pipeline.md (cabeceras de navegador CF / nmap en Windows / curl --globoff); añadir cada lote de resultados a timeline.md; opcionalmente usar ../scripts/append-evidence.ps1 para escribir evidencia (acierto ≠ verificado).
7. ACTUAR: Para superficie cliente web moderna / campo de tiro (DOM XSS / prototype pollution / agent-browser) → references/client-side-lab-playbook.md; incluso si no se logra penetrar, escribir evidencia observada + compuerta de fallo.

Cadena de herramientas de pruebas de penetración (Pentest Tools)

Ámbito de aplicación

Usar este skill cuando la tarea pertenezca a los siguientes escenarios:

• Recopilación de información del objetivo (escaneo de puertos, enumeración de subdominios, identificación de servicios).
• Escaneo de vulnerabilidades (vulnerabilidades web, detección de CVE, errores de configuración).
• Penetración web (SQL injection, XSS, SSRF, fuerza bruta de directorios).
• Cracking de contraseñas (cracking de hashes, ataques de diccionario).
• Penetración en red (explotación de servicios, asistencia para movimiento lateral).

División de tareas con otros skills

Escenario	Qué usar
Escaneo/ataque activo (Nmap/Nuclei/SQLMap)	Este skill
Análisis inverso de binarios	ida-reverse/ o radare2/
Reversión de firmas JS en frontend	js-reverse/
Automatización de navegador/escritorio	browser-automation/
Competiciones CTF (completo)	CTF-Sandbox-Orchestrator/

Juicio simple:

• Necesitas "escanear objetivos, descubrir vulnerabilidades, explotar vulnerabilidades" → Este skill.
• Necesitas "analizar la lógica interna del programa" → Skills de reverso.
• Necesitas "operar el navegador/escritorio" → browser-automation.

---

Matriz de herramientas

Recopilación de información

Herramienta	Uso	Comando típico
Nmap	Escaneo de puertos, identificación de servicios, detección de SO	nmap -sV -sC -O target
Masscan	Escaneo rápido de puertos a gran escala	masscan -p1-65535 target --rate=1000
Subfinder	Enumeración de subdominios	subfinder -d target.com
httpx	Sondeo HTTP, detección de hosts activos	httpx -l urls.txt -status-code

Escaneo de vulnerabilidades

Herramienta	Uso	Comando típico
Nuclei	Escaneo de vulnerabilidades basado en plantillas (CVE/configuraciones/exposición)	nuclei -u target -t cves/
ZAP	Escaneo de seguridad de aplicaciones web	A través de API o MCP
Nikto	Escaneo de vulnerabilidades de servidor web	nikto -h target

Penetración web

Herramienta	Uso	Comando típico
SQLMap	Automatización de SQL injection	sqlmap -u "url?id=1" --batch --dbs
FFUF	Fuerza bruta de directorios/parámetros	ffuf -u target/FUZZ -w wordlist.txt
Gobuster	Fuerza bruta de directorios/subdominios	gobuster dir -u target -w wordlist
XSStrike	Detección de XSS	xsstrike -u "url?param=test"

Cracking de contraseñas

Herramienta	Uso	Comando típico
Hashcat	Cracking de hashes con GPU	hashcat -m 0 hash.txt wordlist.txt
John the Ripper	Cracking de hashes con CPU	john --wordlist=rockyou.txt hash.txt
Hydra	Fuerza bruta en línea	hydra -l admin -P pass.txt target ssh

Frameworks de explotación

Herramienta	Uso	Descripción
Metasploit	Framework de explotación de vulnerabilidades	Requiere instalación separada, gran tamaño
Impacket	Explotación de protocolos Windows (SMB/WMI/Kerberos)	pip install impacket

---

Selección de backend MCP

Este skill soporta dos backends MCP, elige uno:

Opción A: pentestMCP (recomendado, con Docker)

• Proyecto: https://github.com/ramkansal/pentestmcp
• Características: 20+ herramientas empaquetadas en un solo contenedor Docker, servidor MCP expuesto directamente.
• Herramientas: Nmap, Nuclei, ZAP, SQLMap, FFUF, Nikto, Gobuster, Subfinder, httpx, etc.
• Instalación:

# Descargar y ejecutar
docker pull ramkansal/pentestmcp
docker run -d -p 8080:8080 ramkansal/pentestmcp

# O construir localmente
git clone https://github.com/ramkansal/pentestmcp.git
cd pentestmcp
docker build -t pentestmcp .
docker run -d -p 8080:8080 pentestmcp

• Registro MCP:

{
  "mcpServers": {
    "pentest": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Opción B: mcp-security-hub (modular)

• Proyecto: https://github.com/FuzzingLabs/mcp-security-hub
• Características: Cada herramienta tiene su propio servidor MCP independiente, habilitable bajo demanda.
• Herramientas: Nmap, Ghidra, Nuclei, SQLMap, Hashcat.
• Instalación: Seguir el README de cada submódulo.

Opción C: MCP de herramienta única (más ligero)

Si solo necesitas una herramienta:

Herramienta	Proyecto MCP	Instalación
Nmap	nmap-mcp-server	npm
Nuclei	nuclei-mcp	npm
SQLMap	submódulo mcp-security-hub	pip

Reqable MCP (captura local y estación de trabajo API)

El cliente de escritorio Reqable puede exponer capacidades de captura local, API, puntos de interrupción y reglas a través del Reqable MCP Server. Primero instala e inicia Reqable por separado, luego registra el MCP:

powershell -NoProfile -ExecutionPolicy Bypass -File skills\scripts\bootstrap-reverse.ps1 -Capability reqable-mcp -McpHostTarget Codex

Reemplaza Codex con Claude o Both para seleccionar el cliente correspondiente; si omites -McpHostTarget, no se escribirá ninguna configuración global del cliente.

La configuración stdio registrada es:

{
  "mcpServers": {
    "reqable-mcp": {
      "command": "npx",
      "args": ["-y", "[email protected]", "--scope", "minimal"]
    }
  }
}

• Por defecto usa la API local de Reqable; si es necesario, configura --host, --port o --scope minimal|all según la documentación oficial.
• minimal es el ámbito recomendado por defecto; all expondrá más herramientas que pueden modificar proxy, reglas, entorno o datos guardados.
• Para tráfico capturado, repetición de solicitudes y modificación de reglas, aún se deben cumplir los permisos y restricciones de red de scope.md; no se permite ampliar el objetivo solo porque MCP esté registrado.

---

Flujo de trabajo

Proceso de penetración estándar

Importante: Al ejecutar pruebas de penetración, debes seguir el marco de ciclo autónomo de references/pentest-loop.md. Este marco define la compuerta de riesgos completa, las normas de registro, la compresión de contexto y los mecanismos de verificación de finalización.

1. Recopilación de información
   - Escaneo de puertos con Nmap → confirmar servicios abiertos
   - Enumeración de subdominios con Subfinder → ampliar superficie de ataque
   - Detección de hosts activos con httpx → filtrar objetivos válidos

2. Escaneo de vulnerabilidades
   - Escaneo con plantillas Nuclei → detectar rápidamente vulnerabilidades conocidas
   - ZAP/Nikto → escaneo profundo de aplicaciones web

3. Explotación de vulnerabilidades
   - SQLMap → SQL injection
   - FFUF → descubrir rutas/parámetros ocultos
   - Verificación manual → confirmar explotabilidad

4. Post-explotación (si está autorizado)
   - Escalada de privilegios
   - Movimiento lateral
   - Extracción de datos

5. Informe
   - Invocar skill docs-generator para generar el informe de penetración

Flujo de escaneo rápido (resultados en 5 minutos)

1. nmap -sV -sC target → puertos + servicios
2. nuclei -u target -severity critical,high → vulnerabilidades de alto riesgo
3. Si hay servicio web → ffuf -u target/FUZZ -w common.txt → directorios
4. Resumir hallazgos → decidir siguientes pasos

---

Notas importantes

• Debe tener autorización — Todas las operaciones de escaneo/ataque deben estar dentro del alcance autorizado.
• Controlar la tasa de escaneo — Evitar activar WAF/IDS o saturar el objetivo.
• Primero pasivo, luego activo — Primero recopilar información, luego escanear vulnerabilidades, finalmente explotar.
• Registrar todas las operaciones — Cada comando y resultado debe registrarse para el informe.
• No automatizar ciegamente — La IA debe esperar confirmación en cada paso crítico.

---

Bootstrap bajo demanda

Límites de capacidad de automatización

Herramienta	Instalable automáticamente	Método de instalación	Descripción
Nmap	✓	winget (Insecure.Nmap)	Versión Windows
Nuclei	✓	go install o GitHub Release	Necesita Go o descargar binario
SQLMap	✓	pip install sqlmap o git clone	Python
FFUF	✓	GitHub Release	Binario Go
SecLists	✓	GitHub Release ZIP	Diccionarios completos (esencial para FFUF/Gobuster)
Hashcat	✗	Descarga manual	Necesita controladores GPU
Metasploit	✗	Instalación manual	Gran tamaño, se recomienda Kali
pentestMCP (Docker)	✗	Necesita Docker	docker run ramkansal/pentestmcp
Impacket	✓	pip install impacket	Python
ProxyCat	✓	pip install proxycat	Middleware de pool de proxies (evita bloqueo en escaneos masivos)
BurpSuite MCP	✗	Instalación desde el market de extensiones de BurpSuite	Necesita BurpSuite Pro/Community
Reqable MCP	✓	npx -y [email protected]	Necesita instalar manualmente el cliente de escritorio Reqable

Estrategia de bootstrap

1. Si el usuario tiene Docker → recomendar pentestMCP (todo en uno).
2. Si no tiene Docker → instalar herramientas individualmente según necesidad.
3. Priorizar instalación de Nmap + Nuclei + SQLMap (cubren el 80% de los escenarios).

Guía de instalación manual

⚠️ **Herramientas de penetración no instaladas**

**Opción recomendada (necesita Docker)**:
docker pull ramkansal/pentestmcp
docker run -d -p 8080:8080 ramkansal/pentestmcp

**Opción ligera (instalación individual)**:
- Nmap: winget install Insecure.Nmap
- Nuclei: go install -v github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest
- SQLMap: pip install sqlmap
- FFUF: Descargar desde https://github.com/ffuf/ffuf/releases

**Después de instalar, indícalo y continúo con la tarea actual.**

---

Recursos de referencia

• awesome-pentest — 25k+ estrellas, colección de herramientas de penetración.
• SecLists — Colección de diccionarios/payloads (esencial para FFUF/Gobuster).
• PayloadsAllTheThings — Payloads para varios tipos de vulnerabilidades.
• HackTricks — Enciclopedia de técnicas de penetración.
• pentest-ai-agents — 35 subagentes de penetración para Claude Code (referencia para patrones de prompt).
• Pentest Swarm AI — Framework de penetración autónoma con inteligencia de enjambre (multiagente cooperativo, soporta servidor MCP).
• ProxyCat — Middleware de pool de proxies (evita bloqueo de IP en escaneos masivos).
• planning-with-files — Skill de tareas planificadas (para pruebas de bucle).

Documentos de referencia dentro de este skill

• references/pentest-loop.md — Marco de ciclo central (compuerta de riesgos + normas de registro + compresión de contexto).
• references/recon-pipeline.md — Pipeline de reconocimiento autorizado (cabeceras CF / nmap / Evidencia).
• references/client-side-lab-playbook.md — DOM XSS / prototype pollution / agent-browser (superficie cliente del campo de tiro).
• references/burpsuite-mcp-guide.md — Guía completa de BurpSuite MCP (63 herramientas + 7 escenarios de uso + plantillas de prompt AI).
• references/automation-loop-pattern.md — Patrón de prueba de bucle automatizado (versión ligera).
• references/awesome-pentest-digest.md — Resumen rápido de herramientas de penetración.
• references/pentest-ai-agents-matrix.md — Matriz de cobertura de 35 agentes.
• payloads/ — Directorio de payloads personalizados (la IA debe usar primero).
• templates/ — Plantillas de archivos necesarios para pruebas de penetración (scope/rules/plan/findings/progress).

Base de conocimientos de caza de vulnerabilidades src-hunter

El directorio src-hunter/ contiene una metodología completa de caza de vulnerabilidades para SRC/Bug Bounty:

• 19 playbooks de ataques (IDOR, RCE, XSS, SQLi, SSRF, OAuth, subida de archivos, etc.)
• 305 payloads estructurados + 263 pasos de evasión de WAF/EDR.
• 2887 informes High/Critical divulgados de HackerOne.
• 88 636 casos históricos de WooYun.
• Huellas de componentes nacionales y credenciales por defecto.
• Plantillas de informe CVSS 4.0.

Modo de uso: La IA lee automáticamente el playbook correspondiente durante la fase de caza y prueba según su flujo.

Ver src-hunter/SKILL.md y src-hunter/references/.

---

Contexto de enrutamiento

Entrada ascendente: skills/SKILL.md (controlador), routing.md. Condición de activación: Necesidad de escanear/atacar activamente un objetivo (escaneo de puertos, detección de vulnerabilidades, pruebas de inyección, etc.). Salida descendente:

• Si se encuentra una vulnerabilidad web que requiere análisis adicional → js-reverse/.
• Si se encuentra una vulnerabilidad binaria que requiere reverso → ida-reverse/ o radare2/.
• Si se necesita operar el navegador para verificar una vulnerabilidad → browser-automation/.
• Al finalizar, generar informe → docs-generator/.

Módulos relacionados del mismo nivel: CTF-Sandbox-Orchestrator/ (las pruebas Web/Pwn en CTF usarán estas herramientas).

Autoverificación de finalización (DEBE pasar antes de afirmar que está completo)

• ¿Ejecuté cada paso del flujo de trabajo (y no solo lo leí)?
• ¿Usé rutas reales de herramientas basadas en tool-index?
• ¿Produje evidencia reproducible (comandos/scripts/capturas de pantalla/informes)?
• ¿Completé y actualicé los puntos de la Checklist requeridos por las RULES?