MCP: Agendador de publicações
Agendar e publicar posts nas redes pelo MCP. 10 ferramentas.
Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.
cancel-scheduled-post
Cancela um post agendado (status SCHEDULED). Se ele faz parte de uma série recorrente, a série acaba (nenhuma ocorrência nova é criada). Posts já publicados não são apagados da rede.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
postId | sim | ID do post agendado (list-scheduled-posts) |
get-tiktok-creator-info
Opções atuais da conta TikTok antes de postar: nickname, @username, privacyLevelOptions (privacidades aceitas), interações desligadas pelo criador (comment/duet/stitch) e duração máxima do vídeo. Leia antes de cada post no TikTok.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | sim | Conta TikTok (list-social-connections platform TIKTOK). |
list-scheduled-posts
Posts do agendador de publicações do workspace (Instagram, TikTok, YouTube), por data: status, tipo, mídia, legenda, erro, link (YouTube), recorrência (cron) e série. Filtre por status (padrão: todos). Tela: XBASE → Publicações.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
status | não | — |
platform | não | Filtra por rede. Padrão: todas. |
take | não | Quantidade (padrão 30, máximo 100) |
list-social-connections
Contas conectadas no hub de publicações do workspace, de todas as redes (Instagram, TikTok, YouTube): connectionId, rede, nome, @handle e status. Use o connectionId em schedule-social-post e publish-social-post-now. Tela: XBASE → Publicações.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
platform | não | Filtra por rede. Padrão: todas. |
publish-social-post-now
AÇÃO EXTERNA — publica agora no Instagram, TikTok ou YouTube (mesmos campos de schedule-social-post, sem data). Instagram e YouTube voltam PUBLISHED (YouTube com url do vídeo). TikTok volta PROCESSING: a TikTok processa o vídeo por alguns minutos; acompanhe com list-scheduled-posts. Contas: list-social-connections. Tela: XBASE → Publicações.
Sem parâmetros.
schedule-social-post
AÇÃO EXTERNA — agenda um post no Instagram, TikTok ou YouTube do workspace; na data, ele é publicado na conta escolhida. mediaUrl precisa ser uma URL pública (https) que a rede consiga baixar: use a saída de uma produção do Estúdio (studio_get_production) ou de upload-workspace-file. Instagram: FEED/REELS/STORY (imagem JPEG; Reels exige vídeo); carrossel com mediaType CAROUSEL e mediaUrls (2 a 10 JPEG, sem mediaUrl); recurrence repete por cron (só Instagram). TikTok: postType VIDEO, mediaType VIDEO e tiktok.privacyLevel (consulte get-tiktok-creator-info antes). YouTube: postType SHORT ou VIDEO, mediaType VIDEO, caption = descrição e youtube { title, privacyStatus, madeForKids }. Contas: list-social-connections. Tela: XBASE → Publicações.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
platform | não | Rede. Padrão INSTAGRAM. |
connectionId | sim | Conta/canal conectado (list-social-connections). |
postType | sim | Instagram: FEED, REELS ou STORY. TikTok: VIDEO. YouTube: SHORT (vertical, até 3 min) ou VIDEO. |
mediaType | sim | TikTok e YouTube: VIDEO. CAROUSEL só no feed do Instagram. |
mediaUrl | não | Mídia única. Não use no carrossel. |
mediaUrls | não | Só carrossel do Instagram: 2 a 10 imagens JPEG, na ordem. |
caption | não | Instagram: legenda (2200; story ignora). TikTok: título/legenda (2200). YouTube: descrição (5000). |
tiktok | não | Obrigatório com platform TIKTOK. Interações desligadas por padrão, como na tela. |
youtube | não | Obrigatório com platform YOUTUBE. |
scheduledAt | não | Data e hora (ISO 8601, futuro). Obrigatório sem recurrence. |
recurrence | não | Só Instagram. Repetição; com ela, scheduledAt é opcional (a primeira ocorrência do cron). |
youtube-analytics-report
Relatório do YouTube Analytics do canal (ou de um vídeo, com videoId). Relatórios prontos: summary (views, minutos assistidos, duração média, % assistida, inscritos ganhos/perdidos, likes, comentários, shares), daily (série por dia), top_videos (ranking com título), traffic_sources (origem: busca, sugeridos, Shorts, externo…), content_type (Shorts x vídeos x lives), demographics (idade e gênero, % de espectadores), geography (países), devices (celular, computador, TV), playback_locations, subscription_status (inscritos x não inscritos), retention (curva de retenção; exige videoId). custom: informe metrics/dimensions/filters/sort da API do YouTube Analytics. Datas YYYY-MM-DD; padrão últimos 28 dias. Canal conectado antes da liberação das métricas precisa reconectar.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | sim | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
report | não | — |
startDate | não | — |
endDate | não | — |
videoId | não | Restringe o relatório a um vídeo (obrigatório em retention). |
metrics | não | custom (ou sobrescreve o pronto): ex. "views,estimatedMinutesWatched". |
dimensions | não | custom: ex. "day", "video", "country". |
filters | não | custom: ex. "country==BR". |
sort | não | custom: ex. "-views". |
maxResults | não | — |
youtube-channel-overview
Visão geral de um canal do YouTube conectado: nome, @handle, inscritos, visualizações totais, número de vídeos, país, data de criação e se as métricas do YouTube Analytics estão liberadas (analyticsAvailable).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | sim | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
youtube-get-video
Detalhe de um vídeo do canal: título, descrição, tags, duração, privacidade e estatísticas públicas.
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | sim | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
videoId | sim | ID do vídeo (youtube-list-videos). |
youtube-list-videos
Vídeos do canal, do mais novo ao mais antigo, com visualizações, curtidas, comentários, duração, privacidade, link e se provavelmente é Short (até 3 min). Paginado: até 50 por página (nextPageToken).
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
workspaceId | não | Opcional. Se enviado, precisa ser o workspace do token (o token só acessa o próprio workspace). |
connectionId | sim | Canal do YouTube conectado (list-social-connections platform YOUTUBE). |
limit | não | Vídeos por página (padrão 20). |
pageToken | não | nextPageToken da página anterior. |