Vai al contenuto

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

StrumentoCosa faRuolo minimoTipo
list_showsI programmi di uno spazioChiunque veda lo spazioSolo lettura
get_showUn programma, con i conduttoriChiunque veda lo spazioSolo lettura
create_showCrea un programma, con copertina e conduttoriAdminModifica
update_showModifica il programmaAdminModifica
delete_showElimina il programma e gli episodiAdminChiede conferma
add_show_presenterRende qualcuno conduttore del programmaAdminModifica
remove_show_presenterRimuove qualcuno dai conduttoriAdminChiede conferma
get_show_statsI numeri del programma, per episodioConduttore o teamSolo lettura
list_episodesGli episodi di un programmaChiunque veda lo spazioSolo lettura
get_episodeUn episodio, tramite id o linkChi può ascoltarloSolo lettura
create_episodeCrea un episodio (bozza) con audio o videoConduttore o adminModifica
update_episodeModifica l'episodio, sostituisce il file e i capitoliConduttore o adminModifica
delete_episodeElimina l'episodioConduttore o adminChiede conferma
publish_episodePubblica ora o programma; dry_run dice quanti ricevono l'e-mailConduttore o adminModifica
unpublish_episodeRiporta l'episodio in bozzaConduttore o adminChiede conferma
transcribe_episodeRichiede la trascrizioneConduttore o adminModifica
get_episode_transcriptLa trascrizione in testo, tratti o sottotitoliChi può ascoltarloSolo lettura
get_episode_statsI numeri di un episodioConduttore o teamSolo lettura
save_episode_progressSalva il punto in cui ti sei fermatoChi può ascoltarloModifica
react_to_episodeReagisce all'episodioChi può ascoltarloModifica
list_episode_commentsI commenti dell'episodioChi può ascoltarloSolo lettura
create_episode_commentCommenta o risponde, con un Drop facoltativoChi può ascoltarloModifica
update_episode_commentModifica il tuo commentoL'autoreModifica
delete_episode_commentElimina un commento e le risposteL'autore o il moderatoreChiede conferma
react_to_episode_commentReagisce a un commentoChi può ascoltarloModifica
get_my_media_queueLa tua codaQualsiasiSolo lettura
queue_episodeMette un episodio in fondo alla codaChi può ascoltarloModifica
unqueue_episodeRimuove un episodio dalla codaQualsiasiModifica
reorder_my_media_queueRiordina tutta la codaQualsiasiModifica

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.

ParametroTipoObbligatorioDescrizione
spaceid o linkSì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.

ParametroTipoObbligatorioDescrizione
show_ididSìIl programma (list_shows)

create_show

Modifica

Creare un programma. Ruolo minimo: admin.

ParametroTipoObbligatorioDescrizione
spaceid o linkSìLo spazio Podcast o Video
titletestoSìFino a 200 caratteri
descriptionMarkdown o HTMLNo
categorytestoNoLa categoria in inglese (Business, Education, Technology…)
languagetestoNopt-BR, en-US…
explicitvero o falsoNoContenuto esplicito
author_nametestoNoChi firma il programma
auto_transcribevero o falsoNoTrascrivere ogni episodio quando va online (Podcast; attivo per impostazione predefinita)
presenter_idselenco di idNoI conduttori (membri o moderatori; list_members)
cover_image_url / cover_image_base64link o base64NoLa 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.

ParametroTipoObbligatorioDescrizione
show_ididSì
member_ididSì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.

ParametroTipoObbligatorioDescrizione
show_ididSì
statusdraft, scheduled o publishedNoBozze e programmati, solo per chi gestisce
seasonnumeroNoLa stagione
ordernewest o oldestNo
page, limitnumeroNoFino 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.

ParametroTipoObbligatorioDescrizione
show_ididSì
titletestoSìFino a 200 caratteri
descriptionMarkdown o HTMLNoLe righe come 00:00 Apertura diventano capitoli
season, numbernumeroNoStagione e numero dell'episodio
typefull, trailer o bonusNoCompleto (predefinito), trailer o bonus
is_openvero o falsoNoEpisodio aperto: si riproduce per tutti i membri della community
chapterselenco di { start_seconds, title }NoCapitoli personalizzati, al posto di quelli della descrizione
audio_file_url / audio_file_base64link o base64NoL'audio (vedi File, sopra)
video_file_url / video_file_base64link o base64NoIl video
cover_image_url / cover_image_base64link o base64NoLa 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.

ParametroTipoObbligatorioDescrizione
episodeid o linkSì
publish_atdata e ora (ISO 8601)NoNel futuro, programma; vuota o nel passato, pubblica subito
notify_by_emailvero o falsoNofalse pubblica senza e-mail
dry_runvero o falsoNoNon 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.

ParametroTipoObbligatorioDescrizione
episodeid o linkSì
formattext, cues o vttNoIl 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."

Correlati