publora/x-post

Post no X/Twitter

Crie e agende posts para o X (Twitter) usando o servidor MCP Publora. Suporta posts de texto, imagens (até 4), vídeos e divisão automática em threads para conteúdo longo.

Pré-requisitos

Planos: Requer um plano pago (os custos da API do X são repassados). Limites e preços atuais: publora.com/pricing

Importante: O X/Twitter NÃO está disponível no plano gratuito Starter devido aos custos da API do Twitter.

Introdução

1. Crie uma conta em publora.com/register
2. Escolha o plano Pro ou Premium (X/Twitter requer plano pago)
3. Conecte o X/Twitter via OAuth no Painel Publora
4. Obtenha a chave da API em app.publora.com/dashboard/api
5. Conecte seu agente ao servidor MCP em https://mcp.publora.com, autenticando com Authorization: Bearer sk_YOUR_API_KEY. No Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop, Cursor, Codex, OpenClaw e o conector do claude.ai precisam de um arquivo de configuração ou fluxo diferente: veja configuração do cliente para o caminho e trecho exato.

Fallback da API REST

Se o MCP não estiver disponí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_your_api_key"

# Criar um post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["twitter-123456789"],
    "content": "Seu conteúdo do tweet",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Formato do ID da Plataforma: twitter-{id} (ex.: twitter-123456789)

📖 Docs: docs.publora.com

Limites da Plataforma

Recurso	Limite da API	Observações
Caracteres	280	Emojis contam como 2 caracteres
Imagens	Até 4	Convertidas automaticamente para PNG (largura máx. 1000px)
Duração do vídeo	2 min 20 s (140 s)	Publora valida vídeos do X em 140 s
Tamanho do vídeo	512 MB	Formatos MP4, MOV
Threading	Automático	Conteúdo acima de 280 caracteres dividido com marcadores (1/N)

Contagem de Caracteres

O X possui regras específicas de contagem de caracteres que o Publora gerencia automaticamente:

• Caractere padrão = 1
• Emojis = 2 caracteres
• URLs contadas pelo comprimento literal
• Marcadores de thread reservam 10 caracteres por tweet

Thread Automática

Quando o conteúdo excede 280 caracteres, o Publora cria automaticamente uma thread conectada:

1. Conteúdo dividido em quebras de parágrafo, depois limites de frase, depois limites de palavra
2. Cada parte numerada no formato (1/N), (2/N)
3. Tweets conectados via parâmetro reply_to_id do X

Quebras Manuais de Thread

Use --- em uma linha separada para forçar uma quebra de thread:

Este é meu primeiro tweet na thread.

---

Este é meu segundo tweet na thread.

---

E este é meu terceiro tweet!

Ferramentas Disponíveis

create_post

Criar um novo post ou thread no X/Twitter.

Parâmetros:

• platforms: Array com seu ID de conexão do X (ex.: ["twitter-12345678"])
• content: Texto do post (thread automática se tiver mais de 280 caracteres)
• scheduledTime: Data/hora ISO 8601 UTC. Opcional: omita para criar o post como rascunho. Envie uma data futura para agendar. Uma data com cinco ou mais minutos no passado é rejeitada com SCHEDULED_TIME_IN_PAST; para publicação imediata, use a hora atual mais um minuto.
• mediaUrls: Até 10 URLs https públicas de imagens ou vídeos. Publora as baixa no servidor e as anexa antes da validação, então mídia e agendamento ocorrem em uma única chamada. Esta é a alternativa de uma única etapa ao fluxo de rascunho seguido de get_upload_url e complete_media. A ingestão é limitada a 60 URLs por hora.

get_upload_url

Obter URL pré-assinada para uploads de mídia.

Parâmetros:

• postGroupId: ID do post ao qual anexar mídia
• fileName: Nome do arquivo (ex.: "image.png", "video.mp4")
• contentType: image/png, image/jpeg, video/mp4
• type: "image" ou "video"

complete_media

Finalizar 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á-lo cedo expõe erros de formato e sonda antes da publicação. Não é necessário para mídia anexada com mediaUrls.

Parâmetros:

• mediaId: o ID retornado por get_upload_url

list_connections

Listar suas contas conectadas com seus IDs de plataforma. Chame esta ferramenta primeiro e copie os IDs exatamente; eles nunca podem ser adivinhados.

list_posts / get_post / update_post / delete_post

Gerenciar posts agendados e rascunhos. update_post também altera content e platforms em um rascunho ou post agendado, então corrigir um erro de digitação ou redirecionar não significa mais excluir e recriar. delete_media e prune_media_reference limpam arquivos enviados.

Exemplos

Tweet Simples

Publique isso no X:
"Acabamos de lançar nossa nova documentação da API. Confira!"

Tweet com Imagens

Publique isso no Twitter com capturas de tela do novo painel:
"Antes e depois do nosso redesenho. O que você acha?"

Nota: Até 4 imagens permitidas. Todas as imagens são convertidas para PNG automaticamente.

Thread Longa

Crie uma thread no Twitter:
"Thread: 5 lições de construir nossa startup

---

1. Lance cedo, itere rápido. Lançamos com um MVP cheio de bugs e melhoramos com base no feedback real.

---

2. Converse com usuários diariamente. Nossas melhores funcionalidades vieram de conversas com clientes.

---

3. Foco supera quantidade de funcionalidades. Matamos 3 produtos para focar naquele que funcionou."

Tweet Agendado

Agende isso para amanhã às 9h:
"Motivação de segunda: Comece antes de estar pronto."

Restrições Importantes

1. Plano Pro obrigatório: X/Twitter é excluído do plano gratuito Starter devido aos custos da API do Twitter.

2. Limite de vídeo de 140 segundos: Publora valida vídeos do X em 2 minutos e 20 segundos (140 segundos). Vídeos mais longos falham na validação.

3. Conversão automática de imagens: Todas as imagens são convertidas para PNG (largura máxima de 1000px) antes do upload. GIFs animados perdem a animação.

4. Sem mistura de imagem e vídeo: Um tweet pode ter imagens OU vídeo, não ambos.

5. Mídia apenas no primeiro tweet: Em threads, imagens/vídeo são anexados apenas ao primeiro tweet.

Melhores Práticas

Conteúdo

1. Gancho na primeira linha: A maioria do engajamento acontece no primeiro tweet
2. Tamanho ideal da thread: 3-7 tweets para melhor engajamento
3. Consciência de emojis: Lembre-se que emojis contam como 2 caracteres

Timing

• Melhores horários: 8-10h, 12-13h, 17-18h no fuso horário alvo
• Frequência: 3-5 tweets por dia para crescimento
• Threads: Publique pela manhã para máxima visibilidade

Engajamento

• Responda a comentários na primeira hora
• Faça quote tweet de suas próprias threads para visibilidade
• Use hashtags relevantes (1-2 por tweet)

Solução de Problemas

Erro	Causa	Solução
"X/Twitter requer plano Pro"	Usando plano Starter	Faça upgrade para Pro em publora.com/settings
"Conteúdo muito longo"	Mais de 280 caracteres e falha na thread	Adicione quebras manuais com ---
"Vídeo muito longo"	Mais de 140 segundos	Corte o vídeo para menos de 2 min 20 s
"Muitas imagens"	Mais de 4 imagens	Reduza para 4 ou menos
"Limite de taxa excedido"	Limite da API do X atingido	Aguarde e tente novamente