Aller au contenu

Exemples d’usage du MCP

Ces exemples montrent les appels d’outils que fait un agent IA en coulisse. Vous n’avez pas à les écrire : décrivez ce que vous voulez en langage naturel, votre agent s’occupe du reste.

  1. Lister les canaux

    L’agent appelle integrationList et trouve votre compte Instagram :

    {
    "output": [
    {
    "id": "abc123",
    "name": "vincentleserpent",
    "picture": "https://...",
    "platform": "instagram-standalone"
    }
    ]
    }
  2. Lire le schéma de la plateforme

    L’agent appelle integrationSchema avec platform: "instagram-standalone" pour connaître les règles :

    {
    "output": {
    "rules": "Instagram should have at least one attachment, if it's a story, it can have only one picture",
    "maxLength": 2200,
    "settings": { "post_type": "post | story", "...": "..." },
    "tools": []
    }
    }
  3. Planifier la publication

    L’agent appelle integrationSchedulePostTool :

    {
    "socialPost": [
    {
    "integrationId": "abc123",
    "isPremium": false,
    "date": "2026-10-02T10:00:00.000Z",
    "shortLink": false,
    "type": "schedule",
    "postsAndComments": [
    {
    "content": "<p>Trois choses que personne ne dit sur Malte.</p>",
    "attachments": ["https://app.usenadia.com/uploads/reel.mp4"]
    }
    ],
    "settings": [
    { "key": "post_type", "value": "post" }
    ]
    }
    ]
    }

Une publication de type story publie une story par pièce jointe, dans l’ordre :

{
"socialPost": [
{
"integrationId": "abc123",
"date": "2026-10-02T18:00:00.000Z",
"type": "schedule",
"postsAndComments": [
{
"content": "<p></p>",
"attachments": [
"https://app.usenadia.com/uploads/story-1.jpg",
"https://app.usenadia.com/uploads/story-2.jpg",
"https://app.usenadia.com/uploads/story-3.jpg"
]
}
],
"settings": [{ "key": "post_type", "value": "story" }]
}
]
}

Un reel d’essai (trial reel) est d’abord montré à des non-abonnés, puis promu. Il doit contenir exactement une vidéo, et Instagram ne l’accepte que d’un compte professionnel public d’au moins 200 abonnés : en dessous, UseNadia refuse de le programmer et dit pourquoi.

{
"settings": [
{ "key": "post_type", "value": "post" },
{ "key": "is_trial_reel", "value": true },
{ "key": "graduation_strategy", "value": "SS_PERFORMANCE" }
]
}

Avec MANUAL, le reel est promu quand vous le décidez ; avec SS_PERFORMANCE, quand Instagram juge qu’il marche assez bien.

  1. Lire le schéma

    integrationSchema avec platform: "tiktok" renvoie une limite de 2 000 caractères et les réglages ci-dessous.

  2. Planifier

    {
    "socialPost": [
    {
    "integrationId": "tiktok-123",
    "date": "2026-10-02T10:00:00.000Z",
    "type": "schedule",
    "postsAndComments": [
    {
    "content": "<p>Trois choses que personne ne dit sur Malte.</p>",
    "attachments": ["https://app.usenadia.com/uploads/video.mp4"]
    }
    ],
    "settings": [
    { "key": "content_posting_method", "value": "DIRECT_POST" },
    { "key": "privacy_level", "value": "PUBLIC_TO_EVERYONE" },
    { "key": "duet", "value": true },
    { "key": "stitch", "value": true },
    { "key": "comment", "value": true },
    { "key": "autoAddMusic", "value": "no" },
    { "key": "brand_content_toggle", "value": false },
    { "key": "brand_organic_toggle", "value": false }
    ]
    }
    ]
    }

socialPost est un tableau : un appel, plusieurs canaux, un bloc de réglages pour chacun.

{
"socialPost": [
{
"integrationId": "instagram-1",
"date": "2026-10-02T10:00:00.000Z",
"type": "schedule",
"postsAndComments": [
{ "content": "<p>…</p>", "attachments": ["https://app.usenadia.com/uploads/video.mp4"] }
],
"settings": [{ "key": "post_type", "value": "post" }]
},
{
"integrationId": "tiktok-1",
"date": "2026-10-02T10:00:00.000Z",
"type": "schedule",
"postsAndComments": [
{ "content": "<p>…</p>", "attachments": ["https://app.usenadia.com/uploads/video.mp4"] }
],
"settings": [
{ "key": "content_posting_method", "value": "DIRECT_POST" },
{ "key": "privacy_level", "value": "PUBLIC_TO_EVERYONE" }
]
}
]
}

Ajouter un commentaire sous une publication Instagram

Section intitulée « Ajouter un commentaire sous une publication Instagram »

Les éléments en plus dans postsAndComments sont publiés comme commentaires sous votre propre publication :

{
"postsAndComments": [
{ "content": "<p>Trois choses que personne ne dit sur Malte.</p>", "attachments": ["https://app.usenadia.com/uploads/reel.mp4"] },
{ "content": "<p>Le guide complet est en bio 👆</p>", "attachments": [] }
]
}

Cet outil n’existe pas dans upstream. Il lit l’historique collecté, pas la plateforme.

  1. Appeler videoPerformance

    {
    "integrationId": "abc123",
    "limit": 10
    }
  2. Lire la réponse à âge égal

    La réponse donne le viewsAtAge de chaque vidéo (H+4 … H+168) et, pour la vidéo étudiée, son rang et la médiane à cet âge, plus une projection à H+120 tirée du multiplicateur H+24 → H+120 propre au canal.

Un canal sans rien de collecté encore répond collected: false et dit pourquoi : voir Analyses → Historique.

{
"postId": "post-123",
"date": "2026-10-03 18:00:00"
}

Récupérez d’abord l’ID avec postsListTool. Un déplacement se défait, il ne demande donc pas de confirmation, mais une publication déjà sortie ne se déplace pas, et l’outil le dit au lieu d’échouer en silence.

  1. Générer l’image

    L’agent appelle generateImageTool avec un prompt et récupère une URL hébergée.

  2. Planifier avec elle

    Cette URL va directement dans attachments.

Une pièce jointe qui n’est pas sur le domaine de UseNadia échoue à la vérification du domaine de téléversement. Importez-la d’abord :

{
"url": "https://cdn.example.com/render-42.mp4"
}

uploadFromUrlTool renvoie { id, path, contentType, size, duration, width, height, codec } ; mettez path dans attachments, et comparez size et duration avec la source quand elle vous les a donnés.

Couper une vidéo de téléphone à la fin d’une phrase

Section intitulée « Couper une vidéo de téléphone à la fin d’une phrase »

Vous avez téléversé un clip depuis votre téléphone et voulez le publier sans sa dernière phrase. L’agent enchaîne quatre outils :

  1. mediaList avec { "type": "video", "limit": 1 } : le dernier téléversement, son path et sa duration.
  2. transcribe avec { "path": "<path>" } : les phrases avec leurs horodatages. Disons que la deuxième se termine à 24.45.
  3. cutVideo avec { "path": "<path>", "cuts": [24.45] } : deux nouvelles vidéos, 0 → 24.45 et 24.45 → end. Cela prend un moment : l’agent le dit d’abord.
  4. integrationSchedulePostTool avec le path de la première partie dans attachments.

Pour ne garder que certains passages, passez plutôt segments : { "path": "<path>", "segments": [{ "start": 3.2, "end": 18.9 }] }.

Plusieurs publications dans un même tableau socialPost, chacune avec sa date : c’est ainsi qu’on pose une semaine en un appel. Demandez type: "draft" tant que vous relisez : les brouillons restent sur le calendrier et ne sont jamais publiés.