youber 0.1.0__tar.gz

youber-0.1.0/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+Todos los cambios relevantes del proyecto se documentan aquí.
+El formato sigue [Keep a Changelog](https://keepachangelog.com/es/1.1.0/) y el
+proyecto usa [Versionado Semántico](https://semver.org/lang/es/).
+
+## [0.1.0] - 2026-08-29
+
+Primera publicación (Alpha).
+
+### Added
+
+- **Núcleo Playwright** (`youber/core`): `BrowserManager` con contextos
+  aislados, excepciones propias, logging con loguru y fixture de ejemplo.
+- **Servidor MCP** (`youber/mcp`): MCPServer (MCP SDK 2.x) con herramientas
+  `open_page`, `navigate_to`, `get_page_info`, `audit_accessibility`,
+  `simulate_geolocation`, `simulate_network` y `simulate_device`; sesiones de
+  navegador persistentes.
+- **Cliente MCP** (`youber/client`): `create_mcp_session` (stdio/SSE/
+  streamable-http con reintentos), `MCPTools` y CLI interactiva
+  `youber-client` (rich).
+- **Accesibilidad** (`youber/accessibility`): `AxeRunner` con caché y
+  opciones, mapeo de 70+ reglas a WCAG 2.1/2.2, reportes Markdown/JSON/resumen
+  y recomendaciones con recursos educativos. axe-core vendored (offline).
+- **UX** (`youber/ux`): detección de patrones de navegación, heatmaps de
+  scroll/clics, trazado de user journeys con puntos de abandono y reportes.
+- **Sandbox** (`youber/sandbox`): simulaciones de geolocalización (10
+  regiones), red (5 perfiles vía CDP) y dispositivos (iPhone/Pixel/iPad/Desktop).
+- **CLI**: `youber-audit` (auditoría rápida) y `youber-sandbox` (demo de
+  simulaciones).
+- **Ejemplos** en `examples/`: auditorías de google/youtube/github, auditoría
+  personalizada, batch por CSV y demo observacional anti-bot.
+- **Documentación**: ACCESSIBILITY, MCP_SERVER, CLIENT, SANDBOX, EXAMPLES,
+  ANTI_BOT_RESEARCH, RESEARCH y PUBLISHING.
+- **CI/CD**: GitHub Actions (Python 3.11/3.12, ruff, mypy, pytest con
+  cobertura), configuración ruff/mypy y pre-commit hooks.
+
+### Fixed
+
+- Empaquetado: `config/` movido dentro del paquete (`youber/settings.py`).
+- Compatibilidad Windows: consola UTF-8 para emojis y slugs saneados.
+- Tests e2e: gestión de sesión MCP dentro del test (compatibilidad
+  pytest-asyncio + anyio) y aislamiento de variables de entorno.

youber-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Skyzo (contribuidores de BARF)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

youber-0.1.0/MANIFEST.in

@@ -0,0 +1,16 @@
+# MANIFEST.in — ficheros incluidos en el sdist (además de los del paquete)
+
+include README.md
+include LICENSE
+include pyproject.toml
+include CHANGELOG.md
+
+# Asset vendored de axe-core (auditorías offline deterministas)
+recursive-include src/youber/assets *
+
+# Documentación y ejemplos
+recursive-include examples *
+recursive-include docs *
+
+exclude .env.example
+exclude .gitignore

youber-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: youber
+Version: 0.1.0
+Summary: Browser Automation Research Framework - Framework educativo para investigación de navegación y accesibilidad
+Author-email: Skyzo <skyzos@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/youber
+Project-URL: Repository, https://github.com/yourusername/youber
+Project-URL: Documentation, https://github.com/yourusername/youber/docs
+Keywords: automation,playwright,accessibility,research,mcp
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: playwright>=1.45
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pydantic>=2.7
+Requires-Dist: loguru>=0.7
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<3,>=2.0.0
+Requires-Dist: rich>=13.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-cov>=5.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: pre-commit>=3.0; extra == "dev"
+Dynamic: license-file
+
+# BARF — Browser Automation Research Framework
+
+> Framework **educativo** de automatización de navegadores para investigación, accesibilidad y estudio de UX.
+> El nombre es horrible a propósito. El código, no. ⚙️
+
+## Descripción
+
+BARF es un framework educativo de automatización de navegadores construido
+sobre **Playwright**, con:
+
+- **Servidor MCP** (Model Context Protocol, SDK 2.x) para agentes de IA
+- **Auditoría de accesibilidad** (axe-core + mapeo WCAG 2.1/2.2 + reportes)
+- **Estudio de UX** (patrones de navegación, heatmaps, user journeys)
+- **Sandbox de simulaciones** (geolocalización, red, dispositivos)
+- **CLI**: `youber-audit`, `youber-sandbox` y `youber-client` (interactiva)
+
+## Propósito educativo
+
+- Enseñar cómo funcionan Playwright, MCP y los sistemas anti-bot
+- Auditar accesibilidad web de forma reproducible (WCAG)
+- Estudiar cómo los usuarios interactúan con las interfaces
+- Aprender a integrar navegadores con agentes de IA vía MCP
+
+## Restricciones (no negociables)
+
+- ❌ No manipular métricas (visualizaciones, likes, suscriptores, watch time)
+- ❌ No evadir sistemas de seguridad ni anti-bot en entornos reales
+- ❌ No spam, scraping abusivo ni contenido malicioso
+- ✅ Código open source y con fines educativos
+- ✅ Respetar robots.txt y términos de servicio
+- ✅ Solo se prueban propiedades propias o con permiso explícito
+
+## Instalación
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate | Linux/macOS: source .venv/bin/activate
+pip install -e ".[dev]"
+playwright install chromium
+```
+
+## Ejemplos rápidos
+
+Auditoría de accesibilidad:
+
+```bash
+youber-audit https://example.com
+```
+
+CLI interactiva (cliente MCP):
+
+```bash
+youber-client
+> audit https://example.com
+> geo JP https://example.com
+```
+
+Desde código:
+
+```python
+import asyncio
+from youber.accessibility.axe_runner import AxeRunner
+from youber.core.browser import BrowserManager
+
+async def main():
+    manager = BrowserManager(headless=True)
+    await manager.launch()
+    context = await manager.new_context()
+    page = await manager.new_page(context)
+    await manager.navigate(page, "https://example.com")
+    results = await AxeRunner().run_axe(page)
+    print(f"Violaciones: {results.total_violations}")
+    await manager.close()
+
+asyncio.run(main())
+```
+
+## Documentación
+
+- [Accesibilidad](docs/ACCESSIBILITY.md) — auditoría WCAG con axe-core
+- [Servidor MCP](docs/MCP_SERVER.md) — herramientas del servidor
+- [Cliente MCP](docs/CLIENT.md) — conexión al servidor desde código/terminal
+- [Sandbox](docs/SANDBOX.md) — simulaciones de entorno
+- [Investigación anti-bot](docs/ANTI_BOT_RESEARCH.md) — estudio educativo
+- [Guía de laboratorio](docs/RESEARCH.md) — experimentos observacionales
+- [Ejemplos](docs/EXAMPLES.md) — guía de los ejemplos
+- [Publicación en PyPI](docs/PUBLISHING.md) — cómo publicar el paquete
+
+## Calidad
+
+- CI: GitHub Actions (Python 3.11/3.12) — lint, type-check, tests, coverage
+- `ruff check src/ tests/ examples/`
+- `mypy src/`
+- `pytest tests/ -v --cov=youber`
+
+## Contribución
+
+1. Haz un fork del repositorio.
+2. Crea una rama (`git checkout -b feature/nueva-funcionalidad`).
+3. Asegúrate de que pasan `ruff`, `mypy` y `pytest`.
+4. Abre un pull request.
+
+Proyecto educativo: aporta ejemplos, documentación, tests o nuevas
+herramientas de estudio.
+
+## Licencia
+
+MIT — ver [LICENSE](LICENSE).

youber-0.1.0/README.md

@@ -0,0 +1,108 @@
+# BARF — Browser Automation Research Framework
+
+> Framework **educativo** de automatización de navegadores para investigación, accesibilidad y estudio de UX.
+> El nombre es horrible a propósito. El código, no. ⚙️
+
+## Descripción
+
+BARF es un framework educativo de automatización de navegadores construido
+sobre **Playwright**, con:
+
+- **Servidor MCP** (Model Context Protocol, SDK 2.x) para agentes de IA
+- **Auditoría de accesibilidad** (axe-core + mapeo WCAG 2.1/2.2 + reportes)
+- **Estudio de UX** (patrones de navegación, heatmaps, user journeys)
+- **Sandbox de simulaciones** (geolocalización, red, dispositivos)
+- **CLI**: `youber-audit`, `youber-sandbox` y `youber-client` (interactiva)
+
+## Propósito educativo
+
+- Enseñar cómo funcionan Playwright, MCP y los sistemas anti-bot
+- Auditar accesibilidad web de forma reproducible (WCAG)
+- Estudiar cómo los usuarios interactúan con las interfaces
+- Aprender a integrar navegadores con agentes de IA vía MCP
+
+## Restricciones (no negociables)
+
+- ❌ No manipular métricas (visualizaciones, likes, suscriptores, watch time)
+- ❌ No evadir sistemas de seguridad ni anti-bot en entornos reales
+- ❌ No spam, scraping abusivo ni contenido malicioso
+- ✅ Código open source y con fines educativos
+- ✅ Respetar robots.txt y términos de servicio
+- ✅ Solo se prueban propiedades propias o con permiso explícito
+
+## Instalación
+
+```bash
+python -m venv .venv
+# Windows: .venv\Scripts\activate | Linux/macOS: source .venv/bin/activate
+pip install -e ".[dev]"
+playwright install chromium
+```
+
+## Ejemplos rápidos
+
+Auditoría de accesibilidad:
+
+```bash
+youber-audit https://example.com
+```
+
+CLI interactiva (cliente MCP):
+
+```bash
+youber-client
+> audit https://example.com
+> geo JP https://example.com
+```
+
+Desde código:
+
+```python
+import asyncio
+from youber.accessibility.axe_runner import AxeRunner
+from youber.core.browser import BrowserManager
+
+async def main():
+    manager = BrowserManager(headless=True)
+    await manager.launch()
+    context = await manager.new_context()
+    page = await manager.new_page(context)
+    await manager.navigate(page, "https://example.com")
+    results = await AxeRunner().run_axe(page)
+    print(f"Violaciones: {results.total_violations}")
+    await manager.close()
+
+asyncio.run(main())
+```
+
+## Documentación
+
+- [Accesibilidad](docs/ACCESSIBILITY.md) — auditoría WCAG con axe-core
+- [Servidor MCP](docs/MCP_SERVER.md) — herramientas del servidor
+- [Cliente MCP](docs/CLIENT.md) — conexión al servidor desde código/terminal
+- [Sandbox](docs/SANDBOX.md) — simulaciones de entorno
+- [Investigación anti-bot](docs/ANTI_BOT_RESEARCH.md) — estudio educativo
+- [Guía de laboratorio](docs/RESEARCH.md) — experimentos observacionales
+- [Ejemplos](docs/EXAMPLES.md) — guía de los ejemplos
+- [Publicación en PyPI](docs/PUBLISHING.md) — cómo publicar el paquete
+
+## Calidad
+
+- CI: GitHub Actions (Python 3.11/3.12) — lint, type-check, tests, coverage
+- `ruff check src/ tests/ examples/`
+- `mypy src/`
+- `pytest tests/ -v --cov=youber`
+
+## Contribución
+
+1. Haz un fork del repositorio.
+2. Crea una rama (`git checkout -b feature/nueva-funcionalidad`).
+3. Asegúrate de que pasan `ruff`, `mypy` y `pytest`.
+4. Abre un pull request.
+
+Proyecto educativo: aporta ejemplos, documentación, tests o nuevas
+herramientas de estudio.
+
+## Licencia
+
+MIT — ver [LICENSE](LICENSE).

youber-0.1.0/docs/ACCESSIBILITY.md

@@ -0,0 +1,125 @@
+# Accesibilidad — BARF
+
+Guía del módulo de auditoría de accesibilidad: cómo ejecutarla, cómo leer los
+reportes y cómo usar el mapeo WCAG y las recomendaciones automáticas.
+
+## ¿Qué es WCAG?
+
+Las **Web Content Accessibility Guidelines (WCAG)** son el estándar W3C para
+accesibilidad web. Se organizan en 4 principios:
+
+1. **Perceptible** (1.x) — la información debe poder percibirse (alternativas
+   de texto, contraste, subtítulos...).
+2. **Operable** (2.x) — la interfaz debe poder usarse (teclado, tiempo,
+   navegación, objetivos táctiles...).
+3. **Comprensible** (3.x) — la información y el funcionamiento deben ser
+   comprensibles (idioma, etiquetas, ayuda...).
+4. **Robusto** (4.x) — el contenido debe funcionar con tecnologías de apoyo
+   (ARIA, nombres accesibles, ids únicos...).
+
+Cada criterio tiene un nivel de conformidad: **A** (mínimo), **AA**
+(recomendado) y **AAA** (avanzado).
+
+## Cómo auditar
+
+### Con la CLI (`youber-audit`)
+
+```bash
+youber-audit https://www.google.com
+youber-audit https://example.com --rules color-contrast label --impact serious
+```
+
+Guarda el reporte Markdown en `reports/` y muestra el resumen en consola.
+
+### Con los ejemplos
+
+```bash
+python examples/audit_google.py
+python examples/custom_audit.py --url https://example.com --rules color-contrast
+python examples/batch_audit.py --csv examples/urls.csv
+```
+
+### Con código
+
+```python
+import asyncio
+from youber.accessibility.axe_runner import AxeRunner
+from youber.accessibility.reporters import generate_json_report, generate_summary
+from youber.core.browser import BrowserManager
+
+async def main():
+    manager = BrowserManager(headless=True)
+    await manager.launch()
+    context = await manager.new_context()
+    page = await manager.new_page(context)
+    await manager.navigate(page, "https://example.com")
+
+    runner = AxeRunner()
+    results = await runner.run_axe(page, {"impactLevels": ["critical", "serious"]})
+    print(generate_summary(results))
+    data = generate_json_report(results)   # integrable con otras herramientas
+
+    await manager.close()
+
+asyncio.run(main())
+```
+
+### Desde MCP
+
+El servidor MCP expone `audit_accessibility(page_id)` (ver
+[MCP_SERVER.md](MCP_SERVER.md)); la implementación delega en `AxeRunner`.
+
+## Opciones de `run_axe`
+
+| Opción | Descripción | Ejemplo |
+|---|---|---|
+| `context` | Selector CSS o definición de contexto | `"#main"`, `{"include": [["#main"]]}` |
+| `rules` | Solo estas reglas | `["color-contrast", "label"]` |
+| `tags` | Solo reglas con estos tags | `["wcag2a", "wcag2aa"]` |
+| `impactLevels` | Filtrar por impacto | `["critical", "serious"]` |
+
+## Cómo leer el reporte Markdown
+
+Cada violación incluye: **ID** de la regla, **impacto** (🔴 critical, 🟠
+serious, 🟡 moderate, 🔵 minor), **descripción**, **elementos afectados**
+(selectores) y **enlace a la quickref WCAG** del criterio correspondiente.
+
+## Reglas comunes y su criterio WCAG
+
+| Regla axe | WCAG | Qué comprueba |
+|---|---|---|
+| `color-contrast` | 1.4.3 (AA) | Contraste texto/fondo ≥ 4.5:1 |
+| `image-alt` | 1.1.1 (A) | Texto alternativo en imágenes |
+| `html-has-lang` | 3.1.1 (A) | Atributo `lang` en `<html>` |
+| `document-title` | 2.4.2 (A) | Título descriptivo de la página |
+| `link-name` | 2.4.4 (A) | Nombre accesible en enlaces |
+| `label` | 1.3.1 (A) | Etiquetas en campos de formulario |
+| `region` | 1.3.1 (A) | Contenido agrupado en landmarks |
+| `heading-order` | 1.3.1 (A) | Encabezados sin saltos de nivel |
+| `frame-title` | 2.4.1 (A) | Título en `<iframe>` |
+| `target-size` | 2.5.8 (AA, WCAG 2.2) | Objetivos táctiles ≥ 24x24 px |
+
+El mapeo completo está en `src/youber/accessibility/wcag.py` (más de 70
+reglas). Nota: el mapeo es orientativo; una regla de axe puede cubrir varios
+criterios.
+
+## Recomendaciones y aprendizaje
+
+- `get_fix_suggestion(rule_id, element)` — sugerencia concreta de corrección.
+- `get_learning_resource(rule_id)` — recurso educativo (MDN, WebAIM, W3C).
+
+```python
+from youber.accessibility.recommendations import get_fix_suggestion, get_learning_resource
+
+print(get_fix_suggestion("color-contrast", "#boton"))
+# Aumenta el contraste entre texto y fondo hasta al menos 4.5:1...
+print(get_learning_resource("color-contrast"))
+# https://webaim.org/articles/contrast/
+```
+
+## Limitaciones
+
+- axe-core detecta **automáticamente comprobables**; hay criterios WCAG que
+  requieren revisión manual (los resultados `incomplete`).
+- Una auditoría automática no equivale a una evaluación de conformidad
+  completa (para eso se necesita una auditoría humana experta).

youber-0.1.0/docs/ANTI_BOT_RESEARCH.md

@@ -0,0 +1,111 @@
+# Investigación anti-bot — BARF
+
+> Documento **educativo**. Estudiar cómo funcionan los sistemas anti-bot sirve
+> para entender la web, defender la privacidad y construir tests honestos.
+> BARF **no** proporciona mecanismos de evasión: la investigación se hace
+> siempre en laboratorio, observando señales, sin saltarse ninguna protección.
+
+## Introducción: ¿qué son los sistemas anti-bot?
+
+Los sistemas anti-bot protegen servicios web de tráfico automatizado
+indeseado: scraping masivo, fraude, spam, creación de cuentas falsas o
+manipulación de métricas. Para distinguir humanos de programas analizan
+múltiples señales del cliente (navegador) y del tráfico (red), y deciden si
+bloquean, ralentizan o desafían la petición.
+
+Entender estas señales es relevante para:
+
+- **Desarrolladores**: saber qué expone su propio navegador al automatizar
+  tests (y por qué algunos tests se comportan distinto en CI).
+- **Investigadores de privacidad**: cuantificar la información que un sitio
+  puede recolectar sin permiso.
+- **Educadores**: enseñar cómo funciona la detección y por qué los
+  anti-cheats y anti-fraude existen.
+
+## Técnicas comunes
+
+### 1. Reputación de IP y bloqueo
+
+- Listas negras de IPs de centros de datos y proveedores cloud.
+- Rate limiting por IP/UA/cuenta.
+- Análisis de geolocalización de la IP frente a la zona horaria del cliente.
+- El tráfico residencial es más difícil de distinguir; por eso algunos usan
+  proxies residenciales — **técnica que BARF no emplea para evadir**.
+
+### 2. Browser fingerprinting
+
+El navegador expone decenas de señales que, combinadas, forman una huella
+casi única:
+
+- `user-agent`, `platform`, `language(s)`
+- Resolución de pantalla, colorDepth, `deviceMemory`, `hardwareConcurrency`
+- Zona horaria (`Intl`), fuentes instaladas, plugins
+- Render de **canvas** (huella gráfica muy estable) y WebGL
+- APIs como `navigator.webdriver` (marcada por WebDriver/Playwright)
+
+### 3. Comportamiento humano vs automatizado
+
+- Velocidad y trayectoria del ratón (curvas, aceleración).
+- Patrones de scroll y tiempos entre acciones (dwell, lectura).
+- Orden de foco y eventos de teclado (keystroke dynamics).
+- Coherencia temporal: un "humano" que actúa 24/7 o a velocidad constante
+  es sospechoso.
+
+### 4. CAPTCHA y desafíos
+
+- Desafíos cognitivos (texto, imágenes) o invisibles (honeypots, pruebas de
+  comportamiento).
+- Los retos modernos evalúan el historial de la sesión y el contexto del
+  navegador, no solo la respuesta.
+
+## Cómo se estudian en laboratorio
+
+Con BARF (entorno controlado, sin evasión):
+
+1. **Observación de señales** — `examples/research_demo.py` recopila las
+   señales que un sitio puede ver (UA, webdriver, canvas hash, timezone...)
+   y explica para qué se usan.
+2. **Métricas de detección** — en un sitio propio o de prueba, mide:
+   - ¿Cambia la respuesta según el user agent?
+   - ¿Qué peticiones bloquea un WAF con reglas conocidas?
+   - ¿Qué señales expone un navegador automatizado frente a uno normal?
+3. **Análisis de señales** — compara navegador headless vs headed, con/sin
+   permisos, distintos dispositivos (`youber-sandbox`), y documenta qué
+   cambia.
+
+```bash
+python examples/research_demo.py --url https://example.com
+youber-sandbox --url https://example.com --device iPhone --region JP
+```
+
+## Limitaciones y ética
+
+- **Uso educativo**: el conocimiento aquí descrito es para entender y
+  defender, no para saltarse protecciones en entornos reales.
+- **No evasión**: BARF no incluye ni documenta técnicas de evasión
+  operativas (patches de fingerprinting, rotación de identidades, etc.).
+- **Respeto a términos de servicio**: solo se prueban propiedades propias o
+  con permiso explícito; se respeta robots.txt y el uso razonable.
+- **Consentimiento y volumen**: nada de scraping a escala, nada de ocultar
+  actividad.
+
+## Enlaces a recursos académicos
+
+- [W3C — Web Accessibility & User Agent (privacidad)](https://www.w3.org/)
+- [Electronic Frontier Foundation — Panopticlick (huella del navegador)](https://panopticlick.eff.org/)
+- [Tor Project — Fingerprinting research](https://www.torproject.org/about/history/)
+- [OWASP — Automated Threats to Web Applications](https://owasp.org/www-project-automated-threats-to-web-applications/)
+- [MDN — Navigator API](https://developer.mozilla.org/es/docs/Web/API/Navigator)
+- [W3C — WebDriver specification (señal `webdriver`)](https://www.w3.org/TR/webdriver1/)
+- [Playwright — Emulation docs](https://playwright.dev/python/docs/emulation)
+
+## Referencia rápida de señales (research_demo)
+
+| Señal | Para qué se usa en detección |
+|---|---|
+| `navigator.webdriver` | Marca explícita de control automatizado |
+| `user_agent` / `platform` | Identificar navegador/SO; inconsistencias |
+| `canvas_hash` | Huella gráfica estable (fingerprint) |
+| `timezone` | Cruzar con geolocalización de la IP |
+| `plugins_count` | Entornos headless suelen reportar 0 |
+| `hardware_concurrency` / `device_memory` | Detectar virtualización |

youber-0.1.0/docs/ARCHITECTURE.md

@@ -0,0 +1,59 @@
+# Arquitectura Técnica — BARF
+
+## Visión general
+
+BARF se organiza en capas con una separación clara: la capa de automatización no sabe nada de política; la capa de política (guardrails) envuelve todo el tráfico.
+
+```
+┌─────────────────────────────────────────────────┐
+│ Capa MCP (servidor)                             │
+│  tools: audit_accessibility, study_navigation,  │
+│         test_page, network_probe, learn_playwright
+├─────────────────────────────────────────────────┤
+│ Capa de investigación (módulos temáticos)       │
+│  accessibility · ux · education · devtools · net │
+├─────────────────────────────────────────────────┤
+│ Capa de automatización (Playwright)             │
+│  launch, contextos aislados, fixtures, helpers   │
+├─────────────────────────────────────────────────┤
+│ Capa de política (guardrails)                   │
+│  rate limit · allowlist · sandbox · auditoría    │
+└─────────────────────────────────────────────────┘
+```
+
+## Módulos propuestos
+
+| Módulo | Responsabilidad | Tecnología |
+|---|---|---|
+| `barf/core` | Launch de navegadores, contextos aislados, fixtures, utilidades | Playwright sync/async |
+| `barf/accessibility` | Auditoría: ARIA, contraste, foco, teclado, subtítulos | Playwright + axe-core (opcional) |
+| `barf/ux` | Simulación de patrones de navegación, throttling de red, métricas de interacción | Playwright (`context.set_offline`, CDP) |
+| `barf/network` | Sondeos de geolocalización/latencia en sandbox | Playwright + aiohttp |
+| `barf/education` | Ejemplos comentados, materiales de taller, demos anti-bot en laboratorio | — |
+| `barf/mcp` | Servidor MCP que expone las herramientas anteriores | `mcp` (Python SDK) |
+| `barf/policy` | Rate limiting, allowlists, modo sandbox, log de auditoría | asyncio, sqlite/logging |
+
+## Decisiones clave
+
+1. **Python 3.11+** y el **SDK oficial de MCP** para el servidor; el núcleo usa Playwright para Python.
+2. **Contextos aislados por tarea**: cada tarea lanza un contexto limpio (perfil temporal, sin cookies compartidas) — bueno para testing y para no contaminar datos.
+3. **Guardrails en el núcleo, no en la periferia**: toda navegación pasa por `barf/policy` (límites por dominio, allowlist configurable, modo sandbox obligatorio para sondeos de red).
+4. **Anti-bot solo en laboratorio**: `playwright-stealth` se documenta y se usa únicamente en un escenario local/aislado para estudiar detección; el código de producción no lo incluye.
+5. **Auditoría**: cada acción automatizada se registra (qué, quién, cuándo, por qué, volumen) para mantener el proyecto transparente y reproducible.
+
+## Política de seguridad (guardrails)
+
+- **Sandbox por defecto**: sondeos de red/proxies corren en entorno aislado, sin cuentas reales.
+- **Rate limiting**: límites de peticiones por dominio; se respeta robots.txt y uso razonable.
+- **Allowlist**: solo dominios/propiedades autorizadas (propias o con permiso).
+- **Sin acciones de engagement**: el framework nunca realiza likes, suscripciones, comentarios ni reproducciones sobre contenido de terceros.
+- **Auditoría completa**: log persistente de toda actividad automatizada.
+
+## Roadmap técnico
+
+1. Estructura del repo + `pyproject.toml` + entorno (venv, `pip install -e .[dev]`)
+2. `barf/core`: launch, contextos, fixture de ejemplo (abrir YouTube y volcar título)
+3. `barf/mcp`: servidor con 2-3 herramientas (p. ej. `open_page`, `audit_accessibility`, `study_navigation`)
+4. Módulo de accesibilidad con axe-core
+5. Módulo de redes en sandbox
+6. Docs finales + ejemplos de taller