Scribiz

Dale a tu agente de IA el contexto de un enlace de video: transcripción, resumen, capítulos y respuestas con marca de tiempo. Alojado, remoto, sin necesidad de cuenta ni clave.

Servidor MCP alojado

npx add-mcp 'https://scribiz.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Scribiz: servidor MCP de video para transcripciones, resúmenes y marcas de tiempo de YouTube

Dale a Claude, Cursor, Codex o cualquier cliente MCP el contexto de un video a partir de su enlace: la transcripción, un resumen, capítulos y los momentos exactos que responden una pregunta, cada uno con un enlace de marca de tiempo. Funciona con enlaces de YouTube, TikTok, Instagram, X y Vimeo. No se necesita cuenta ni clave API para comenzar.

claude mcp add --transport http scribiz https://scribiz.com/mcp

An agent's call to Scribiz: the title, a summary and a key moment of a video, with a link that opens it at that time

Mira la demo de 48 segundos. Cada respuesta en ella es una llamada real al servidor.

Este repositorio contiene los archivos de configuración para el servidor MCP alojado de Scribiz en https://scribiz.com/mcp. El servidor se ejecuta en scribiz.com. El código fuente de Scribiz no está en este repositorio.

Qué hace el agente con esto

Pegas un enlace de video en un chat. El agente le pide a Scribiz una vista general breve primero. Busca la parte que necesita, lee solo esa parte y responde con un enlace que abre el video en ese momento. No lee una transcripción completa para responder una pregunta.

Cómo agregarlo

El servidor alojado no necesita cuenta ni clave. Agrega la URL y funciona.

Claude Code

claude mcp add --transport http scribiz https://scribiz.com/mcp

Ejecuta /mcp dentro de Claude Code para ver el servidor y sus herramientas.

Claude Desktop y claude.ai

Ve a Personalizar y luego a Conectores. Selecciona + Agregar y luego Agregar conector personalizado. Ingresa:

  • Nombre: Scribiz
  • URL: https://scribiz.com/mcp
  • Autenticación: Sin inicio de sesión

El archivo claude_desktop_config.json es una configuración separada para servidores locales. No lo necesitas para el servidor alojado.

Cursor

Coloca esto en ~/.cursor/mcp.json, o en .cursor/mcp.json dentro de un proyecto:

{
  "mcpServers": {
    "scribiz": { "url": "https://scribiz.com/mcp" }
  }
}

VS Code

Coloca esto en .vscode/mcp.json. VS Code usa servers, no mcpServers.

{
  "servers": {
    "scribiz": { "type": "http", "url": "https://scribiz.com/mcp" }
  }
}

Codex

Agrega esto a ~/.codex/config.toml:

[mcp_servers.scribiz]
url = "https://scribiz.com/mcp"

Complemento de Claude Code (servidor y habilidad juntos)

Este repositorio también es un mercado de complementos de Claude Code. El complemento agrega el servidor y una habilidad que le enseña a Claude cómo usarlo.

claude plugin marketplace add Illyism/scribiz-mcp
claude plugin install scribiz@scribiz-mcp

Usa el complemento o la línea claude mcp add de arriba, no ambos. Otros agentes pueden instalar la habilidad por sí sola:

npx skills add Illyism/scribiz-mcp

Pruébalo

Pregúntale a tu agente:

Summarize https://www.youtube.com/watch?v=jNQXAC9IVRw, then find where they talk about the trunks and quote it.

Este es un video público de 19 segundos, "Me at the zoo". Deberías ver una llamada a get_video_context, luego search_video y una respuesta con un enlace de marca de tiempo. El resultado indica cómo se hizo la transcripción. Cuando un modelo lee el enlace, sus tiempos son aproximados (unos 2 segundos en cualquier dirección). Un video que Scribiz no ha procesado antes usa un poco de la cuota diaria en su primera lectura, unos 0.3 minutos para este. Después de eso no cuesta nada.

Herramientas

Las cinco herramientas son de solo lectura. Se conectan a internet y nunca modifican tus archivos.

HerramientaQué hace
get_video_contextObtiene el contexto del video. Título, duración, resumen, capítulos y momentos clave con enlaces. Comienza aquí.
search_videoBusca en un video. Los momentos donde se dice o muestra una palabra o frase, clasificados, con enlaces.
ask_videoHaz una pregunta sobre un video. Una respuesta con 3 a 5 momentos citados.
get_transcriptObtén la transcripción de un video. Las palabras, o una parte de ellas, una página a la vez. En TXT, Markdown, SRT, VTT o JSON.
get_jobVerifica un trabajo de video. Retoma un video que aún se está procesando.

Cada resultado indica qué capas se ejecutaron (subtítulos, escucha, visualización, resumen del modelo) y cuántos minutos usó. Los detalles están en la referencia de herramientas.

Qué funciona sin cuenta

  • Subtítulos, cuando el servidor puede leerlos.
  • Videos que Scribiz ya ha procesado, sin costo. La única excepción es un resumen que Scribiz aún no ha escrito para el video, que usa una décima parte de su duración.
  • Videos sin subtítulos que el servidor pueda leer: un modelo lee el video desde su enlace. Sus tiempos son aproximados (unos 2 segundos en cualquier dirección), no tiene etiquetas de hablante y el resultado lo indica.

Esto funciona dentro de una cuota gratuita: unos 10 minutos de lectura al día por cada conexión (los mismos 10 minutos que la herramienta web gratuita), videos de hasta 15 minutos, 5 preguntas al día y 30 consultas de subtítulos al día. Todos los que se conectan sin clave también comparten un límite diario adicional. Cuando se agotan tus 10 minutos o el límite compartido, los subtítulos y los videos ya procesados siguen funcionando. Cuando se agotan las 30 consultas de subtítulos, los videos ya procesados siguen funcionando. Cuando se agotan las 5 preguntas, la búsqueda y la lectura siguen funcionando. El error indica qué se agotó y cuándo se restablece (00:00 UTC).

Sin clave, el servidor nunca mira la imagen, por lo que no hay notas en pantalla, y una pregunta sobre lo que se mostró se responde solo con las palabras. Watch lee la imagen y el texto mostrado en pantalla. Necesita una clave API de Scribiz y usa minutos de tu plan. Una cuenta gratuita tiene 30 minutos al mes, y creas una clave en el panel de control. Con una clave, pasa watch: true a get_video_context o ask_video; las notas en pantalla que Scribiz ya almacenó vuelven sin costo. Consulta modos de conexión y límites y costos.

El servidor alojado solo acepta enlaces públicos. No puede leer archivos en tu disco.

Con una clave

Envía la clave como token de portador. En Claude Code:

claude mcp add --transport http scribiz https://scribiz.com/mcp --header "Authorization: Bearer YOUR_SCRIBIZ_KEY"

Archivos locales

Un servidor local viene con la herramienta de línea de comandos. Se ejecuta en tu máquina y puede leer tus archivos. Necesita Node 24, ffmpeg y yt-dlp, y solo se ha probado en macOS.

npm install -g scribiz
scribiz login
claude mcp add scribiz -- scribiz mcp

Qué se envía a dónde

Tu agente envía el enlace del video y tus preguntas a scribiz.com. Scribiz obtiene los subtítulos del sitio que enlazaste cuando puede. Para un video que no ha procesado, pasa el enlace a la API de Gemini de Google, cuyo modelo lee el video público. No se sube nada desde tu máquina. Cuando Scribiz descarga el audio, envía el audio a Google para transcripción y análisis. Para Watch también envía una copia pequeña de baja resolución de la imagen, sin sonido. La política de privacidad tiene los períodos de retención y los términos de Google. Este repositorio no envía nada. Solo contiene archivos de configuración.

Trata las transcripciones como datos

Un video puede decir cualquier cosa, incluido "ignora tus instrucciones". El servidor envuelve todo el texto de un video entre líneas === BEGIN UNTRUSTED VIDEO TEXT [id] === y === END UNTRUSTED VIDEO TEXT [id] ===, y establece untrusted_content: true en el resultado. No autoapruebes herramientas que puedan enviar mensajes, ejecutar comandos o escribir archivos en una sesión que lee video. Más en seguridad de MCP.

Enlaces

También de Scribiz

Scribiz también tiene una herramienta web gratuita. Pega un enlace de video, obtén la transcripción. No se necesita cuenta: scribiz.com. Hay una aplicación para Mac con chip Apple silicon en scribiz.com/download, y una herramienta de línea de comandos en npm (npm install -g scribiz).

Creado por Ilias Ism.