Strumenti · Podcast e Video
Strumenti MCP per i moduli Podcast e Video: programmi e conduttori, episodi con audio, video, copertina e capitoli, pubblicare e programmare con la portata dell'e-mail, trascrizione, numeri, e per chi ascolta il punto in cui si è fermato, reazioni, commenti e la coda.
I moduli Podcast e Video tramite l'assistente: creare programmi e scegliere i conduttori, creare episodi caricando l'audio o il video tramite link o file, pubblicare o programmare sapendo prima quante persone ricevono l'e-mail, trascrivere, vedere i numeri e, per chi ascolta, salvare il punto, reagire, commentare e organizzare la coda.
Ogni strumento ha un'etichetta: Solo lettura non cambia nulla, Modifica crea o cambia qualcosa subito, e Chiede conferma agisce solo dopo il tuo sì a un riepilogo. Vedi Denaro e conferma.
In sintesi
| Strumento | Cosa fa | Ruolo minimo | Tipo |
|---|---|---|---|
list_shows | I programmi di uno spazio | Chiunque veda lo spazio | Solo lettura |
get_show | Un programma, con i conduttori | Chiunque veda lo spazio | Solo lettura |
create_show | Crea un programma, con copertina e conduttori | Admin | Modifica |
update_show | Modifica il programma | Admin | Modifica |
delete_show | Elimina il programma e gli episodi | Admin | Chiede conferma |
add_show_presenter | Rende qualcuno conduttore del programma | Admin | Modifica |
remove_show_presenter | Rimuove qualcuno dai conduttori | Admin | Chiede conferma |
get_show_stats | I numeri del programma, per episodio | Conduttore o team | Solo lettura |
list_episodes | Gli episodi di un programma | Chiunque veda lo spazio | Solo lettura |
get_episode | Un episodio, tramite id o link | Chi può ascoltarlo | Solo lettura |
create_episode | Crea un episodio (bozza) con audio o video | Conduttore o admin | Modifica |
update_episode | Modifica l'episodio, sostituisce il file e i capitoli | Conduttore o admin | Modifica |
delete_episode | Elimina l'episodio | Conduttore o admin | Chiede conferma |
publish_episode | Pubblica ora o programma; dry_run dice quanti ricevono l'e-mail | Conduttore o admin | Modifica |
unpublish_episode | Riporta l'episodio in bozza | Conduttore o admin | Chiede conferma |
transcribe_episode | Richiede la trascrizione | Conduttore o admin | Modifica |
get_episode_transcript | La trascrizione in testo, tratti o sottotitoli | Chi può ascoltarlo | Solo lettura |
get_episode_stats | I numeri di un episodio | Conduttore o team | Solo lettura |
save_episode_progress | Salva il punto in cui ti sei fermato | Chi può ascoltarlo | Modifica |
react_to_episode | Reagisce all'episodio | Chi può ascoltarlo | Modifica |
list_episode_comments | I commenti dell'episodio | Chi può ascoltarlo | Solo lettura |
create_episode_comment | Commenta o risponde, con un Drop facoltativo | Chi può ascoltarlo | Modifica |
update_episode_comment | Modifica il tuo commento | L'autore | Modifica |
delete_episode_comment | Elimina un commento e le risposte | L'autore o il moderatore | Chiede conferma |
react_to_episode_comment | Reagisce a un commento | Chi può ascoltarlo | Modifica |
get_my_media_queue | La tua coda | Qualsiasi | Solo lettura |
queue_episode | Mette un episodio in fondo alla coda | Chi può ascoltarlo | Modifica |
unqueue_episode | Rimuove un episodio dalla coda | Qualsiasi | Modifica |
reorder_my_media_queue | Riordina tutta la coda | Qualsiasi | Modifica |
Lo spazio si crea con create_space e module: "podcast" o "videos", con mode single (un programma) o multi (più programmi). Il conduttore è il membro o moderatore scelto per un programma: gli strumenti degli episodi compaiono a tutti i ruoli, e Memberfy rifiuta chi non è proprietario, amministratore né conduttore di quel programma. Il team, nei numeri, è proprietario, amministratore, moderatore e finanza.
File. L'audio (MP3, M4A o AAC, fino a 500 MB; il WAV viene rifiutato) e il video (MP4, WebM o MOV, fino a 4 GB) si inviano tramite link pubblico (audio_file_url, video_file_url), che Memberfy scarica e conserva in un'area privata, oppure in base64 fino a circa 7 MB (audio_file_base64 con audio_file_type, video_file_base64). Le copertine, con cover_image_url o cover_image_base64. Un episodio ha l'audio o il video, mai entrambi. Un WAV viene rifiutato con un errore che indica il campo mimeType. I riepiloghi di conferma di delete_episode, unpublish_episode e remove_show_presenter riportano il nome del programma in show_title, così puoi verificarlo prima del sì.
list_shows
Solo lettura
I programmi di uno spazio, con copertina, conduttori e quanti episodi ha ciascuno. Ruolo minimo: chiunque veda lo spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | Lo spazio Podcast o Video |
Chiedi così: "Quali programmi ha lo spazio Audio?"
get_show
Solo lettura
Un programma, con descrizione, categoria, lingua, autore, conduttori e se trascrive ogni episodio. Ruolo minimo: chiunque veda lo spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
show_id | id | Sì | Il programma (list_shows) |
create_show
Modifica
Creare un programma. Ruolo minimo: admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
space | id o link | Sì | Lo spazio Podcast o Video |
title | testo | Sì | Fino a 200 caratteri |
description | Markdown o HTML | No | |
category | testo | No | La categoria in inglese (Business, Education, Technology…) |
language | testo | No | pt-BR, en-US… |
explicit | vero o falso | No | Contenuto esplicito |
author_name | testo | No | Chi firma il programma |
auto_transcribe | vero o falso | No | Trascrivere ogni episodio quando va online (Podcast; attivo per impostazione predefinita) |
presenter_ids | elenco di id | No | I conduttori (membri o moderatori; list_members) |
cover_image_url / cover_image_base64 | link o base64 | No | La copertina, quadrata |
Chiedi così: "Crea nello spazio Audio il programma Chiacchiere di Community, in italiano, categoria Business, con Maria come conduttrice."
update_show
Modifica
Modificare il programma. Gli stessi campi di create_show (tranne space e presenter_ids), più remove_cover. Cambia solo ciò che invii. Ruolo minimo: admin.
delete_show
Chiede conferma
Eliminare il programma, con gli episodi, i commenti e i numeri. Il riepilogo dice quanti episodi escono. Ruolo minimo: admin.
add_show_presenter
Modifica
Rendere qualcuno conduttore. Da quel momento crea, modifica, pubblica e trascrive gli episodi di questo programma, e solo di questo, e vede i numeri. Ruolo minimo: admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
show_id | id | Sì | |
member_id | id | Sì | Un membro o moderatore di questa community |
remove_show_presenter
Chiede conferma
Rimuovere qualcuno dai conduttori. Ciò che ha pubblicato resta. Parametri: show_id e member_id. Ruolo minimo: admin.
get_show_stats
Solo lettura
I numeri del programma, in totale e per episodio: riproduzioni (da 30 secondi), persone uniche, quante sono arrivate al 90% e il completamento medio. Ruolo minimo: conduttore del programma o team.
Chiedi così: "Quale episodio di Chiacchiere di Community è stato più ascoltato?"
list_episodes
Solo lettura
Gli episodi di un programma. Chi non gestisce il programma vede solo quelli online. Ruolo minimo: chiunque veda lo spazio.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
show_id | id | Sì | |
status | draft, scheduled o published | No | Bozze e programmati, solo per chi gestisce |
season | numero | No | La stagione |
order | newest o oldest | No | |
page, limit | numero | No | Fino a 100 per pagina |
get_episode
Solo lettura
Un episodio, con descrizione, capitoli, il punto in cui ti sei fermato, le reazioni e, per chi gestisce, lo stato della trascrizione. Accetta l'id o il link dell'app (anche quello dell'e-mail di avviso). Ruolo minimo: chi può ascoltarlo.
create_episode
Modifica
Creare un episodio, in bozza. Ruolo minimo: conduttore del programma o admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
show_id | id | Sì | |
title | testo | Sì | Fino a 200 caratteri |
description | Markdown o HTML | No | Le righe come 00:00 Apertura diventano capitoli |
season, number | numero | No | Stagione e numero dell'episodio |
type | full, trailer o bonus | No | Completo (predefinito), trailer o bonus |
is_open | vero o falso | No | Episodio aperto: si riproduce per tutti i membri della community |
chapters | elenco di { start_seconds, title } | No | Capitoli personalizzati, al posto di quelli della descrizione |
audio_file_url / audio_file_base64 | link o base64 | No | L'audio (vedi File, sopra) |
video_file_url / video_file_base64 | link o base64 | No | Il video |
cover_image_url / cover_image_base64 | link o base64 | No | La copertina dell'episodio |
Poi, publish_episode.
Chiedi così: "Crea l'episodio 4 della stagione 1 di Chiacchiere di Community con l'audio di questo link e questi capitoli."
update_episode
Modifica
Modificare l'episodio. I campi di create_episode, più remove_media (toglie l'audio o il video; un episodio online ne ha bisogno) e remove_cover. chapters: null torna a leggere i capitoli dalla descrizione. Sostituire il file nasconde la vecchia trascrizione. Ruolo minimo: conduttore del programma o admin.
delete_episode
Chiede conferma
Eliminare l'episodio, con il file, i commenti e i numeri. Ruolo minimo: conduttore del programma o admin.
publish_episode
Modifica
Pubblicare o programmare. L'episodio deve avere audio o video. Nel momento in cui va online, chi può ascoltarlo e ha lasciato attiva la categoria Podcast e video riceve un'e-mail. L'assistente chiama prima con dry_run e dice quante persone la riceveranno. Ruolo minimo: conduttore del programma o admin.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
episode | id o link | Sì | |
publish_at | data e ora (ISO 8601) | No | Nel futuro, programma; vuota o nel passato, pubblica subito |
notify_by_email | vero o falso | No | false pubblica senza e-mail |
dry_run | vero o falso | No | Non pubblica: dice solo quanti ricevono l'e-mail |
Chiedi così: "Programma l'episodio 4 per lunedì alle 7 e dimmi prima quante persone ricevono l'e-mail."
unpublish_episode
Chiede conferma
Annullare la pubblicazione. L'episodio torna bozza e sparisce per i membri; commenti, reazioni e numeri restano salvati. Ruolo minimo: conduttore del programma o admin.
transcribe_episode
Modifica
Richiedere la trascrizione. Usa i minuti di trascrizione IA del piano (gli stessi dei Drops). Viene rifiutata senza file, oltre le 4 ore, con una trascrizione già in corso o con la quota del mese esaurita. Ruolo minimo: conduttore del programma o admin.
get_episode_transcript
Solo lettura
La trascrizione pronta. Ruolo minimo: chi può ascoltarlo.
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
episode | id o link | Sì | |
format | text, cues o vtt | No | Il testo (predefinito), i tratti con i tempi o i sottotitoli WebVTT |
Chiedi così: "Riassumi l'episodio 4 a partire dalla trascrizione ed elenca i tratti sul prezzo."
get_episode_stats
Solo lettura
I numeri di un episodio: riproduzioni (da 30 secondi), persone uniche, quante hanno iniziato, quante sono arrivate al 90%, il completamento medio e la ritenzione in 20 tratti. Ruolo minimo: conduttore del programma o team.
save_episode_progress
Modifica
Salvare il punto in cui ti sei fermato (position_seconds), per riprendere su qualsiasi dispositivo. Arrivare al 90% segna l'episodio come completato. Ruolo minimo: chi può ascoltarlo.
react_to_episode
Modifica
Reagire con 🎉 ❤️ 👍 🔥 🙌 😊 o 👏 (una reazione per persona; un'altra sostituisce la precedente), oppure togliere la tua con remove: true. Ruolo minimo: chi può ascoltarlo.
list_episode_comments
Solo lettura
I commenti, con le risposte. Parametri: episode, sort (newest o oldest), page, limit. Ruolo minimo: chi può ascoltarlo.
create_episode_comment
Modifica
Commentare (fino a 5.000 caratteri), o rispondere a un commento (parent_id, un livello), facoltativamente con un Drop video (video_file_url o video_file_base64, fino a 500 MB) quando la community accetta i Drops nei commenti. Commentare dà i punti di coinvolgimento una volta per episodio. Ruolo minimo: chi può ascoltarlo.
update_episode_comment
Modifica
Modificare il tuo commento. Parametri: episode, comment_id, comment. Solo l'autore.
delete_episode_comment
Chiede conferma
Eliminare un commento e le sue risposte. L'autore, oppure il proprietario, l'amministratore e il moderatore.
react_to_episode_comment
Modifica
Reagire a un commento, con le stesse reazioni dell'episodio, oppure togliere la tua. Ruolo minimo: chi può ascoltare l'episodio.
get_my_media_queue
Solo lettura
La tua coda, in ordine, con gli episodi degli spazi Podcast e Video di questa community. Qualsiasi ruolo.
queue_episode
Modifica
Mettere un episodio in fondo alla coda. Ruolo minimo: chi può ascoltarlo.
unqueue_episode
Modifica
Rimuovere un episodio dalla coda. L'episodio non cambia. Qualsiasi ruolo.
reorder_my_media_queue
Modifica
Riordinare tutta la coda (episode_ids, fino a 200, nell'ordine desiderato). L'episodio che resta fuori dall'elenco esce dalla coda. Qualsiasi ruolo.
Chiedi così: "Metti gli ultimi tre episodi di Dietro le quinte all'inizio della mia coda."