Botverse

Transcodificação de vídeo (H.264, VP9, ProRes 422, GIF), conversão de documentos (Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX) e transcrição com identificação de falantes para agentes de IA. Cobrança por tarefa, teste gratuito de $1, sem necessidade de AWS ou FFmpeg.

Documentação

botverse-mcp

Servidor MCP e ferramenta de linha de comando para Botverse — transcodificação de vídeo e conversão de documentos para agentes de IA e para os humanos que os configuram.

npm

O que ele faz

  • Transcodificação de vídeo — MP4 (H.264), WebM (VP9), ProRes 422, GIF, extração de MP3 · US$ 0,25/trabalho
  • Conformidade de vídeo/áudio — combina uma fonte de vídeo e uma de áudio separadas em uma única saída, reconciliando incompatibilidades de taxa de quadros e duração (incluindo conformidades de velocidade estilo pulldown, ex. 24→25fps) · US$ 0,30/trabalho
  • Splice de conformidade — concatena segmentos de vídeo e/ou imagens estáticas em uma única saída: slates de abertura/vinhetas, slates de encerramento/cartões finais, inserções/cutaways no meio do vídeo ou junção de clipes · a partir de US$ 0,30/trabalho
  • Conversão de documentos — Markdown ↔ DOCX ↔ PDF ↔ HTML ↔ XLSX · US$ 0,05/arquivo
  • Transcrição — transcrições com identificação de falantes (diarização + nomeação de falantes por IA) → txt/srt/vtt/docx/pdf · ~US$ 3/hora
  • Workflows — encadeie múltiplas operações do Botverse (transcodificar, converter, transcrever, conformar, emendar) em um único trabalho de múltiplas etapas com ordenação automática de dependências e ramificações paralelas, em vez de orquestrar cada chamada você mesmo · etapas somente de conversão são cobradas no saldo da carteira (US$ 0,05/etapa); etapas de transcodificação/transcrição são cobradas pela duração da fonte e exigem recarga automática

Duas formas de usar: um servidor MCP para seus agentes de IA e uma CLI botverse para o shell — avaliação, CI/CD, cron, scripts e agentes de codificação locais. Sem AWS. Sem FFmpeg. Sem infraestrutura.

Configuração

  1. Cadastre-se em botverse.cloud — grátis para testar: crédito de US$ 1 no cadastro, sem necessidade de cartão. Um cartão + 2FA só são necessários no seu primeiro recarregamento (mínimo de US$ 5). Sem taxas mensais.
  2. Obtenha uma chave de API ou URL de conector no seu painel
  3. Adicione à configuração do seu cliente MCP

Uso

Claude Desktop / Cursor / Windsurf

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_API_KEY": "bv_live_..."
      }
    }
  }
}

Ou com uma URL de conector (recomendado para claude.ai):

{
  "mcpServers": {
    "botverse": {
      "command": "npx",
      "args": ["-y", "botverse-mcp"],
      "env": {
        "BOTVERSE_CONNECTOR_URL": "https://botverse.cloud/mcp?token=bv_sess_..."
      }
    }
  }
}

Linha de comando (botverse)

O mesmo pacote inclui uma CLI botverse para o shell — ela lê arquivos do disco e os transmite diretamente para a API (nenhum conteúdo passa por um LLM), então é o caminho rápido para avaliação, automação e agentes de codificação locais.

export BOTVERSE_API_KEY=bv_live_…        # or BOTVERSE_CONNECTOR_URL=…?token=bv_sess_…

npx botverse convert report.md --to pdf
npx botverse convert *.md --to docx,pdf -o ./out
npx botverse transcode clip.mov --to mp4 -o ./out
npx botverse transcribe call.mp4 --to docx --attendees "Sarah Chen,Mike Torres"
npx botverse conform video.mp4 audio.wav --to mp4 --method speed_conform --target-framerate 25
npx botverse balance

Cada trabalho faz upload → consulta → baixa o arquivo final para -o (padrão: diretório atual). Globs e múltiplos formatos --to são executados em lote.

Nota sobre sandbox: a CLI precisa de acesso de rede de saída para botverse.cloud e para o host de armazenamento de arquivos do Botverse, portanto ela não executa dentro de ambientes de agente em sandbox (claude.ai / Claude Desktop), cujo tráfego de saída é permitido por lista. Nesses casos, use as ferramentas MCP (ex.: convert_content).

Ferramentas (MCP)

FerramentaDescrição
get_upload_urlObtenha uma URL pré-assinada para enviar um arquivo para uso com as ferramentas _media/_file/_video (baseadas em chave de objeto)
transcode_from_urlTranscodifique vídeo a partir de uma URL pública
transcode_videoTranscodifique um arquivo de vídeo enviado
conform_from_urlCombine uma fonte de vídeo + áudio separadas (URLs públicas) em uma única saída
conform_mediaCombine uma fonte de vídeo + áudio enviadas em uma única saída
conform_splice_from_urlConcatene segmentos de vídeo/imagem (URLs públicas) — slates, vinhetas, cartões finais, inserções, clipes unidos
conform_splice_mediaConcatene segmentos de vídeo/imagem enviados — mesmos casos de uso
convert_contentConverta conteúdo de documento inline (até 4 MB; seguro para sandbox)
convert_from_urlConverta um documento a partir de uma URL pública
convert_fileConverta um documento enviado
submit_workflowEnvie um workflow BWDL de múltiplas etapas encadeando várias das ferramentas acima, com ordenação de dependências e ramificações paralelas
get_workflow_statusConsulte um workflow (e o status de cada etapa) até que ele atinja um estado terminal
cancel_workflowCancele um workflow em andamento; etapas já concluídas são cobradas, as demais não
get_job_statusConsulte um trabalho até a conclusão
get_download_urlObtenha a URL de download assinada
get_wallet_balanceVerifique o saldo da carteira

Workflows

submit_workflow encadeia múltiplas ferramentas do Botverse (transcodificar, converter, transcrever, conformar, emendar) em um único trabalho no servidor — ex.: transcrever → extrair clipe → entrega — em vez de seu agente fazer cada chamada e consultar cada uma individualmente.

  • As definições de workflow usam BWDL (Botverse Workflow Definition Language): um objeto JSON com um workflow_id e um array steps. Cada etapa tem um id, um tool (qualquer nome de ferramenta MCP), um objeto inputs e um array opcional depends_on de ids de etapas anteriores.
  • As etapas são executadas em ordem de dependência; etapas que compartilham o mesmo depends_on são executadas em paralelo.
  • Uma etapa posterior pode referenciar a saída de uma etapa anterior com "$.steps.<step_id>.output_key", e um parâmetro de nível de workflow com "$.params.<name>" — nenhuma outra sintaxe de template é suportada.
  • Envie com submit_workflow, consulte com get_workflow_status a cada 5–10 segundos até que o status seja COMPLETED, FAILED, PARTIALLY_FAILED ou CANCELLED, e pare antecipadamente com cancel_workflow se necessário (você só é cobrado pelas etapas que já foram concluídas).
  • Cobrança: workflows somente de conversão são executados no saldo da carteira a US$ 0,05/etapa. Workflows que contêm uma etapa de transcodificação ou transcrição exigem recarga automática habilitada (a cobrança é proporcional à duração da fonte).

Exemplo — uma cadeia de conversão de duas etapas (URL → DOCX → PDF):

{
  "workflow_id": "md-to-pdf-via-docx",
  "steps": [
    {
      "id": "to_docx",
      "tool": "convert_from_url",
      "inputs": {
        "source_url": "https://example.com/report.md",
        "output_format": "docx"
      }
    },
    {
      "id": "to_pdf",
      "tool": "convert_file",
      "depends_on": ["to_docx"],
      "inputs": {
        "object_key": "$.steps.to_docx.output_key",
        "output_format": "pdf"
      }
    }
  ]
}

Preços

  • Transcodificação de vídeo (≤5 min): US$ 0,25/trabalho
  • Excedente de vídeo: +US$ 0,08/min
  • ProRes 422: US$ 0,35/min de fonte (mínimo de US$ 0,50)
  • Conversão de documentos: US$ 0,05/arquivo

Os créditos nunca expiram. Preços completos →

Links