DQIII8: Skill for Claude Code

CDP Investigate — Investigación web bajo demanda sobre el túnel CDP

Cuándo usar este skill

Cuando el usuario pide investigar, extraer información, o "visualizar" una web o plataforma bajo demanda:

• "Investiga X" / "entra en <url> y sácame..." / "haz captura de..."
• Necesitas texto, HTML o un screenshot de una página que requiere estar autenticado (la sesión del navegador del PC del usuario, vía 9333) o de cualquier página pública.
• No uses este skill para clicar, rellenar formularios, enviar datos o cualquier acción con efectos secundarios sobre la página — está fuera del alcance por diseño (ver "Fuera de alcance" abajo).

Herramienta

cd /root/dqiii8
python3 bin/tools/cdp_investigate.py --url <URL> --extract text|html|screenshot|all \
  [--port 9333] [--settle 4.0] [--full-page] [--max-total-s 60]

• --url debe ser http(s) — cualquier otro esquema se rechaza.
• --extract es un enum cerrado: no hay passthrough de JS arbitrario ni modo de red libre.
• Puerto por defecto 9333 (túnel SSH al Chrome del PC Windows del usuario, intermitente). Usa --port 9222 para el Chrome local del VPS si aplica.

Interpretar el JSON de salida

{"ok": true, "text_path": "...", "html_path": "...", "screenshot_path": "...", "inline": {"text": "...", "html": "..."}}

• inline.text/inline.html están truncados a ~4000 chars — para el contenido completo, lee text_path/html_path con el tool Read.
• screenshot_path es un PNG — inspecciónalo con el tool Read.

Outcomes de fallo — normales, NO reintentar en bucle

• {"ok": false, "error": "tunnel_down"} — el túnel 9333 no responde. Es un resultado normal: comunica al usuario que abra el túnel/PC, no reintentes en bucle.
• {"ok": false, "error": "cdp_busy"} — ya hay otra investigación en curso sobre el mismo puerto (invariante de un solo cliente CDP a la vez). Espera y reintenta más tarde si hace falta, no en bucle inmediato.
• {"ok": false, "error": "invalid_url_scheme"} — corrige la URL.
• {"ok": false, "error": "blocked_host"} — la URL apunta a localhost/red privada (bloqueado: evita SSRF hacia el propio plano de control de DevTools, p.ej. cerrar tabs ajenas vía /json/close/<id>). No es un bug, es la guardarraíl de S1 funcionando.
• {"ok": false, "error": "watchdog_timeout"} — la investigación excedió --max-total-s; la tab y el lock quedan liberados igualmente (el watchdog intenta cerrar la tab por HTTP antes de forzar la salida).