publora/linkedin-analytics

LinkedIn Analytics

Monitore impressões, engajamento e crescimento de seguidores para suas postagens e perfil do LinkedIn, e interaja com postagens por meio de reações, comentários e compartilhamentos. As estatísticas vêm da API REST; reações, comentários, compartilhamentos e consultas a menções são ferramentas MCP.

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 da API em app.publora.com/dashboard/api
4. 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"

O 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 para 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):

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

# Obter estatísticas de postagem
curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "postedId": "urn:li:share:7123456789012345678",
    "queryTypes": "ALL"
  }'

# Obter estatísticas da conta
curl -X POST "https://api.publora.com/api/v1/linkedin-account-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "queryTypes": "ALL"
  }'

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

Ferramentas de Análise (apenas REST)

As análises do LinkedIn não são expostas como ferramentas MCP. O servidor MCP oferece ferramentas de postagem, mídia e engajamento do LinkedIn; as estatísticas residem apenas na API REST, então chame esses endpoints diretamente com o cabeçalho x-publora-key. Pedir a um agente por uma ferramenta MCP linkedin_post_stats falhará: essa ferramenta não existe.

POST /linkedin-post-statistics

Métricas de engajamento para uma postagem.

Corpo da requisição:

• platformId: ID da conexão da plataforma (ex.: linkedin-abc123), obtido de list_connections
• postedId: URN da postagem (urn:li:share:... ou urn:li:ugcPost:...)
• queryTypes (opcional): IMPRESSION, MEMBERS_REACHED, RESHARE, REACTION, COMMENT ou ALL

Retorna: impressões, impressões únicas (membros alcançados), reações, comentários, compartilhamentos e um sinalizador cached indicando se os números vieram do cache.

POST /linkedin-account-statistics

Estatísticas agregadas para a conta.

Corpo da requisição: platformId, queryTypes opcional, aggregation opcional (DAILY ou TOTAL, padrão TOTAL).

POST /linkedin-followers

Número de seguidores ou crescimento ao longo do tempo.

Corpo da requisição: platformId, period opcional (lifetime ou daily), dateRange opcional ({start: {year, month, day}, end: {year, month, day}}).

POST /linkedin-profile-summary

Visão geral combinada do perfil: seguidores e estatísticas.

Corpo da requisição: platformId, dateRange opcional.

curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"platformId": "linkedin-abc123", "postedId": "urn:li:share:7123456789012345678", "queryTypes": "ALL"}'

Ferramentas de Engajamento

linkedin_create_reaction

Reaja a uma postagem do LinkedIn.

Parâmetros:

• postedId: URN da postagem do LinkedIn
• platformId: ID da conexão da plataforma
• reactionType: Um dos seguintes:

Tipo	Descrição
LIKE	Polegar para cima padrão
PRAISE	Palmas / aplausos
EMPATHY	Coração / amor
INTEREST	Lâmpada / perspicaz
APPRECIATION	Apoio
ENTERTAINMENT	Engraçado / risos

linkedin_delete_reaction

Remova sua reação de uma postagem.

Parâmetros:

• postedId: URN da postagem do LinkedIn
• platformId: ID da conexão da plataforma

linkedin_create_comment

Publique um comentário em uma postagem do LinkedIn (máximo de 1.250 caracteres).

Parâmetros:

• postedId: URN da postagem do LinkedIn
• platformId: ID da conexão da plataforma
• message: Texto do comentário (máx. 1.250 caracteres)
• parentComment (opcional): URN do comentário para respostas aninhadas

linkedin_delete_comment

Remova um comentário que você fez.

Parâmetros:

• postedId: URN da postagem do LinkedIn
• commentId: URN do comentário ou ID numérico
• platformId: ID da conexão da plataforma

linkedin_create_reshare

Compartilhe uma postagem existente, com comentário opcional.

Parâmetros:

• platformId: ID da conexão da plataforma
• parent: a postagem a ser compartilhada, como uma URN de compartilhamento (urn:li:share:... ou urn:li:ugcPost:...). Observe o nome: esta ferramenta usa parent, não postedId como as ferramentas de reação e comentário.
• commentary (opcional): seu texto acima do compartilhamento, até 3.000 caracteres
• visibility (opcional): PUBLIC ou CONNECTIONS, padrão PUBLIC. CONNECTIONS é para contas pessoais.

Nota: uma URL do feed do LinkedIn carrega um ID de activity, que nem sempre é o mesmo que o ID do compartilhamento. Use o postedId retornado por get_post, não um ID de atividade convertido manualmente.

linkedin_list_mentionables

Resolva nomes para as URNs que as menções @ precisam, para que você nunca precise escrever um ID de membro manualmente.

Parâmetros:

• q (opcional): o nome a ser pesquisado
• limit (opcional): quantos resultados retornar

Ambos são opcionais, e esta ferramenta não aceita platformId: ela pesquisa em toda a conta, não em uma conexão específica.

Exemplos de Comandos

Revisão de Desempenho Semanal

Analise meu desempenho no LinkedIn nos últimos 7 dias.
Mostre:
1. Quais postagens tiveram melhor desempenho
2. Minhas tendências de taxa de engajamento
3. Crescimento de seguidores
4. Recomendações para melhoria

Análise de Postagem

Obtenha estatísticas detalhadas das minhas últimas 5 postagens no LinkedIn e identifique padrões no conteúdo que ressoa com meu público.

Campanha de Engajamento

Reaja com PRAISE à postagem do meu colega sobre sua promoção (urn:li:share:123456) e adicione um comentário de felicitações.

Acompanhamento de Seguidores

Mostre meu crescimento de seguidores no LinkedIn nos últimos 30 dias. Quantos novos seguidores ganhei a cada semana?

Referência de Métricas

Métrica	Descrição
IMPRESSION	Total de vezes que o conteúdo apareceu nos feeds
MEMBERS_REACHED	Membros únicos do LinkedIn que viram a postagem
RESHARE	Número de republicações/compartilhamentos
REACTION	Total de reações (todos os tipos combinados)
COMMENT	Número de comentários

Benchmarks de Taxa de Engajamento

Taxas médias de engajamento no LinkedIn por número de seguidores:

Seguidores	Boa Taxa de Engajamento
< 5K	3-5%
5K-50K	2-3%
50K+	1-2%

Postagens com bom desempenho geralmente têm:

• 2x suas impressões médias
• Proporção de comentários para reações acima de 10%
• Taxa de engajamento acima da sua linha de base

Notas Importantes

1. Atraso nas análises: As análises do LinkedIn podem levar até 24 horas para serem totalmente preenchidas. Consultar imediatamente após a postagem retorna dados parciais.

2. Formatos de URN: As URLs do LinkedIn usam urn:li:activity:xxx, mas a API requer urn:li:share:xxx ou urn:li:ugcPost:xxx. Use o postedId da resposta de get_post da Publora para URNs precisas.

3. Cache: As respostas de análise podem ser armazenadas em cache. A resposta inclui um campo cached indicando se os dados vieram do cache.

4. Limites de taxa: O LinkedIn tem aproximadamente 200+ chamadas de API por hora. Implemente backoff em erros 429.

Solução de Problemas

Erro	Causa	Solução
"Platform ID not found"	ID de conexão inválido	Execute list_connections para obter IDs válidos
"Post not found"	Formato de URN incorreto	Use o formato urn:li:share: ou urn:li:ugcPost:
429 Too Many Requests	Limite de taxa excedido	Aguarde e tente novamente com backoff exponencial
"message cannot exceed 1250 characters"	Comentário muito longo	Encurte o comentário para menos de 1.250 caracteres