API Tutorial
Come pianificare i post su YouTube tramite API
Per pianificare i post su YouTube tramite API, collega YouTube con Modiva e poi chiama `posts_schedule` con il tuo contenuto e un timestamp `publish_at` — Modiva lo mette in coda e lo pubblica automaticamente su YouTube in quel momento.
Pianificare significa salvare un post e pubblicarlo in modo affidabile più tardi — qualcosa che l'API di YouTube lascia interamente a te. Modiva gestisce la coda, riprova in caso di errori temporanei di YouTube e mette a disposizione un unico strumento `posts_schedule` che funziona in modo identico su ogni piattaforma.
Passo dopo passo
Crea un account Modiva e una chiave MCP
Registrati gratuitamente e genera una chiave MCP (`mk_live_…`) dalla dashboard. La stessa chiave autentica sia il server MCP ospitato (per gli agenti IA) sia la REST API (per il tuo backend), così gestisci un'unica credenziale.
Collega il tuo account YouTube
Nella dashboard clicca su Collega e scegli YouTube. Modiva esegue il flusso OAuth e richiede per te gli scope corretti, poi salva i token di accesso e di refresh in un vault cifrato e li mantiene aggiornati — non maneggi mai le credenziali API grezze di YouTube. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.
Chiama posts_schedule con un orario publish_at
Chiama `posts_schedule` con l'ID della connessione, il tuo contenuto e un timestamp `publish_at` in formato ISO. Modiva salva il job e pubblica su YouTube in quel momento, gestendo il refresh dei token e i tentativi ripetuti senza bisogno di un tuo cron.
Trova il momento migliore e componi un calendario
Chiama `analytics_best_time_to_post` per scegliere uno slot, poi pianifica un'intera settimana in un ciclo. Tramite MCP un agente IA può pianificare e mettere in coda un intero calendario di contenuti YouTube a partire da un singolo prompt.
Richiesta di esempio
Chiama lo strumento posts_schedule tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Provalo con YouTube
Inizia gratisFAQ
Lo scheduler lo gestisce Modiva o io?
Modiva. Una volta chiamato `posts_schedule`, Modiva salva il job e pubblica su YouTube all'orario desiderato — non ti servono una coda o un cron tuoi.
Posso pianificare lo stesso post su più piattaforme?
Sì — passa più ID di connessione (oppure usa `posts_cross_post`) e Modiva pianifica il post per YouTube e per ogni altra piattaforma, adattandolo di volta in volta al formato.