TubeScout 🔭

Convierte YouTube en un motor de investigación para tu agente de IA. Un servidor MCP (sin clave de API) más un paquete de habilidades que hacen queClaude Code, Codex y OpenCode busquen en YouTube como si fuera una base de datos, lean transcripciones a gran escala y extraigan evidencia de los vídeos — afirmaciones, cifras, señales de demanda — en lugar de corazonadas.

Las herramientas de ideación escanean Reddit y foros. YouTube es donde los fundadores muestran las pruebas — paneles de ingresos, manuales de estrategia, cifras reales ante la cámara — y nada lo explota. TubeScout sí lo hace.

Inicio rápido (60 segundos)

Claude Code

claude mcp add --scope user tubescout -- npx -y tubescout

Codex

codex mcp add tubescout -- npx -y tubescout

OpenCode — añadádelo a ~/.config/opencode/opencode.json en "mcp":

"tubescout": { "type": "local", "command": ["npx", "-y", "tubescout"], "enabled": true }

Eso es todo — sin clave de API, sin configuración. Luego pídele a tu agente cosas como:

«Encuentra los 5 vídeos más vistos sobre n8n del último mes y resume con qué problemas se está encontrando la gente.»

La opción más fácil, todo en uno (Claude Code): instálalo como plugin — servidor MCP + las 6 habilidades en dos comandos:

/plugin marketplace add not0lucky/tubescout
/plugin install tubescout@tubescout

O instala el paquete de habilidades manualmente (funciona con Claude Code, Codex y OpenCode):

git clone https://github.com/not0lucky/tubescout && cd tubescout
./scripts/install-skills.sh   # installs into ~/.claude/skills, ~/.codex/skills, ~/.config/opencode/skills

Related MCP server: youtube-mcp

Herramientas

Habilidades (los métodos de investigación)

Todas las habilidades son sensibles al contexto: leen la conversación para saber qué estás construyendo, tu stack y los vídeos ya analizados, y adaptan los veredictos a tu apalancamiento real en lugar de dar consejos genéricos.

Mira una ejecución real de /yt-breakdown sobre tres vídeos de «cómo gano $X al mes» — incluido lo que sobrevivió al análisis escéptico y lo que no.

Cómo funciona (con honestidad)

Aquí no hay magia, y esa es la cuestión:

• youtubei.js se comunica con la API interna InnerTube de YouTube, la misma que usa el sitio. Sin clave, sin cuotas.

• Las transcripciones son los subtítulos propios de YouTube, obtenidos mediante una cadena de respaldo: la pista timedtext del cliente ANDROID → el endpoint de transcripción de InnerTube (conocido por devolver errores 400 de forma intermitente; se reintenta con backoff) → yt-dlp local si lo tienes. Cada respuesta te indica qué source la ha servido.

• Todo el análisis ocurre en tu agente. El servidor entrega datos; las habilidades entregan el método.

Limitaciones

• Ejecútalo localmente. YouTube limita agresivamente la tasa de peticiones a las IP de centros de datos; este es un servidor stdio local por diseño, no un servicio alojado.

• YouTube cambia sus mecanismos internos sin previo aviso; cuando se rompa, actualiza (npx siempre descarga la última versión) y abre un issue con el ID del vídeo que falla.

• Los vídeos con subtítulos desactivados no se pueden transcribir (es poco habitual; el error lo indica explícitamente).

• El scraping de subtítulos vive en la zona gris de los Términos de Servicio de YouTube; está bien para herramientas de investigación locales, pero no construyas un producto de pago alojado sobre ello.

Desarrollo

npm install && npm run build
npm test          # unit tests (offline)
npm run test:live # live smoke tests against real videos — run before publishing
npm run inspect   # MCP Inspector against the built server

MIT — consulta LICENSE.

Creado por Anir — automatizo cosas. Más en agramprojects.com.