CueTwin
Iniciar sesiónEmpezar gratis
Desarrolladores

API y MCP

Conecta CueTwin con tus herramientas: envía guiones y archivos por la API, o deja que un asistente de IA (Claude, Cursor, VS Code…) cree y edite guiones por ti mediante MCP.

Para empezar, crea una clave enCueTwin → Desarrolladores. Es gratis y funciona en todos los planes.

Servidor MCP

Con MCP, tu asistente de IA puede listar, escribir, editar e importar guiones. Pídele, por ejemplo: «Escribe un guion de 2 minutos para el lanzamiento y guárdalo en CueTwin».

URLhttps://cuetwin.com/api/mcp

En los ejemplos, sustituye ct_live_A_TUA_CHAVE por tu clave. Créala en CueTwin → Desarrolladores.

Instalar en CursorAbre Cursor para confirmar. O, a mano, en Settings → MCP → Add, pega:
{
  "mcpServers": {
    "cuetwin": {
      "url": "https://cuetwin.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ct_live_A_TUA_CHAVE"
      }
    }
  }
}
Herramientas disponibles
  • list_scripts · get_script · get_account
  • create_script · update_script · delete_script
  • import_file (.txt, .md, .html, .docx, .pdf)

API

Una API REST en JSON. Autentica cada petición con la cabecera Authorization. Se aplican los límites de tu plan, y los cambios en un guion aparecen al momento en las pantallas que lo muestran.

URL basehttps://cuetwin.com/api/v1
Authorization: Bearer ct_live_A_TUA_CHAVE
GET/meTu cuenta, plan y guiones usados.
GET/scriptsLista los guiones (opcional: ?folder=YouTube/Shorts para una carpeta, ?folder= para la raíz).
POST/scriptsCrea un guion: { title, content, folder? }. La carpeta es un nombre o ruta y se crea si no existe.
POST/scripts/importCrea un guion a partir de un archivo .txt, .md, .html, .docx o .pdf.
GET/scripts/:idUn guion con su texto completo.
PATCH/scripts/:idCambia el título, el texto o la carpeta.
POST/scripts/:id/importSustituye el texto de un guion por el de un archivo.
DELETE/scripts/:idElimina un guion.

Crear un guion

curl https://cuetwin.com/api/v1/scripts \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Lanzamiento", "content": "## Apertura\n\n¡Hola a todos! [SONREÍR]"}'

Subir un archivo

curl https://cuetwin.com/api/v1/scripts/import \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -F "file=@discurso.docx" \
  -F "folder=Eventos"
También acepta JSON: { "filename": "discurso.pdf", "data": "<base64>" }. Máximo 10 MB. Los títulos del documento pasan a ser secciones.

JavaScript

const res = await fetch('https://cuetwin.com/api/v1/scripts', {
  method: 'POST',
  headers: { Authorization: 'Bearer ct_live_A_TUA_CHAVE', 'Content-Type': 'application/json' },
  body: JSON.stringify({ title: 'Vídeo del martes', content: '¡Hola! Hoy hablamos de…' }),
});
const script = await res.json(); // { id, title, content, wordCount, seconds, … }

Formato del guion

Errores: 401 clave ausente o no válida, 403 límite del plan, 404 guion no encontrado, 429 demasiadas peticiones (120 por minuto). Envía x-ct-locale: en para recibir los mensajes en inglés.
API y MCP — CueTwin