publora/threads-post

Postagem no Threads

Crie e agende postagens no Threads da Meta usando o servidor MCP Publora. Suporta postagens únicas, carrosséis de imagens (2 a 20 imagens) e controle de respostas. O encadeamento de múltiplas partes está desabilitado no momento pela conexão com a plataforma.

Pré-requisitos

Planos: Funciona no plano gratuito Starter. Limites e preços atuais: publora.com/pricing

Primeiros passos

1. Crie uma conta em publora.com/register (gratuita)
2. Conecte o Threads via OAuth do Instagram no Painel Publora
3. Obtenha a chave de API em app.publora.com/dashboard/api
4. Conecte seu agente ao servidor MCP em https://mcp.publora.com, autenticando com Authorization: Bearer sk_SUA_CHAVE_API. No Claude Code:

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

O 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 exato e o trecho de código.

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

# Listar plataformas conectadas
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_sua_chave_api"

# Criar uma postagem
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["threads-12345"],
    "content": "Conteúdo da sua postagem",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Formato do ID da Plataforma: threads-{id} (de /platform-connections)

📖 Documentação: docs.publora.com

Limites da Plataforma

Recurso	Limite
Caracteres por postagem	500
Hashtags	1 por postagem no máximo
Links	5 por postagem no máximo
Imagens por carrossel	2 a 20
Tamanho da imagem	8 MB
Formatos de imagem	JPEG, PNG (WebP convertido automaticamente)
Duração do vídeo	5 minutos
Tamanho do vídeo	1 GB
Formatos de vídeo	MP4, MOV
Postagens por dia	250
Respostas por dia	1.000

Ferramentas Disponíveis

create_post

Criar uma nova postagem ou encadeamento no Threads.

Parâmetros:

• platforms: Array com o ID da sua conexão Threads (ex.: ["threads-12345"])
• content: Texto da postagem (dividido automaticamente se ultrapassar 500 caracteres, mas atualmente o encadeamento está desabilitado — veja a seção Conteúdo Longo)
• scheduledTime: Data/hora ISO 8601 em UTC. Opcional: omita para criar a postagem como rascunho. Envie um horário futuro para agendar. Um horário com cinco ou mais minutos no passado é rejeitado com erro: SCHEDULED_TIME_IN_PAST. Para postagem imediata, use o horário atual mais um minuto.
• mediaUrls: até 10 URLs públicas https de imagens ou vídeos. O Publora faz o download no servidor e os anexa antes da validação, então mídia e agendamento ocorrem em uma única chamada. Esta é a alternativa única ao fluxo de rascunho seguido por get_upload_url e depois complete_media. A ingestão tem limite de 60 URLs por hora.

get_upload_url

Obter uma URL pré-assinada para fazer upload de imagens.

complete_media

Finalizar um arquivo enviado via get_upload_url, após o PUT pré-assinado ser bem-sucedido. Opcional, pois o agendamento também finaliza mídias pendentes, mas chamá-lo antecipadamente expõe erros de formato e de sondagem 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 como retornados; eles nunca são adivinháveis.

list_posts / get_post / update_post / delete_post

Gerenciar postagens agendadas e rascunhos. update_post também altera 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.

Conteúdo Longo

As postagens do Threads são limitadas a 500 caracteres e o encadeamento de múltiplas partes do Publora está atualmente desabilitado enquanto a conexão com o aplicativo Threads está sendo restaurada. Conteúdo acima do limite não é dividido automaticamente, portanto:

• Mantenha a postagem dentro de 500 caracteres, ou
• Publique as partes você mesmo como postagens separadas, ou
• Mova a versão longa para uma plataforma que faça encadeamento hoje (X) e coloque um link para ela.

Separadores manuais --- e marcadores [1/3] são preservados como escritos, mas não criam uma cadeia de respostas conectada no momento. Entre em contato com [email protected] para saber o cronograma de restauração.

Controle de Respostas

Controle quem pode responder às suas postagens via platformSettings na API REST:

Valor	Descrição
"" (vazio)	Comportamento padrão da plataforma (qualquer um pode responder)
"everyone"	Permitir explicitamente que qualquer um responda
"accounts_you_follow"	Apenas contas que você segue podem responder
"mentioned_only"	Apenas contas mencionadas podem responder

Nota: platformSettings é aceito pelas ferramentas MCP create_post e update_post, bem como pela REST. O esquema é rigoroso: uma plataforma ou chave digitada incorretamente é rejeitada com erro de validação, em vez de ser ignorada silenciosamente.

Restrições Importantes

1. Limite de uma hashtag: O Threads permite no máximo 1 hashtag por postagem. Hashtags adicionais são ignoradas pela plataforma.

2. Sem edição após publicação: Depois de publicadas, as postagens do Threads não podem ser editadas pela API. Delete e republique se necessário.

3. Carrosséis de vídeo não suportados: A implementação de carrossel do Publora suporta apenas imagens. Postagens de vídeo independentes funcionam normalmente.

4. Postagens em encadeamento temporariamente indisponíveis: A divisão de conteúdo em várias respostas conectadas está temporariamente desabilitada. Postagens únicas e carrosséis continuam funcionando.

Exemplos

Postagem de Texto Simples

Publique isto no Threads:
"Acabei de descobrir um truque incrível de produtividade que me economizou 2 horas hoje. A chave é agrupar tarefas semelhantes."

Carrossel de Imagens

Crie um carrossel no Threads com estas 5 capturas de tela da evolução do produto.
Legenda: "Do conceito ao lançamento - nossa jornada de 6 meses. #buildinpublic"

Nota: Requer de 2 a 20 imagens. Vídeos em carrosséis não são suportados.

Conteúdo Longo (publicado como postagens separadas)

O encadeamento está desabilitado, então peça as partes explicitamente:

Publique isto no Threads como postagens separadas:
"Tópico: 7 erros que cometi como fundador de primeira viagem

---

1. Contratar muito rápido. Fomos de 2 para 15 em 3 meses. A cultura sofreu.

---

2. Ignorar a economia unitária. A receita parecia ótima até calcularmos o CAC..."

Postagem Agendada

Agende isto para amanhã às 10h:
"Motivação de segunda-feira: A melhor época para começar foi ontem. A segunda melhor época é agora."

Melhores Práticas

1. Gancho inicial: As primeiras 2 linhas determinam o engajamento — faça valer a pena
2. Comprimento ideal: 100-250 caracteres para postagens únicas têm bom desempenho
3. Conteúdo nativo: Postagens originais e conversacionais são recompensadas
4. Hashtag única: Use uma hashtag altamente relevante (limite da plataforma)
5. Sem opção de edição: Verifique o conteúdo duas vezes antes de publicar

Horários

• Melhores horários: 7-9h, 12-13h, 19-21h no fuso horário do público-alvo
• Frequência: 1 a 3 postagens por dia para crescimento
• Consistência: Postar regularmente sinaliza uma conta ativa

Engajamento

• Responda aos comentários na primeira hora
• Faça referência cruzada ao seu Instagram (as contas estão vinculadas)
• Use tópicos/palavras-chave relevantes para descoberta

Solução de Problemas

Erro	Causa	Solução
"Account not connected"	OAuth do Threads/Instagram expirou	Reconecte pelo painel Publora
"Content too long"	Postagem excede 500 caracteres e o encadeamento falhou	Adicione manualmente quebras ---
"Media upload failed"	Formato ou tamanho incorreto	Verifique: imagens < 8 MB, apenas JPEG/PNG
"Carousel requires 2-20 items"	Número errado de imagens	Certifique-se de ter 2 a 20 imagens para carrossel
Limite de 250 postagens/dia excedido	Limite de taxa atingido	Aguarde 24 horas