CommunityEscrita e Ediçãogithub.com

LinkedIn - Habilidades

Habilidades de automação do LinkedIn para agentes de IA – vendas, social selling, extração de dados e muito mais.

O que é LinkedIn - Habilidades?

Esta habilidade permite que agentes de IA (como Claude Code, Cursor, Codex) automatizem operações no LinkedIn por meio de uma interface de linha de comando (CLI). Ela oferece comandos para buscar perfis, pesquisar pessoas e empresas, enviar mensagens, gerenciar conexões, criar posts, reagir e comentar. A automação é executada em um navegador na nuvem real via a API Linked, portanto as operações podem levar de 30 segundos a vários minutos, dependendo da complexidade. O agente deve usar a flag `--json` para saída estruturada e o prefixo `LINKEDAPI_CLIENT=skill:linkedin` para atribuição de uso. A habilidade também cobre autenticação com dois tokens (Linked API Token e Identification Token), tratamento de erros com códigos de saída padronizados e recursos avançados como o Sales Navigator para assinantes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Linked-API/linkedin-skills

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade do LinkedIn

Você tem acesso a linkedin – uma ferramenta de CLI para automação do LinkedIn. Use-a para buscar perfis, pesquisar pessoas e empresas, enviar mensagens, gerenciar conexões, criar posts, reagir, comentar e muito mais.

Cada comando envia uma solicitação para a Linked API, que executa um navegador real na nuvem para realizar a ação no LinkedIn. As operações não são instantâneas – espere de 30 segundos a vários minutos, dependendo da complexidade.

Se linkedin não estiver disponível, instale-o:

npm install -g @linkedapi/linkedin-cli

Autenticação

Se um comando falhar com código de saída 2 (erro de autenticação), peça ao usuário para configurar sua conta:

  1. Acesse app.linkedapi.io e inscreva-se ou faça login
  2. Conecte sua conta do LinkedIn
  3. Copie o Token da API Linked e o Token de Identificação do painel

Depois que o usuário fornecer os tokens, execute:

linkedin setup --linked-api-token=TOKEN --identification-token=TOKEN

Flags Globais

Sempre use --json e -q para saída legível por máquina:

LINKEDAPI_CLIENT=skill:linkedin linkedin <comando> --json -q

Ao usar esta habilidade, execute cada linkedin ... dos exemplos abaixo com o prefixo LINKEDAPI_CLIENT=skill:linkedin para que a Linked API possa atribuir o uso à habilidade.

FlagDescrição
--jsonSaída JSON estruturada
--quiet / -qSuprime mensagens de progresso do stderr
--fields nome,url,...Selecionar campos específicos na saída
--no-colorDesativar cores
--account "Nome"Usar uma conta específica para este comando

Formato de Saída

Sucesso:

{"success": true, "data": {"name": "João Silva", "headline": "Engenheiro"}}

Erro:

{"success": false, "error": {"type": "personNotFound", "message": "Pessoa não encontrada"}}

Código de saída 0 significa que a chamada à API foi bem-sucedida – sempre verifique o campo success para o resultado da ação. Códigos de saída diferentes de zero indicam erros de infraestrutura:

Código de SaídaSignificado
0Sucesso (verifique o campo success – a ação pode ter retornado um erro como "pessoa não encontrada")
1Erro geral/inesperado
2Tokens ausentes ou inválidos
3Assinatura/plano necessário
4Problema na conta do LinkedIn
5Argumentos inválidos
6Limite de taxa excedido
7Erro de rede
8Tempo limite do workflow (workflowId retornado para recuperação)

Comandos

Buscar Perfil de Pessoa

linkedin person fetch <url> [flags] --json -q

Flags opcionais para incluir dados adicionais:

  • --experience – histórico de trabalho
  • --education – histórico educacional
  • --skills – lista de habilidades
  • --languages – idiomas
  • --posts – posts recentes (com --posts-limit N, --posts-since TIMESTAMP)
  • --comments – comentários recentes (com --comments-limit N, --comments-since TIMESTAMP)
  • --reactions – reações recentes (com --reactions-limit N, --reactions-since TIMESTAMP)

Solicite dados adicionais apenas quando necessário – cada flag aumenta o tempo de execução.

# Perfil básico
linkedin person fetch https://www.linkedin.com/in/nomeusuario --json -q

# Com experiência e educação
linkedin person fetch https://www.linkedin.com/in/nomeusuario --experience --education --json -q

# Com os últimos 5 posts
linkedin person fetch https://www.linkedin.com/in/nomeusuario --posts --posts-limit 5 --json -q

Pesquisar Pessoas

linkedin person search [flags] --json -q
FlagDescrição
--termPalavra-chave ou frase de pesquisa
--limitMáximo de resultados
--first-nameFiltrar por primeiro nome
--last-nameFiltrar por sobrenome
--positionFiltrar por cargo
--locationsLocalizações separadas por vírgula
--industriesIndústrias separadas por vírgula
--current-companiesNomes de empresas atuais separados por vírgula
--previous-companiesNomes de empresas anteriores separados por vírgula
--schoolsNomes de escolas separados por vírgula
linkedin person search --term "gerente de produto" --locations "São Francisco" --json -q
linkedin person search --current-companies "Google" --position "Engenheiro" --limit 20 --json -q

Buscar Empresa

linkedin company fetch <url> [flags] --json -q

Flags opcionais:

  • --employees – incluir funcionários
  • --dms – incluir tomadores de decisão
  • --posts – incluir posts da empresa

Filtros de funcionários (exigem --employees):

FlagDescrição
--employees-limitMáximo de funcionários a recuperar
--employees-first-nameFiltrar por primeiro nome
--employees-last-nameFiltrar por sobrenome
--employees-positionFiltrar por cargo
--employees-locationsLocalizações separadas por vírgula
--employees-industriesIndústrias separadas por vírgula
--employees-schoolsNomes de escolas separados por vírgula
FlagDescrição
--dms-limitMáximo de tomadores de decisão a recuperar (requer --dms)
--posts-limitMáximo de posts a recuperar (requer --posts)
--posts-sincePosts desde um timestamp ISO (requer --posts)
# Informações básicas da empresa
linkedin company fetch https://www.linkedin.com/company/nome --json -q

# Com funcionários filtrados por cargo
linkedin company fetch https://www.linkedin.com/company/nome --employees --employees-position "Engenheiro" --json -q

# Com tomadores de decisão e posts
linkedin company fetch https://www.linkedin.com/company/nome --dms --posts --posts-limit 10 --json -q

Pesquisar Empresas

linkedin company search [flags] --json -q
FlagDescrição
--termPalavra-chave de pesquisa
--limitMáximo de resultados
--sizesPortes separados por vírgula: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
--locationsLocalizações separadas por vírgula
--industriesIndústrias separadas por vírgula
linkedin company search --term "fintech" --sizes "11-50,51-200" --json -q

Enviar Mensagem

linkedin message send <url-da-pessoa> '<texto>' --json -q

Texto de até 1900 caracteres. Coloque a mensagem entre aspas simples para evitar problemas de interpretação do shell.

linkedin message send https://www.linkedin.com/in/nomeusuario 'Ei, adorei seu último post!' --json -q

Obter Conversa

linkedin message get <url-da-pessoa> [--since TIMESTAMP] --json -q

A primeira chamada para uma conversa aciona uma sincronização em segundo plano e pode demorar mais. Chamadas subsequentes são mais rápidas.

linkedin message get https://www.linkedin.com/in/nomeusuario --json -q
linkedin message get https://www.linkedin.com/in/nomeusuario --since 2024-01-15T10:30:00Z --json -q

Gerenciamento de Conexões

Verificar status da conexão

linkedin connection status <url> --json -q

Enviar solicitação de conexão

linkedin connection send <url> [--note 'texto'] [--email [email protected]] --json -q

Listar conexões

linkedin connection list [flags] --json -q
FlagDescrição
--limitMáximo de conexões a retornar
--sinceApenas conexões feitas desde um timestamp ISO (funciona apenas quando nenhuma flag de filtro é usada)
--first-nameFiltrar por primeiro nome
--last-nameFiltrar por sobrenome
--positionFiltrar por cargo
--locationsLocalizações separadas por vírgula
--industriesIndústrias separadas por vírgula
--current-companiesNomes de empresas atuais separados por vírgula
--previous-companiesNomes de empresas anteriores separados por vírgula
--schoolsNomes de escolas separados por vírgula
linkedin connection list --limit 50 --json -q
linkedin connection list --current-companies "Google" --position "Engenheiro" --json -q
linkedin connection list --since 2024-01-01T00:00:00Z --json -q

Listar solicitações pendentes enviadas

linkedin connection pending --json -q

Listar solicitações de conexão recebidas

Convites que outras pessoas enviaram para você (solicitações recebidas).

linkedin connection requests --json -q

Aceitar uma solicitação recebida

linkedin connection accept <url> --json -q

Ignorar uma solicitação recebida

linkedin connection ignore <url> --json -q

Retirar uma solicitação pendente

linkedin connection withdraw <url> [--no-unfollow] --json -q

Por padrão, retirar também deixa de seguir a pessoa. Use --no-unfollow para continuar seguindo.

Remover uma conexão

linkedin connection remove <url> --json -q

Posts

Buscar um post

linkedin post fetch <url> [flags] --json -q
FlagDescrição
--commentsIncluir comentários
--reactionsIncluir reações
--comments-limitMáximo de comentários a recuperar (requer --comments)
--comments-sortOrdem de classificação: mostRelevant ou mostRecent (requer --comments)
--comments-repliesIncluir respostas aos comentários (requer --comments)
--reactions-limitMáximo de reações a recuperar (requer --reactions)
linkedin post fetch https://www.linkedin.com/posts/nomeusuario_activity-123 --json -q

# Com comentários ordenados por mais recentes, incluindo respostas
linkedin post fetch https://www.linkedin.com/posts/nomeusuario_activity-123 \
  --comments --comments-sort mostRecent --comments-replies --json -q

Criar um post

linkedin post create '<texto>' [flags] --json -q
FlagDescrição
--company-urlPostar em nome de uma página da empresa (requer acesso de administrador)
--attachmentsAnexo no formato url:tipo ou url:tipo:nome. Tipos: image, video, document. Pode ser especificado várias vezes.

Limites de anexos: até 9 imagens, ou 1 vídeo, ou 1 documento. Não é possível misturar tipos.

linkedin post create 'Animado para compartilhar nossa última atualização!' --json -q

# Com um documento
linkedin post create 'Nosso relatório Q4' \
  --attachments "https://exemplo.com/relatorio.pdf:document:Relatório Q4" --json -q

# Postar como empresa
linkedin post create 'Anúncio da empresa' \
  --company-url https://www.linkedin.com/company/nome --json -q

Reagir a um post

linkedin post react <url> --type <reação> [--company-url <url>] --json -q

Tipos de reação: like, love, support, celebrate, insightful, funny.

linkedin post react https://www.linkedin.com/posts/nomeusuario_activity-123 --type like --json -q

# Reagir em nome de uma empresa
linkedin post react https://www.linkedin.com/posts/nomeusuario_activity-123 --type celebrate \
  --company-url https://www.linkedin.com/company/nome --json -q

Comentar em um post

linkedin post comment <url> '<texto>' [--company-url <url>] --json -q

Texto de até 1000 caracteres.

linkedin post comment https://www.linkedin.com/posts/nomeusuario_activity-123 'Ótimas ideias!' --json -q

# Comentar em nome de uma empresa
linkedin post comment https://www.linkedin.com/posts/nomeusuario_activity-123 'Muito bem dito!' \
  --company-url https://www.linkedin.com/company/nome --json -q

Estatísticas

# Índice de Social Selling
linkedin stats ssi --json -q

# Analytics de desempenho (visualizações de perfil, impressões de posts, aparições em pesquisa)
linkedin stats performance --json -q

# Uso da API para um intervalo de datas
linkedin stats usage --start 2024-01-01T00:00:00Z --end 2024-01-31T00:00:00Z --json -q

Sales Navigator

Requer uma assinatura do LinkedIn Sales Navigator. Usa URLs com hash para consultas de pessoas/empresas.

Buscar pessoa

linkedin navigator person fetch <url-com-hash> --json -q

Pesquisar pessoas

linkedin navigator person search [flags] --json -q
FlagDescrição
--termPalavra-chave ou frase de pesquisa
--limitMáximo de resultados
--first-nameFiltrar por primeiro nome
--last-nameFiltrar por sobrenome
--positionFiltrar por cargo
--locationsLocalizações separadas por vírgula
--industriesIndústrias separadas por vírgula
--current-companiesNomes de empresas atuais separados por vírgula
--previous-companiesNomes de empresas anteriores separados por vírgula
--schoolsNomes de escolas separados por vírgula
--years-of-experienceFaixas de anos de experiência separadas por vírgula: lessThanOne, oneToTwo, threeToFive, sixToTen, moreThanTen
linkedin navigator person search --term "VP de Marketing" --locations "Estados Unidos" --json -q
linkedin navigator person search --years-of-experience "moreThanTen" --position "CEO" --json -q

Buscar empresa

linkedin navigator company fetch <url-com-hash> [flags] --json -q

Flags opcionais:

  • --employees – incluir funcionários
  • --dms – incluir tomadores de decisão

Filtros de funcionários (exigem --employees):

FlagDescrição
--employees-limitMáximo de funcionários a recuperar
--employees-first-nameFiltrar por primeiro nome
--employees-last-nameFiltrar por sobrenome
--employees-positionsCargos separados por vírgula
--employees-locationsLocalizações separadas por vírgula
--employees-industriesIndústrias separadas por vírgula
--employees-schoolsNomes de escolas separados por vírgula
--employees-years-of-experienceFaixas de experiência separadas por vírgula
--dms-limitMáximo de tomadores de decisão a recuperar (requer --dms)
linkedin navigator company fetch https://www.linkedin.com/sales/company/97ural --employees --dms --json -q
linkedin navigator company fetch https://www.linkedin.com/sales/company/97ural \
  --employees --employees-positions "Engenheiro,Designer" --employees-locations "Europa" --json -q

Pesquisar empresas

linkedin navigator company search [flags] --json -q
FlagDescrição
--termPalavra-chave de pesquisa
--limitMáximo de resultados
--sizesPortes separados por vírgula: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+
--locationsLocalizações separadas por vírgula
--industriesIndústrias separadas por vírgula
--revenue-minReceita anual mínima em milhões de USD: 0, 0.5, 1, 2.5, 5, 10, 20, 50

... [truncado para tradução]

Habilidades Relacionadas