Saltar para o conteúdo

Ferramentas · Podcast e Vídeos

Ferramentas MCP para os módulos Podcast e Vídeos: programas e apresentadores, episódios com áudio, vídeo, capa e capítulos, publicar e agendar com o alcance do e-mail, transcrição, números e, para quem ouve, o ponto em que parou, reações, comentários e a fila.

Os módulos Podcast e Vídeos pelo assistente: criar programas e escolher apresentadores, criar episódios enviando o áudio ou o vídeo por link ou ficheiro, publicar ou agendar sabendo antes quantas pessoas recebem o e-mail, transcrever, ver os números e, para quem ouve, guardar o ponto, reagir, comentar e organizar a fila.

Cada ferramenta traz um selo: Só consulta não muda nada, Altera cria ou muda algo de imediato, e Pede confirmação só age depois do seu sim a um resumo. Ver Dinheiro e confirmação.

Em resumo

FerramentaO que fazPapel mínimoTipo
list_showsOs programas de um espaçoQualquer um que veja o espaçoSó consulta
get_showUm programa, com os apresentadoresQualquer um que veja o espaçoSó consulta
create_showCria um programa, com capa e apresentadoresAdministradorAltera
update_showEdita o programaAdministradorAltera
delete_showApaga o programa e os episódiosAdministradorPede confirmação
add_show_presenterTorna alguém apresentador do programaAdministradorAltera
remove_show_presenterRemove alguém dos apresentadoresAdministradorPede confirmação
get_show_statsOs números do programa, por episódioApresentador ou equipaSó consulta
list_episodesOs episódios de um programaQualquer um que veja o espaçoSó consulta
get_episodeUm episódio, pelo id ou pelo linkQuem o pode ouvirSó consulta
create_episodeCria um episódio (rascunho) com áudio ou vídeoApresentador ou administradorAltera
update_episodeEdita o episódio, troca o ficheiro e os capítulosApresentador ou administradorAltera
delete_episodeApaga o episódioApresentador ou administradorPede confirmação
publish_episodePublica agora ou agenda; dry_run diz quantos recebem o e-mailApresentador ou administradorAltera
unpublish_episodeDevolve o episódio a rascunhoApresentador ou administradorPede confirmação
transcribe_episodePede a transcriçãoApresentador ou administradorAltera
get_episode_transcriptA transcrição em texto, trechos ou legendaQuem o pode ouvirSó consulta
get_episode_statsOs números de um episódioApresentador ou equipaSó consulta
save_episode_progressGuarda onde parouQuem o pode ouvirAltera
react_to_episodeReage ao episódioQuem o pode ouvirAltera
list_episode_commentsOs comentários do episódioQuem o pode ouvirSó consulta
create_episode_commentComenta ou responde, com Drop opcionalQuem o pode ouvirAltera
update_episode_commentEdita o seu comentárioO autorAltera
delete_episode_commentApaga um comentário e as respostasO autor ou moderadorPede confirmação
react_to_episode_commentReage a um comentárioQuem o pode ouvirAltera
get_my_media_queueA sua filaQualquerSó consulta
queue_episodeColoca um episódio no fim da filaQuem o pode ouvirAltera
unqueue_episodeRemove um episódio da filaQualquerAltera
reorder_my_media_queueReordena a fila inteiraQualquerAltera

O espaço cria-se com create_space e module: "podcast" ou "videos", com mode single (um programa) ou multi (vários). O apresentador é o membro ou moderador escolhido para um programa: as ferramentas de episódio aparecem para todos os papéis, e a Memberfy recusa quem não é proprietário, administrador nem apresentador desse programa. A equipa, nos números, é o proprietário, o administrador, o moderador e o financeiro.

Ficheiros. O áudio (MP3, M4A ou AAC, até 500 MB; WAV é recusado) e o vídeo (MP4, WebM ou MOV, até 4 GB) vão por link público (audio_file_url, video_file_url), que a Memberfy descarrega e guarda numa área privada, ou em base64 até cerca de 7 MB (audio_file_base64 com audio_file_type, video_file_base64). As capas, por cover_image_url ou cover_image_base64. Um episódio tem áudio ou vídeo, nunca os dois. Um WAV é recusado com "Envie em MP3 ou M4A.", a apontar o campo mimeType. Os resumos de confirmação de delete_episode, unpublish_episode e remove_show_presenter trazem o nome do programa em show_title, para confirmar antes do sim.

list_shows

Só consulta

Os programas de um espaço, com capa, apresentadores e quantos episódios tem cada um. Papel mínimo: qualquer um que veja o espaço.

ParâmetroTipoObrigatórioDescrição
spaceid ou linkSimO espaço de Podcast ou de Vídeos

Peça assim: "Que programas tem o espaço Áudios?"

get_show

Só consulta

Um programa, com descrição, categoria, idioma, autor, apresentadores e se transcreve cada episódio. Papel mínimo: qualquer um que veja o espaço.

ParâmetroTipoObrigatórioDescrição
show_ididSimO programa (list_shows)

create_show

Altera

Criar um programa. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
spaceid ou linkSimO espaço de Podcast ou de Vídeos
titletextoSimAté 200 caracteres
descriptionMarkdown ou HTMLNão
categorytextoNãoA categoria em inglês (Business, Education, Technology…)
languagetextoNãopt-PT, en-US…
explicitverdadeiro ou falsoNãoConteúdo explícito
author_nametextoNãoQuem assina o programa
auto_transcribeverdadeiro ou falsoNãoTranscrever cada episódio ao entrar no ar (Podcast; ligado por predefinição)
presenter_idslista de idsNãoOs apresentadores (membros ou moderadores; list_members)
cover_image_url / cover_image_base64link ou base64NãoA capa, quadrada

Peça assim: "Crie no espaço Áudios o programa Papo de Comunidade, em português, categoria Negócios, com a Maria como apresentadora."

update_show

Altera

Editar o programa. Os mesmos campos de create_show (exceto space e presenter_ids), mais remove_cover. Só muda o que enviar. Papel mínimo: administrador.

delete_show

Pede confirmação

Apagar o programa, com os episódios, comentários e números. O resumo diz quantos episódios saem. Papel mínimo: administrador.

add_show_presenter

Altera

Tornar alguém apresentador. Passa a criar, editar, publicar e transcrever os episódios deste programa, e só deste, e a ver os números. Papel mínimo: administrador.

ParâmetroTipoObrigatórioDescrição
show_ididSim
member_ididSimUm membro ou moderador desta comunidade

remove_show_presenter

Pede confirmação

Remover alguém dos apresentadores. O que publicou continua. Parâmetros: show_id e member_id. Papel mínimo: administrador.

get_show_stats

Só consulta

Os números do programa, no total e por episódio: reproduções (a partir de 30 segundos), pessoas únicas, quantas chegaram a 90% e a conclusão média. Papel mínimo: apresentador do programa ou equipa.

Peça assim: "Qual foi o episódio mais ouvido do Papo de Comunidade?"

list_episodes

Só consulta

Os episódios de um programa. Quem não gere o programa só vê os que estão no ar. Papel mínimo: qualquer um que veja o espaço.

ParâmetroTipoObrigatórioDescrição
show_ididSim
statusdraft, scheduled ou publishedNãoRascunhos e agendados, só para quem gere
seasonnúmeroNãoA temporada
ordernewest ou oldestNão
page, limitnúmeroNãoAté 100 por página

get_episode

Só consulta

Um episódio, com descrição, capítulos, o ponto em que parou, as reações e, para quem gere, o estado da transcrição. Aceita o id ou o link da aplicação (incluindo o do e-mail de aviso). Papel mínimo: quem o pode ouvir.

create_episode

Altera

Criar um episódio, em rascunho. Papel mínimo: apresentador do programa ou administrador.

ParâmetroTipoObrigatórioDescrição
show_ididSim
titletextoSimAté 200 caracteres
descriptionMarkdown ou HTMLNãoLinhas como 00:00 Abertura viram capítulos
season, numbernúmeroNãoTemporada e número do episódio
typefull, trailer ou bonusNãoCompleto (predefinição), trailer ou bónus
is_openverdadeiro ou falsoNãoEpisódio aberto: reproduz para todos os membros da comunidade
chapterslista de { start_seconds, title }NãoCapítulos próprios, no lugar dos da descrição
audio_file_url / audio_file_base64link ou base64NãoO áudio (ver Ficheiros, acima)
video_file_url / video_file_base64link ou base64NãoO vídeo
cover_image_url / cover_image_base64link ou base64NãoA capa do episódio

Depois, publish_episode.

Peça assim: "Crie o episódio 4 da temporada 1 do Papo de Comunidade com o áudio deste link e estes capítulos."

update_episode

Altera

Editar o episódio. Os campos de create_episode, mais remove_media (remove o áudio ou o vídeo; um episódio no ar precisa de um) e remove_cover. chapters: null volta a ler os capítulos da descrição. Trocar o ficheiro esconde a transcrição antiga. Papel mínimo: apresentador do programa ou administrador.

delete_episode

Pede confirmação

Apagar o episódio, com o ficheiro, os comentários e os números. Papel mínimo: apresentador do programa ou administrador.

publish_episode

Altera

Publicar ou agendar. O episódio precisa de áudio ou vídeo. No momento em que entra no ar, quem o pode ouvir e deixou ligada a categoria Podcasts e vídeos recebe um e-mail. O assistente chama primeiro com dry_run e diz quantas pessoas o vão receber. Papel mínimo: apresentador do programa ou administrador.

ParâmetroTipoObrigatórioDescrição
episodeid ou linkSim
publish_atdata e hora (ISO 8601)NãoNo futuro, agenda; vazia ou no passado, publica agora
notify_by_emailverdadeiro ou falsoNãofalse publica sem e-mail
dry_runverdadeiro ou falsoNãoNão publica: só diz quantos recebem o e-mail

Peça assim: "Agende o episódio 4 para segunda-feira às 7h e diga-me antes quantas pessoas recebem o e-mail."

unpublish_episode

Pede confirmação

Despublicar. O episódio volta a rascunho e desaparece para os membros; comentários, reações e números ficam guardados. Papel mínimo: apresentador do programa ou administrador.

transcribe_episode

Altera

Pedir a transcrição. Usa os minutos de transcrição de IA do plano (os mesmos dos Drops). É recusada sem ficheiro, acima de 4 horas, com uma transcrição já em andamento ou com a quota do mês esgotada. Papel mínimo: apresentador do programa ou administrador.

get_episode_transcript

Só consulta

A transcrição pronta. Papel mínimo: quem o pode ouvir.

ParâmetroTipoObrigatórioDescrição
episodeid ou linkSim
formattext, cues ou vttNãoO texto (predefinição), os trechos com os tempos ou a legenda WebVTT

Peça assim: "Resuma o episódio 4 a partir da transcrição e liste os trechos sobre preço."

get_episode_stats

Só consulta

Os números de um episódio: reproduções (a partir de 30 segundos), pessoas únicas, quantas começaram, quantas chegaram a 90%, a conclusão média e a retenção em 20 trechos. Papel mínimo: apresentador do programa ou equipa.

save_episode_progress

Altera

Guardar onde parou (position_seconds), para continuar em qualquer aparelho. Chegar a 90% marca o episódio como concluído. Papel mínimo: quem o pode ouvir.

react_to_episode

Altera

Reagir com 🎉 ❤️ 👍 🔥 🙌 😊 ou 👏 (uma reação por pessoa; outra substitui a anterior), ou retirar a sua com remove: true. Papel mínimo: quem o pode ouvir.

list_episode_comments

Só consulta

Os comentários, com as respostas. Parâmetros: episode, sort (newest ou oldest), page, limit. Papel mínimo: quem o pode ouvir.

create_episode_comment

Altera

Comentar (até 5.000 caracteres), ou responder a um comentário (parent_id, um nível), opcionalmente com um Drop em vídeo (video_file_url ou video_file_base64, até 500 MB) quando a comunidade aceita Drops nos comentários. Comentar dá os pontos de envolvimento uma vez por episódio. Papel mínimo: quem o pode ouvir.

update_episode_comment

Altera

Editar o seu comentário. Parâmetros: episode, comment_id, comment. Só o autor.

delete_episode_comment

Pede confirmação

Apagar um comentário e as respetivas respostas. O autor, ou o proprietário, o administrador e o moderador.

react_to_episode_comment

Altera

Reagir a um comentário, com as mesmas reações do episódio, ou retirar a sua. Papel mínimo: quem pode ouvir o episódio.

get_my_media_queue

Só consulta

A sua fila, por ordem, com os episódios dos espaços de Podcast e de Vídeos desta comunidade. Qualquer papel.

queue_episode

Altera

Colocar um episódio no fim da fila. Papel mínimo: quem o pode ouvir.

unqueue_episode

Altera

Remover um episódio da fila. O episódio não muda. Qualquer papel.

reorder_my_media_queue

Altera

Reordenar a fila inteira (episode_ids, até 200, pela ordem pretendida). O episódio que ficar fora da lista sai da fila. Qualquer papel.

Peça assim: "Coloque os três últimos episódios do Bastidores no início da minha fila."

Relacionados