Files
urieljareth 450aee216d docs: documentacion completa para humanos y agentes IA
- README reescrito: ejemplos CLI corregidos (flags van en el subcomando scrape),
  webapp+doctor documentados, requisitos por OS, cookies, datos generados, migracion de maquina
- CLAUDE.md actualizado: conteo de tests, refs de linea reparadas, scripts nuevos,
  checklist de actualizacion de docs
- AGENTS.md nuevo: entrada estandar para cualquier agente de codigo (mapa de modulos,
  comandos, reglas de oro, punteros a docs)
- docs/GETTING-STARTED.md: de cero a webapp por OS con troubleshooting
- docs/CONFIG.md: referencia completa de las ~25 claves de config
- docs/COOKIES.md: adquisicion, import (web/navegador/CLI), rotacion y seguridad
- docs/backlog.md reemplaza OPPORTUNITIES.md (distilado: shipped vs pendiente)
- auditorias movidas a docs/audits/ y CLIPPER-COMPARISON-AUDIT.md versionado
2026-09-10 00:32:32 -06:00

838 B

Auditorías

Documentos de investigación que explican decisiones técnicas del proyecto mediante ingeniería inversa. No son specs ni manuales: son material de referencia.

  • YOUTUBE-TRANSCRIPT-AUDIT.md — ingeniería inversa de la extensión Obsidian Web Clipper 1.7.1: cómo obtiene metadatos y transcripciones vía la API privada InnerTube (youtubei/v1/player) con clientes ANDROID/IOS/WEB. Es el contexto de por qué este scraper delega en yt-dlp (que implementa el mismo mecanismo) en vez de llamar a InnerTube directamente.
  • CLIPPER-COMPARISON-AUDIT.md — comparativa extensión vs yt-channel-scraper: filosofías de red opuestas (una petición por vídeo pinchado vs batch educado de canal) y qué ideas de una aplican a la otra.

Ambos provienen de la raíz del repo y se mantienen sin edición aquí.