publora/linkedin-post

LinkedIn Post

Crie e agende postagens no LinkedIn usando o servidor MCP Publora. Suporta postagens de texto, imagens individuais, postagens com múltiplas imagens (layout em grade), vídeos e documentos PDF.

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 LinkedIn via OAuth 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 claude.ai precisam de um arquivo ou fluxo de configuração diferente: veja configuração do cliente para o caminho e trecho exatos.

Fallback da API REST

Se o servidor MCP estiver indisponível ou retornar erros, use a API REST diretamente:

URL Base: https://api.publora.com/api/v1

Autenticação: Use o cabeçalho x-publora-key (NÃO Authorization: Bearer):

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

# Crie 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": ["linkedin-Tz9W5i6ZYG"],
    "content": "Conteúdo da sua postagem aqui",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

Formato do ID da Plataforma: linkedin-{id} onde {id} vem da resposta de /platform-connections.

Exemplos de IDs: linkedin-Tz9W5i6ZYG, linkedin-abc123xyz

📖 Documentação completa da API: docs.publora.com

Limites da Plataforma

Recurso	Limite
Caracteres	Máximo de 3.000
Visível antes de "ver mais"	Primeiros 210 caracteres
Imagens	Até 10 (layout em grade, não carrossel navegável)
Tamanho da imagem	36.152.320 pixels é o limite principal; teto de 50 MB
Formatos de imagem	JPEG, PNG, GIF, WebP (WebP é convertido automaticamente)
Duração do vídeo	30 minutos
Tamanho do vídeo	Máximo de 500 MB
Formato de vídeo	Apenas MP4

Ferramentas Disponíveis

create_post

Crie uma nova postagem no LinkedIn ou agende para depois.

Parâmetros:

• platforms: Array contendo o ID da sua conexão LinkedIn (ex.: ["linkedin-abc123"])
• content: Texto da postagem (até 3.000 caracteres)
• scheduledTime: Data/hora UTC no formato ISO 8601. Opcional: omita e a postagem será criada como rascunho. Envie um horário futuro para agendar. Um horário de cinco ou mais minutos no passado é rejeitado com SCHEDULED_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. O 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 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

Obtenha uma URL pré-assinada para fazer upload de mídia.

Parâmetros:

• postGroupId: O ID da postagem à qual anexar a mídia
• fileName: Nome do arquivo (ex.: "chart.png")
• contentType: Tipo MIME (ex.: "image/jpeg", "video/mp4", "application/pdf")
• type: "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, porque o agendamento também finaliza mídia pendente, mas chamá-lo cedo expõe erros de formato e probe 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

Liste suas contas conectadas com seus IDs de plataforma. Chame este primeiro e copie os IDs exatamente; eles nunca são adivinháveis.

list_posts / get_post / update_post / delete_post

Gerencie postagens agendadas e rascunhos. update_post também corrige content e platforms em um rascunho ou postagem agendada, 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.

Menção a Pessoas e Empresas

Postagens no LinkedIn suportam @menções usando sintaxe URN:

@{urn:li:person:MEMBER_ID|Nome de Exibição}       # Mencionar uma pessoa
@{urn:li:organization:ORG_ID|Nome da Empresa}    # Mencionar uma empresa

Exemplo:

Ótimas ideias de @{urn:li:person:4986615|Serge Bulaev} na @{urn:li:organization:107107343|Creative Content Crafts Inc}!

Importante: O nome de exibição deve corresponder exatamente ao nome do perfil no LinkedIn (diferença entre maiúsculas e minúsculas), incluindo sufixos da empresa como "Inc", "LLC", etc.

Não escreva IDs de membros manualmente. A ferramenta MCP linkedin_list_mentionables resolve um nome para a URN correta; veja a skill linkedin-analytics.

Restrições Importantes da API

1. Sem carrosséis orgânicos: Carrosséis de múltiplas imagens navegáveis NÃO estão disponíveis via API (apenas para conteúdo patrocinado). Postagens com múltiplas imagens aparecem como um layout em grade.

2. Sem mídia mista: Não é possível combinar imagens com vídeos ou documentos na mesma postagem.

3. Sem texto formatado: A API do LinkedIn não suporta negrito, itálico ou outras formatações. Use texto simples ou caracteres Unicode para ênfase.

4. PDF como alternativa para carrosséis: Para compartilhar conteúdo navegável de várias páginas, faça upload de um documento PDF.

Exemplos

Postagem de Texto Simples

Agende uma postagem no LinkedIn para amanhã às 9h:
"Estamos entusiasmados em anunciar o lançamento do nosso assistente de escrita com IA. Após 18 meses de desenvolvimento, estamos prontos para ajudar equipes a escrever conteúdo melhor e mais rápido."

Postagem com Menção

Crie uma postagem no LinkedIn mencionando nosso CEO:
"Animado em compartilhar ideias de @{urn:li:person:4986615|Serge Bulaev} sobre o futuro da IA na criação de conteúdo."

Postagem com Múltiplas Imagens

Crie uma postagem no LinkedIn com 4 capturas de tela do produto mostrando os novos recursos do painel.

Nota: As imagens aparecerão em um layout de grade, não como um carrossel navegável.

Postagem com Documento PDF

Compartilhe nosso relatório do Q4 como um PDF no LinkedIn com uma legenda resumida.

Esta é a melhor maneira de compartilhar conteúdo estilo carrossel de várias páginas.

Melhores Práticas

1. A primeira linha importa: Os primeiros 210 caracteres aparecem antes de "ver mais" - torne-os atraentes
2. Tamanho ideal: Postagens com menos de 1.300 caracteres tendem a ter melhor desempenho
3. Horários de postagem: Terça a quinta-feira, 8h-10h no fuso horário do seu público
4. Hashtags: Use de 3 a 5 hashtags relevantes - elas são suportadas como texto simples
5. Engajamento: Termine com uma pergunta para incentivar comentários

Solução de Problemas

Erro	Causa	Solução
"Conta não conectada"	OAuth do LinkedIn expirou	Reconecte no painel Publora
"MEDIA_ASSET_PROCESSING_FAILED"	Arquivo muito grande ou formato incorreto	Verifique: imagens < 5 MB, vídeos < 500 MB MP4
"Limitado por taxa" (429)	Muitas chamadas de API	Aguarde e tente novamente com backoff
"Não é possível misturar tipos de mídia"	Imagens + vídeo na mesma postagem	Use apenas um tipo de mídia por postagem
MCP indisponível	Problema no servidor	Use o fallback da API REST (veja acima)