Initial commit: navegator - Chrome CDP automation for LLMs

Add complete navegator system for stealthy browser automation:
- CDP client with WebSocket communication
- Browser API with navigation, storage, network, runtime
- Stealth flags and anti-detection scripts
- Persistent profile support
- Examples and comprehensive documentation

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

docs/INDEX.md

@@ -0,0 +1,199 @@
+# Navegator - Índice de Documentación
+
+Guía completa de toda la documentación disponible.
+
+---
+
+## 📚 Documentación Principal
+
+### [README.md](../README.md)
+Introducción al proyecto, instalación rápida y uso básico.
+
+**Cuándo leer:** Siempre al iniciar con el proyecto.
+
+---
+
+## 🎯 Guías de Uso
+
+### [BINARIOS.md](BINARIOS.md)
+Guía completa de los binarios CLI (screenshot, buscar, navegar).
+
+**Temas:**
+- Compilar binarios
+- Parámetros de cada binario
+- Ejemplos de uso
+- Integración con Python
+- Casos de uso reales
+
+**Cuándo leer:** Para usar los binarios standalone.
+
+### [PERFILES_AVANZADO.md](PERFILES_AVANZADO.md)
+Gestión avanzada de perfiles de navegador.
+
+**Temas:**
+- Compartir perfiles entre proyectos
+- Usar mismo perfil en paralelo (clonación)
+- Perfiles persistentes vs temporales
+- Sincronización entre máquinas
+- Casos de uso: scraping multi-cuenta, A/B testing
+
+**Cuándo leer:** Cuando necesites:
+- Mover binarios a otro repo
+- Ejecutar múltiples instancias simultáneas
+- Simular usuarios diferentes
+
+---
+
+## 🔧 Guías Técnicas
+
+### [STEALTH_FLAGS.md](STEALTH_FLAGS.md)
+Documentación completa de flags de Chrome para anti-detección.
+
+**Temas:**
+- Flags críticas (SIEMPRE activadas)
+- Flags opcionales por contexto
+- JavaScript anti-detección
+- Configuración recomendada
+- Referencias y recursos
+
+**Cuándo leer:** Para entender o personalizar las flags stealth.
+
+### [TESTING.md](TESTING.md)
+Sistema completo de testing E2E y unitario.
+
+**Temas:**
+- Tests unitarios (Go)
+- Tests E2E (binarios)
+- Tests de integración
+- CI/CD automático
+- Debugging tests fallidos
+- Escribir nuevos tests
+
+**Cuándo leer:** Para verificar que los binarios funcionan correctamente.
+
+---
+
+## 🚀 Quick Start por Caso de Uso
+
+### Quiero automatizar capturas de pantalla
+1. Leer: [BINARIOS.md](BINARIOS.md) → Sección "screenshot"
+2. Compilar: `make build`
+3. Usar: `./bin/screenshot -url https://example.com -o captura.png`
+
+### Quiero hacer web scraping con múltiples cuentas
+1. Leer: [PERFILES_AVANZADO.md](PERFILES_AVANZADO.md) → "Scraping Multi-Cuenta"
+2. Usar: `scripts/clonar_perfil.sh` para duplicar perfiles
+3. Ejecutar en paralelo con perfiles diferentes
+
+### Quiero integrar con Python/otros lenguajes
+1. Leer: [BINARIOS.md](BINARIOS.md) → "Integración con Python"
+2. Compilar binarios: `make build`
+3. Llamar desde subprocess
+
+### Quiero evitar detección de bots
+1. Leer: [STEALTH_FLAGS.md](STEALTH_FLAGS.md)
+2. Revisar flags activas por defecto
+3. Personalizar según necesidad en `pkg/stealth/flags.go`
+
+### Quiero testear cambios antes de deploy
+1. Leer: [TESTING.md](TESTING.md)
+2. Ejecutar: `make test`
+3. Verificar que pasa antes de commit
+
+---
+
+## 📖 Orden de Lectura Recomendado
+
+### Principiante
+1. README.md (introducción)
+2. BINARIOS.md (usar binarios)
+3. PERFILES_AVANZADO.md (entender perfiles)
+
+### Intermedio
+4. STEALTH_FLAGS.md (personalizar detección)
+5. TESTING.md (verificar funcionamiento)
+
+### Avanzado
+6. Código fuente en `pkg/` (extender funcionalidad)
+7. Scripts en `scripts/` (automatizar tareas)
+
+---
+
+## 🔍 Buscar por Tema
+
+### Perfiles
+- Crear perfil: [BINARIOS.md](BINARIOS.md#perfiles-personalizados)
+- Compartir entre proyectos: [PERFILES_AVANZADO.md](PERFILES_AVANZADO.md#problema-1-mover-binarios)
+- Usar en paralelo: [PERFILES_AVANZADO.md](PERFILES_AVANZADO.md#problema-2-mismo-perfil-en-paralelo)
+
+### Testing
+- Ejecutar tests: [TESTING.md](TESTING.md#quick-start)
+- Tests unitarios: [TESTING.md](TESTING.md#tests-unitarios-detallados)
+- Tests E2E: [TESTING.md](TESTING.md#tests-e2e-detallados)
+- CI/CD: [TESTING.md](TESTING.md#cicd-automático)
+
+### Stealth
+- Flags básicas: [STEALTH_FLAGS.md](STEALTH_FLAGS.md#flags-críticas)
+- JavaScript anti-detección: [STEALTH_FLAGS.md](STEALTH_FLAGS.md#javascript-injection-anti-detección)
+- Configuración por contexto: [STEALTH_FLAGS.md](STEALTH_FLAGS.md#flags-para-contextos-específicos)
+
+### Binarios
+- Compilar: [BINARIOS.md](BINARIOS.md#compilar-todos)
+- screenshot: [BINARIOS.md](BINARIOS.md#1-screenshot)
+- buscar: [BINARIOS.md](BINARIOS.md#2-buscar)
+- navegar: [BINARIOS.md](BINARIOS.md#3-navegar)
+
+---
+
+## 🆘 Troubleshooting
+
+### Chrome no se inicia
+Ver: [TESTING.md](TESTING.md#chrome-crashed-o-cant-find-chrome)
+
+### Tests fallan
+Ver: [TESTING.md](TESTING.md#debugging-tests-fallidos)
+
+### Perfil bloqueado
+Ver: [PERFILES_AVANZADO.md](PERFILES_AVANZADO.md#-no-funciona-directamente)
+
+### Binario no encuentra perfiles
+Ver: [PERFILES_AVANZADO.md](PERFILES_AVANZADO.md#-problema)
+
+---
+
+## 📝 Contribuir
+
+Si encuentras errores o quieres mejorar la documentación:
+
+1. Documentación está en `docs/`
+2. Ejemplos están en `examples/`
+3. Tests están en `e2e/`
+
+---
+
+## 🔗 Enlaces Útiles
+
+- **Chrome DevTools Protocol**: https://chromedevtools.github.io/devtools-protocol/
+- **Chrome Flags**: https://peter.sh/experiments/chromium-command-line-switches/
+- **Go Testing**: https://go.dev/doc/tutorial/add-a-test
+
+---
+
+## ✅ Checklist Rápido
+
+Antes de usar Navegator:
+- [ ] Leer README.md
+- [ ] Instalar Chrome/Chromium
+- [ ] Compilar binarios: `make build`
+- [ ] Ejecutar tests: `make test-quick`
+
+Antes de usar en producción:
+- [ ] Leer STEALTH_FLAGS.md
+- [ ] Configurar perfiles persistentes
+- [ ] Ejecutar `make test`
+- [ ] Verificar en bot detection sites
+
+Antes de hacer commit:
+- [ ] `make fmt`
+- [ ] `make lint`
+- [ ] `make test`