Postagem Social (YouTube, Facebook, Mastodon)
Crie e agende postagens para YouTube, Páginas do Facebook e Mastodon usando o servidor MCP Publora. Esta skill abrange plataformas que funcionam com postagens padrão, sem complexidades específicas.
Pré-requisitos
Planos: Funciona no plano gratuito Starter. Limites e preços atuais: publora.com/pricing.
Primeiros Passos
- Crie uma conta em publora.com/register (gratuito)
- Conecte plataformas via OAuth no Painel Publora:
- YouTube: Google OAuth (requer canal no YouTube)
- Facebook: Facebook OAuth (apenas Páginas, não perfis pessoais)
- Mastodon: OAuth (instância mastodon.social)
- Obtenha a chave de API em app.publora.com/dashboard/api
- Conecte seu agente ao servidor MCP em
https://mcp.publora.com, autenticando comAuthorization: Bearer sk_SUA_CHAVE_DE_API. No Claude Code:
claude mcp add publora --transport http https://mcp.publora.com \
--header "Authorization: Bearer sk_SUA_CHAVE_DE_API"
Claude Desktop, Cursor, Codex, OpenClaw e o conector claude.ai precisam de um arquivo de configuração ou fluxo diferente: veja configuração do cliente para o caminho e trecho exatos.
Fallback da API REST
Se o MCP estiver indisponível, use a API REST diretamente:
URL Base: https://api.publora.com/api/v1
Autenticação: cabeçalho x-publora-key
# Obter plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_sua_chave_de_api"
# Criar uma postagem
curl -X POST "https://api.publora.com/api/v1/create-post" \
-H "x-publora-key: sk_sua_chave_de_api" \
-H "Content-Type: application/json" \
-d '{
"platforms": ["youtube-UCxxx", "facebook-123456", "mastodon-789"],
"content": "Conteúdo da sua postagem",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
Formatos de ID de Plataforma:
- YouTube:
youtube-{channel_id}(ex.:youtube-UCxxx) - Facebook:
facebook-{page_id}(ex.:facebook-112233445566) - Mastodon:
mastodon-{id}(ex.:mastodon-456)
📖 Documentação: docs.publora.com
YouTube
Plataforma exclusiva de vídeo - toda postagem exige um arquivo de vídeo.
Limites da Plataforma
| Recurso | Limite |
|---|---|
| Título do vídeo | 100 caracteres |
| Descrição do vídeo | 5.000 caracteres |
| Duração do vídeo | 12 horas |
| Tamanho do vídeo | 256 GB |
| Formatos de vídeo | MP4, MOV, AVI, WebM |
Configurações da Plataforma (via API REST)
{
"platformSettings": {
"youtube": {
"privacy": "public",
"title": "Meu Título de Vídeo"
}
}
}
| Configuração | Valores | Padrão |
|---|---|---|
privacy | "public", "unlisted", "private" | "public" |
title | string | Derivado dos primeiros 70 caracteres do conteúdo |
Nota: platformSettings é aceito pelas ferramentas MCP create_post e update_post, bem como pela REST. O esquema é estrito: uma plataforma ou chave digitada incorretamente é rejeitada com um erro de validação, em vez de ser descartada silenciosamente.
Exemplos do YouTube
Envie este tutorial em vídeo para o YouTube:
"Como construir uma API REST em 10 Minutos - Guia completo para iniciantes"
Envie este vídeo como não listado (para compartilhamento interno):
"Demonstração interna - Recursos do painel Q1"
Restrições do YouTube
- Vídeo obrigatório: YouTube não suporta postagens apenas de texto ou imagem
- Apenas um vídeo: Um vídeo por postagem
- Tempo de processamento: Vídeos levam de segundos a minutos para serem processados após o upload
- Atualização de token: Tokens do YouTube expiram após ~6 meses, reconecte se necessário
Apenas Páginas - as postagens vão para Páginas do Facebook, não para perfis pessoais.
Limites da Plataforma
| Recurso | Limite |
|---|---|
| Texto da postagem | 2.200 caracteres (frontend) / 63.206 (API) |
| Imagens | Até 10 por postagem |
| Tamanho da imagem | 10 MB |
| Duração do vídeo | 45 minutos |
| Tamanho do vídeo | 2 GB |
Suporte a Múltiplas Páginas
Se você gerencia várias Páginas do Facebook, cada uma tem seu próprio ID de plataforma:
facebook-112233445566(Página 1)facebook-778899001122(Página 2)
Você pode postar em várias páginas em uma única requisição.
Exemplos do Facebook
Publique este anúncio na minha Página do Facebook:
"Estamos muito felizes em anunciar o lançamento do nosso novo produto! Visite nosso site para saber mais."
Publique isso em ambas as minhas Páginas do Facebook:
"Aviso de feriado: Nossos escritórios estarão fechados na segunda-feira."
Compartilhe estas fotos do evento no Facebook:
"Destaques do nosso retiro corporativo! Ótima equipe, ótimas memórias."
Restrições do Facebook
- Apenas Páginas: Não é possível postar em perfis pessoais via API
- WebP convertido automaticamente: Imagens WebP se tornam JPEG automaticamente
- Token de 59 dias: Tokens são renovados automaticamente, mas podem precisar de reconexão se falhar
- Sem mídia mista: Uma postagem pode ter imagens OU vídeo, não ambos
Mastodon
Plataforma do Fediverso - as postagens se federam pela rede descentralizada.
Limites da Plataforma
| Recurso | Limite |
|---|---|
| Texto da postagem | 500 caracteres |
| Imagens | Até 4 por postagem |
| Tamanho da imagem | 16 MB |
| Tamanho do vídeo | ~99 MB |
| Formatos de imagem | JPEG, PNG, GIF, WebP |
| Formatos de vídeo | MP4, WebM, MOV |
Exemplos do Mastodon
Publique isso no Mastodon:
"Olá fediverso! Acabamos de lançar uma grande atualização do nosso projeto open-source. #opensource"
Compartilhe esta captura de tela no Mastodon:
"Novo recurso: modo escuro chegou! #ui #modoescuro"
Restrições do Mastodon
- Apenas mastodon.social: Atualmente conecta apenas à instância mastodon.social
- Visibilidade pública: Todas as postagens são públicas por padrão
- Sem divisão automática: Ao contrário do X/Twitter, Mastodon não divide conteúdos longos
- Estrito limite de 500 caracteres: Conteúdo com mais de 500 caracteres será rejeitado
Ferramentas Disponíveis (Todas as Plataformas)
create_post
Crie uma nova postagem em qualquer plataforma.
Parâmetros:
platforms: Array de IDs de plataforma (ex.:["youtube-UCxxx", "facebook-123", "mastodon-456"])content: Texto da postagemscheduledTime: Data/hora ISO 8601 UTC. Opcional: omita e a postagem será criada como rascunho. Envie um horário futuro para agendar. Um horário cinco ou mais minutos no passado é rejeitado comSCHEDULED_TIME_IN_PAST, portanto, para postagem imediata, use o horário atual mais um minuto.mediaUrls: até 10 URLs públicas https de imagens ou vídeos. Publora as baixa no servidor e as anexa antes da validação, então mídia e agendamento acontecem em uma única chamada. Esta é a alternativa única ao fluxo de rascunho, depoisget_upload_url, depoiscomplete_media. A ingestão é limitada a 60 URLs por hora.
get_upload_url
Obtenha uma URL pré-assinada para uploads de mídia.
Parâmetros:
postGroupId: ID da postagem para anexar a mídiafileName: Nome do arquivocontentType: Tipo MIMEtype:"image"ou"video"
complete_media
Finalize um arquivo enviado através de get_upload_url, após o PUT pré-assinado ser bem-sucedido. Opcional, pois o agendamento também finaliza mídia pendente, mas chamá-la cedo expõe erros de formato e sonda antes da publicação. Não é necessária para mídia anexada com mediaUrls.
Parâmetros:
mediaId: o ID retornado porget_upload_url
list_connections
Liste suas contas conectadas com seus IDs de plataforma. Chame primeiro e copie os IDs literalmente; eles nunca são adivinháveis.
list_posts / get_post / update_post / delete_post
Gerencie postagens agendadas e rascunhos. update_post também modifica content e platforms em um rascunho ou postagem agendada, então corrigir um erro de digitação ou redirecionar não exige mais deletar e recriar. delete_media e prune_media_reference limpam arquivos enviados.
Postagem Multiplataforma
Poste em várias plataformas de uma só vez:
Publique este vídeo no YouTube e este texto no Facebook e Mastodon:
"Anunciando nosso novo recurso - assista à demonstração!"
Publora lida automaticamente com os requisitos específicos de cada plataforma:
- YouTube recebe o vídeo com título/descrição
- Facebook recebe o texto + vídeo
- Mastodon recebe o texto (limite de 500 caracteres se aplica)
Solução de Problemas
| Plataforma | Erro | Solução |
|---|---|---|
| YouTube | "Vídeo obrigatório" | Anexe um arquivo de vídeo |
| YouTube | "Conta desconectada" | Reconecte pelo painel |
| "Página não encontrada" | Verifique a conexão da página | |
| "Token expirado" | Reconecte a página no painel | |
| Mastodon | "Conteúdo muito longo" | Reduza para menos de 500 caracteres |
| Mastodon | "Muitas imagens" | Reduza para 4 ou menos |
| Todos | Erros de limite de taxa | Aguarde e tente novamente |
O valor de 512 MB que costumava aparecer aqui pertence ao endpoint multipart
/media/process-videodo painel. Uploads de API e MCP são pré-assinados e usam os limites das plataformas acima.