Scribiz

Dê ao seu agente de IA o contexto de um link de vídeo: transcrição, resumo, capítulos e respostas com marcação de tempo. Hospedado, remoto, sem necessidade de conta ou chave.

GitHub

Experimente este MCPPatrocinado

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Scribiz: servidor MCP de vídeo para transcrições, resumos e timestamps do YouTube

Dê ao Claude, Cursor, Codex ou qualquer cliente MCP o contexto de um vídeo a partir do seu link: a transcrição, um resumo, capítulos e os momentos exatos que respondem a uma pergunta, cada um com um link de timestamp. Funciona com links do YouTube, TikTok, Instagram, X e Vimeo. Não é necessária conta nem chave de API para começar.

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

Assista à demonstração de 48 segundos. Cada resposta nela é uma chamada real ao servidor.

Este repositório contém os arquivos de configuração para o servidor MCP hospedado do Scribiz em https://scribiz.com/mcp. O servidor roda em scribiz.com. O código-fonte do Scribiz não está neste repositório.

O que o agente faz com ele

Você cola um link de vídeo em um chat. O agente pede ao Scribiz uma visão geral curta primeiro. Ele busca a parte de que precisa, lê apenas essa parte e responde com um link que abre o vídeo naquele momento. Ele não lê uma transcrição inteira para responder a uma pergunta.

Como adicionar

O servidor hospedado não precisa de conta nem de chave. Adicione a URL e ele funciona.

Claude Code

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

Execute /mcp dentro do Claude Code para ver o servidor e suas ferramentas.

Claude Desktop e claude.ai

Vá em Customize e depois Connectors. Selecione + Add e depois Add custom connector. Digite:

Nome: Scribiz
URL: https://scribiz.com/mcp
Autenticação: No sign in

O arquivo claude_desktop_config.json é uma configuração separada para servidores locais. Você não precisa dele para o servidor hospedado.

Cursor

Coloque isto em ~/.cursor/mcp.json, ou em .cursor/mcp.json dentro de um projeto:

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

VS Code

Coloque isto em .vscode/mcp.json. O VS Code usa servers, não mcpServers.

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

Codex

Adicione isto a ~/.codex/config.toml:

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

Plugin do Claude Code (servidor e skill juntos)

Este repositório também é um marketplace de plugins do Claude Code. O plugin adiciona o servidor e uma skill que ensina o Claude a usá-lo.

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

Use o plugin ou a linha claude mcp add acima, não ambos. Outros agentes podem instalar apenas a skill:

npx skills add Illyism/scribiz-mcp

Experimente

Pergunte ao seu agente:

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

Este é um vídeo público de 19 segundos, "Me at the zoo". Você deve ver uma chamada a get_video_context, depois search_video e uma resposta com um link de timestamp. O resultado diz como a transcrição foi feita. Quando um modelo lê o link, os horários são aproximados (cerca de 2 segundos para mais ou para menos). Um vídeo que o Scribiz ainda não processou usa um pouco da cota do dia na primeira leitura, cerca de 0,3 minutos para este. Depois disso, não custa nada.

Ferramentas

Todas as cinco ferramentas são somente leitura. Elas acessam a internet e nunca alteram seus arquivos.

Ferramenta	O que faz
`get_video_context`	Obtém o contexto do vídeo. Título, duração, resumo, capítulos e momentos-chave com links. Comece por aqui.
`search_video`	Pesquisa em um vídeo. Os momentos em que uma palavra ou frase é dita ou mostrada, classificados, com links.
`ask_video`	Faz uma pergunta sobre um vídeo. Uma resposta com 3 a 5 momentos citados.
`get_transcript`	Obtém a transcrição de um vídeo. As palavras, ou uma parte delas, uma página por vez. Em TXT, Markdown, SRT, VTT ou JSON.
`get_job`	Verifica um job de vídeo. Retoma um vídeo que ainda está sendo processado.

Todo resultado diz quais camadas foram executadas (legendas, escuta, visualização, resumo do modelo) e quantos minutos foram usados. Os detalhes estão na referência de ferramentas.

O que funciona sem conta

Legendas, quando o servidor consegue lê-las.
Vídeos que o Scribiz já processou, sem custo. A única exceção é um resumo que o Scribiz ainda não escreveu para o vídeo, que usa um décimo da duração dele.
Vídeos sem legendas que o servidor consiga ler: um modelo lê o vídeo a partir do link. Os horários são aproximados (cerca de 2 segundos para mais ou para menos), não há rótulos de falante e o resultado informa isso.

Isso roda dentro de uma cota gratuita: cerca de 10 minutos de leitura por dia para cada conexão (os mesmos 10 minutos da ferramenta web gratuita), vídeos de até 15 minutos, 5 perguntas por dia e 30 consultas de legendas por dia. Todos que se conectam sem chave também compartilham mais um limite diário. Quando seus 10 minutos ou o limite compartilhado acabam, legendas e vídeos já processados ainda funcionam. Quando as 30 consultas de legendas acabam, vídeos já processados ainda funcionam. Quando as 5 perguntas acabam, pesquisa e leitura ainda funcionam. O erro informa o que foi usado e quando reinicia (00:00 UTC).

Sem chave, o servidor nunca olha a imagem, então não há notas na tela, e uma pergunta sobre o que foi mostrado é respondida apenas pelas palavras. O Watch lê a imagem e o texto exibido na tela. Ele precisa de uma chave de API do Scribiz e usa minutos do seu plano. Uma conta gratuita tem 30 minutos por mês, e você cria uma chave no painel. Com uma chave, passe watch: true para get_video_context ou ask_video; notas na tela que o Scribiz já armazenou voltam sem custo. Veja modos de conexão e limites e custos.

O servidor hospedado aceita apenas links públicos. Ele não consegue ler arquivos do seu disco.

Com uma chave

Envie a chave como um token bearer. No Claude Code:

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

Arquivos locais

Um servidor local vem com a ferramenta de linha de comando. Ele roda na sua máquina e pode ler seus arquivos. Ele precisa de Node 24, ffmpeg e yt-dlp, e foi testado apenas no macOS.

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

O que é enviado para onde

Seu agente envia o link do vídeo e suas perguntas para scribiz.com. O Scribiz busca as legendas do site que você vinculou quando consegue. Para um vídeo que ainda não processou, ele passa o link para a API Gemini do Google, cujo modelo lê o vídeo público. Nada é enviado da sua máquina. Quando o Scribiz baixa o áudio, ele envia o áudio ao Google para transcrição e análise. Para o Watch, ele também envia uma pequena cópia de baixa resolução da imagem, sem som. A política de privacidade tem os períodos de retenção e os termos do Google. Este repositório não envia nada. Ele contém apenas arquivos de configuração.

Trate transcrições como dados

Um vídeo pode dizer qualquer coisa, incluindo "ignore suas instruções". O servidor envolve todo texto de um vídeo entre linhas === BEGIN UNTRUSTED VIDEO TEXT [id] === e === END UNTRUSTED VIDEO TEXT [id] === e define untrusted_content: true no resultado. Não aprove automaticamente ferramentas que possam enviar mensagens, executar comandos ou gravar arquivos em uma sessão que lê vídeo. Mais em segurança MCP.

Também do Scribiz

O Scribiz também tem uma ferramenta web gratuita. Cole um link de vídeo e obtenha a transcrição. Sem necessidade de conta: scribiz.com. Há um aplicativo para Mac com chip Apple silicon em scribiz.com/download e uma ferramenta de linha de comando no npm (npm install -g scribiz).

Criado por Ilias Ism.