CueTwin
Se connecterCommencer gratuitement
Développeurs

API et MCP

Connectez CueTwin à vos outils : envoyez textes et fichiers via l’API, ou laissez un assistant IA (Claude, Cursor, VS Code…) créer et modifier vos textes via MCP.

Pour commencer, créez une clé dansCueTwin → Développeurs. C’est gratuit et disponible dans tous les forfaits.

Serveur MCP

Avec MCP, votre assistant IA peut lister, écrire, modifier et importer des textes. Demandez-lui par exemple : « Écris un texte de 2 minutes pour le lancement et enregistre-le dans CueTwin. »

URLhttps://cuetwin.com/api/mcp

Dans les exemples, remplacez ct_live_A_TUA_CHAVE par votre clé. Créez-la dans CueTwin → Développeurs.

Installer dans CursorOuvre Cursor pour confirmer. Ou, à la main, dans Settings → MCP → Add, collez :
{
  "mcpServers": {
    "cuetwin": {
      "url": "https://cuetwin.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ct_live_A_TUA_CHAVE"
      }
    }
  }
}
Outils disponibles
  • list_scripts · get_script · get_account
  • create_script · update_script · delete_script
  • import_file (.txt, .md, .html, .docx, .pdf)

API

Une API REST en JSON. Authentifiez chaque requête avec l’en-tête Authorization. Les limites de votre forfait s’appliquent, et les modifications d’un texte apparaissent aussitôt sur les écrans qui l’affichent.

URL de basehttps://cuetwin.com/api/v1
Authorization: Bearer ct_live_A_TUA_CHAVE
GET/meVotre compte, votre forfait et les textes utilisés.
GET/scriptsListe les textes (facultatif : ?folder=YouTube/Shorts pour un dossier, ?folder= pour la racine).
POST/scriptsCrée un texte : { title, content, folder? }. Le dossier est un nom ou un chemin, créé s’il n’existe pas.
POST/scripts/importCrée un texte à partir d’un fichier .txt, .md, .html, .docx ou .pdf.
GET/scripts/:idUn texte avec son contenu complet.
PATCH/scripts/:idModifie le titre, le texte ou le dossier.
POST/scripts/:id/importRemplace le texte d’un script par celui d’un fichier.
DELETE/scripts/:idSupprime un texte.

Créer un texte

curl https://cuetwin.com/api/v1/scripts \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"title": "Lancement", "content": "## Ouverture\n\nBonjour à tous ! [SOURIRE]"}'

Envoyer un fichier

curl https://cuetwin.com/api/v1/scripts/import \
  -H "Authorization: Bearer ct_live_A_TUA_CHAVE" \
  -F "file=@discours.docx" \
  -F "folder=Evenements"
Le JSON fonctionne aussi : { "filename": "discours.pdf", "data": "<base64>" }. 10 Mo maximum. Les titres du document deviennent des sections.

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: 'Vidéo du mardi', content: 'Salut ! Aujourd’hui on parle de…' }),
});
const script = await res.json(); // { id, title, content, wordCount, seconds, … }

Format du texte

Erreurs : 401 clé absente ou invalide, 403 limite du forfait, 404 texte introuvable, 429 trop de requêtes (120 par minute). Envoyez x-ct-locale: en pour recevoir les messages en anglais.
API et MCP — CueTwin