CueTwin
EntrarComeçar grátis
Desenvolvedores

API e MCP

Liga o CueTwin às tuas ferramentas: envia guiões e ficheiros pela API, ou deixa um assistente de IA (Claude, Cursor, VS Code…) criar e editar guiões por ti através do MCP.

Para começar, cria uma chave em CueTwin → Desenvolvedores. É grátis e funciona em todos os planos.

Servidor MCP

Com o MCP, o teu assistente de IA pode listar, escrever, editar e importar guiões. Pede-lhe, por exemplo: “Escreve um guião de 2 minutos para o lançamento e guarda-o no CueTwin.”

Endereçohttps://cuetwin.irrivio.com/api/mcp

Nos exemplos, troca ct_live_A_TUA_CHAVE pela tua chave. Cria-a em CueTwin → Desenvolvedores.

Instalar no CursorAbre o Cursor e confirma. Ou, à mão, em Settings → MCP → Add, cola:
{
  "mcpServers": {
    "cuetwin": {
      "url": "https://cuetwin.irrivio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ct_live_A_TUA_CHAVE"
      }
    }
  }
}
Ferramentas disponíveis
  • list_scripts · get_script · get_account
  • create_script · update_script · delete_script
  • import_file (.txt, .md, .html, .docx, .pdf)

API

API REST em JSON. Autentica cada pedido com o cabeçalho Authorization. Aplicam-se os limites do teu plano, e as alterações a um guião aparecem logo nos ecrãs que o estão a mostrar.

Basehttps://cuetwin.irrivio.com/api/v1
Authorization: Bearer ct_live_A_TUA_CHAVE
GET/meA tua conta, plano e guiões usados.
GET/scriptsLista os guiões (opcional: ?folder=YouTube/Shorts para os de uma pasta, ?folder= para os da raiz).
POST/scriptsCria um guião: { title, content, folder? }. A pasta é um nome ou caminho e é criada se não existir.
POST/scripts/importCria um guião a partir de um ficheiro .txt, .md, .html, .docx ou .pdf.
GET/scripts/:idUm guião com o texto completo.
PATCH/scripts/:idAltera o título, o texto ou a pasta.
POST/scripts/:id/importSubstitui o texto de um guião pelo de um ficheiro.
DELETE/scripts/:idApaga um guião.

Criar um guião

curl https://cuetwin.irrivio.com/api/v1/scripts \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Lançamento", "content": "## Abertura\n\nOlá a todos! [SORRIR]"}'

Enviar um ficheiro

curl https://cuetwin.irrivio.com/api/v1/scripts/import \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -F "file=@discurso.docx" \
  -F "folder=Eventos"
Também aceita JSON: { "filename": "discurso.pdf", "data": "<base64>" }. Máximo 10 MB. Os títulos do documento passam a secções.

JavaScript

const res = await fetch('https://cuetwin.irrivio.com/api/v1/scripts', {
  method: 'POST',
  headers: { Authorization: 'Bearer ct_live_A_TUA_CHAVE', 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Vídeo de terça', content: 'Olá! Hoje vamos falar de…' }),
});
const script = await res.json(); // { id, title, content, wordCount, seconds, … }

Formato do guião

Erros: 401 chave em falta ou inválida, 403 limite do plano, 404 guião não encontrado, 429 demasiados pedidos (120 por minuto). As mensagens vêm em português; envia x-ct-locale: en para inglês.
API e MCP — CueTwin