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.
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
- 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.
- Obtenha uma chave de API ou URL de conector no seu painel
- 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.cloude 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)
| Ferramenta | Descrição |
|---|---|
get_upload_url | Obtenha uma URL pré-assinada para enviar um arquivo para uso com as ferramentas _media/_file/_video (baseadas em chave de objeto) |
transcode_from_url | Transcodifique vídeo a partir de uma URL pública |
transcode_video | Transcodifique um arquivo de vídeo enviado |
conform_from_url | Combine uma fonte de vídeo + áudio separadas (URLs públicas) em uma única saída |
conform_media | Combine uma fonte de vídeo + áudio enviadas em uma única saída |
conform_splice_from_url | Concatene segmentos de vídeo/imagem (URLs públicas) — slates, vinhetas, cartões finais, inserções, clipes unidos |
conform_splice_media | Concatene segmentos de vídeo/imagem enviados — mesmos casos de uso |
convert_content | Converta conteúdo de documento inline (até 4 MB; seguro para sandbox) |
convert_from_url | Converta um documento a partir de uma URL pública |
convert_file | Converta um documento enviado |
submit_workflow | Envie 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_status | Consulte um workflow (e o status de cada etapa) até que ele atinja um estado terminal |
cancel_workflow | Cancele um workflow em andamento; etapas já concluídas são cobradas, as demais não |
get_job_status | Consulte um trabalho até a conclusão |
get_download_url | Obtenha a URL de download assinada |
get_wallet_balance | Verifique 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_ide um arraysteps. Cada etapa tem umid, umtool(qualquer nome de ferramenta MCP), um objetoinputse um array opcionaldepends_onde ids de etapas anteriores. - As etapas são executadas em ordem de dependência; etapas que compartilham o mesmo
depends_onsã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 comget_workflow_statusa cada 5–10 segundos até que o status sejaCOMPLETED,FAILED,PARTIALLY_FAILEDouCANCELLED, e pare antecipadamente comcancel_workflowse 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 →