CueTwin
AccediInizia gratis
Sviluppatori

API e MCP

Collega CueTwin ai tuoi strumenti: invia copioni e file tramite l’API, o lascia che un assistente IA (Claude, Cursor, VS Code…) crei e modifichi copioni per te tramite MCP.

Per iniziare, crea una chiave inCueTwin → Sviluppatori. È gratis e funziona con tutti i piani.

Server MCP

Con MCP, il tuo assistente IA può elencare, scrivere, modificare e importare copioni. Chiedigli per esempio: «Scrivi un copione di 2 minuti per il lancio e salvalo in CueTwin».

URLhttps://cuetwin.irrivio.com/api/mcp

Negli esempi, sostituisci ct_live_A_TUA_CHAVE con la tua chiave. Creala in CueTwin → Sviluppatori.

Installa in CursorApre Cursor per confermare. Oppure, a mano, in Settings → MCP → Add, incolla:
{
  "mcpServers": {
    "cuetwin": {
      "url": "https://cuetwin.irrivio.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ct_live_A_TUA_CHAVE"
      }
    }
  }
}
Strumenti disponibili
  • list_scripts · get_script · get_account
  • create_script · update_script · delete_script
  • import_file (.txt, .md, .html, .docx, .pdf)

API

Un’API REST in JSON. Autentica ogni richiesta con l’intestazione Authorization. Valgono i limiti del tuo piano, e le modifiche a un copione appaiono subito sugli schermi che lo mostrano.

URL di basehttps://cuetwin.irrivio.com/api/v1
Authorization: Bearer ct_live_A_TUA_CHAVE
GET/meIl tuo account, il piano e i copioni usati.
GET/scriptsElenca i copioni (facoltativo: ?folder=YouTube/Shorts per una cartella, ?folder= per la principale).
POST/scriptsCrea un copione: { title, content, folder? }. La cartella è un nome o un percorso e viene creata se non esiste.
POST/scripts/importCrea un copione da un file .txt, .md, .html, .docx o .pdf.
GET/scripts/:idUn copione con il testo completo.
PATCH/scripts/:idCambia titolo, testo o cartella.
POST/scripts/:id/importSostituisce il testo di un copione con quello di un file.
DELETE/scripts/:idElimina un copione.

Crea un copione

curl https://cuetwin.irrivio.com/api/v1/scripts \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Lancio", "content": "## Apertura\n\nCiao a tutti! [SORRIDI]"}'

Carica un file

curl https://cuetwin.irrivio.com/api/v1/scripts/import \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -F "file=@discorso.docx" \
  -F "folder=Eventi"
Accetta anche JSON: { "filename": "discorso.pdf", "data": "<base64>" }. Massimo 10 MB. I titoli del documento diventano sezioni.

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: 'Video del martedì', content: 'Ciao! Oggi parliamo di…' }),
});
const script = await res.json(); // { id, title, content, wordCount, seconds, … }

Formato del copione

Errori: 401 chiave mancante o non valida, 403 limite del piano, 404 copione non trovato, 429 troppe richieste (120 al minuto). Invia x-ct-locale: en per ricevere i messaggi in inglese.
API e MCP — CueTwin