UnMarkAI

unmarkai-skills

Habilidades de agente para UnmarkAI — deixe Claude, Codex, Cursor, opencode e qualquer agente compatível com MCP removerem textos fixos (legendas, legendas ocultas, títulos na tela) de vídeos que você possui com um único UNMARKAI_API_KEY e nenhuma outra configuração.

Página do produto: API de Remoção de Texto em Vídeo & Servidor MCP.

Duas formas de conectar, o mesmo mecanismo por baixo:

• Servidor MCP remoto (recomendado): https://api.unmarkai.net/mcp
• REST simples (sem necessidade de suporte a MCP): passo a passo completo com curl em skills/unmarkai-remove-text/references/curl-fallback.md

O que você obtém

Ferramentas	create_upload, remove_text, get_job, list_jobs, cancel_job, get_balance, estimate_cost
Preços	Por segundo, arredondado para cima, mínimo de 1s — all_area $0,010/s, sel_area $0,005/s (região parcial, ~metade do preço)
Limites	Máx. 2 GiB / 60 min por vídeo; mp4 / mov / avi / mkv / webm / mpeg
Resultado	Link de download assinado, válido por 1 hora (arquivo mantido por 7 dias)
Limites de taxa	50 chamadas de escrita / 120 chamadas de leitura por minuto

Configuração: obtenha uma chave

1. Entre em unmarkai.net e abra o Console de API (Painel → API).
2. Crie uma chave de API com os escopos jobs:read, jobs:write, balance:read.
3. Recarregue a carteira da API (pagamento conforme o uso).
4. Exporte-a:

export UNMARKAI_API_KEY="uma_live_xxxxxxxxxxxx"

Conecte seu agente (MCP remoto)

Claude Code

claude mcp add --transport http unmarkai https://api.unmarkai.net/mcp \
  --header "Authorization: Bearer $UNMARKAI_API_KEY"

Em seguida, instale a habilidade para que o Claude Code siga o fluxo completo (seleção de modo, margens de retângulo, triagem de erros):

mkdir -p ~/.claude/skills && \
  cp -r skills/unmarkai-remove-text ~/.claude/skills/

Claude Desktop

O Claude Desktop não fala com servidores MCP HTTP remotos nativamente — faça a ponte com mcp-remote em claude_desktop_config.json:

{
  "mcpServers": {
    "unmarkai": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unmarkai.net/mcp",
        "--header",
        "Authorization: Bearer uma_live_xxxxxxxxxxxx"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "unmarkai": {
      "type": "http",
      "url": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — mesmo formato do Cursor, mas com o tipo streamable-HTTP (veja a documentação do Windsurf para sua versão):

{
  "mcpServers": {
    "unmarkai": {
      "type": "streamableHttp",
      "url": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Codex CLI

Streamable HTTP ainda é experimental no Codex — habilite o cliente RMCP e declare o servidor em ~/.codex/config.toml:

experimental_use_rmcp_client = true

[mcp_servers.unmarkai]
url = "https://api.unmarkai.net/mcp"
bearer_token = "uma_live_xxxxxxxxxxxx"

O Codex não tem sistema nativo de habilidades; coloque as instruções de fluxo no seu AGENTS.md — veja codex/AGENTS-snippet.md. Se o cliente HTTP experimental se comportar mal na sua versão do Codex, use o fluxo com curl como alternativa.

opencode

~/.config/opencode/opencode.json (ou opencode.json em um projeto):

{
  "mcp": {
    "unmarkai": {
      "type": "remote",
      "url": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json:

{
  "mcpServers": {
    "unmarkai": {
      "httpUrl": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Experimente

Depois de conectado, basta pedir:

Remova as legendas fixas de draft.mp4 (é meu próprio vídeo). Estime o custo primeiro, use o modo mais barato que cubra a área das legendas e baixe a versão limpa ao lado do original.

O agente analisará o vídeo, apresentará o orçamento, fará o upload com um ticket de uso único, criará o trabalho, aguardará a conclusão e baixará o resultado.

Verifique a conexão

curl -sS -X POST https://api.unmarkai.net/mcp \
  -H "Authorization: Bearer $UNMARKAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Um resultado JSON-RPC listando as sete ferramentas significa que tudo funciona. 401 unauthorized means the key is wrong; 404 significa que você acessou a URL errada.

Solução de problemas

Sintoma	Correção
unauthorized	A chave deve começar com uma_live_ e estar ativa; verifique o Console de API
insufficient_scope	Recrie a chave com jobs:read jobs:write balance:read
rate_limit_exceeded	Reduza a frequência — os agentes devem consultar no máximo uma vez a cada 2s
insufficient_balance	Recarregue a carteira da API no painel
O cliente não consegue conectar ao MCP remoto	Verifique a sintaxe do cliente acima para o formato exato da configuração; no pior caso, use o fallback com curl
Upload PUT retorna 412	Os tickets de upload são de uso único — solicite um novo

Notas de segurança

• A chave permite gastos da sua carteira de API — trate-a como um cartão de crédito.
• Prefira expansão de variável de ambiente ($UNMARKAI_API_KEY) em vez de colar literais em arquivos de configuração quando o cliente suportar.
• Gire a chave no Console de API se ela vazar; revogue imediatamente se for compartilhada em um repositório (git rm --cached + reescreva o histórico).

Uso responsável

Esta ferramenta é para vídeos que você possui ou está autorizado a modificar. A habilidade inclui uma proteção que recusa trabalhos direcionados a avisos de atribuição, rótulos de proveniência (incluindo divulgações de conteúdo gerado por IA) ou texto legal. Remover tais marcadores de conteúdo que você não controla pode ser ilegal — não faça isso.

Licença

MIT © DayBreak-u