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:
- Acesse app.linkedapi.io e inscreva-se ou faça login
- Conecte sua conta do LinkedIn
- 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.
| Flag | Descrição |
|---|---|
--json | Saída JSON estruturada |
--quiet / -q | Suprime mensagens de progresso do stderr |
--fields nome,url,... | Selecionar campos específicos na saída |
--no-color | Desativar 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ída | Significado |
|---|---|
| 0 | Sucesso (verifique o campo success – a ação pode ter retornado um erro como "pessoa não encontrada") |
| 1 | Erro geral/inesperado |
| 2 | Tokens ausentes ou inválidos |
| 3 | Assinatura/plano necessário |
| 4 | Problema na conta do LinkedIn |
| 5 | Argumentos inválidos |
| 6 | Limite de taxa excedido |
| 7 | Erro de rede |
| 8 | Tempo 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
| Flag | Descrição |
|---|---|
--term | Palavra-chave ou frase de pesquisa |
--limit | Máximo de resultados |
--first-name | Filtrar por primeiro nome |
--last-name | Filtrar por sobrenome |
--position | Filtrar por cargo |
--locations | Localizações separadas por vírgula |
--industries | Indústrias separadas por vírgula |
--current-companies | Nomes de empresas atuais separados por vírgula |
--previous-companies | Nomes de empresas anteriores separados por vírgula |
--schools | Nomes 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):
| Flag | Descrição |
|---|---|
--employees-limit | Máximo de funcionários a recuperar |
--employees-first-name | Filtrar por primeiro nome |
--employees-last-name | Filtrar por sobrenome |
--employees-position | Filtrar por cargo |
--employees-locations | Localizações separadas por vírgula |
--employees-industries | Indústrias separadas por vírgula |
--employees-schools | Nomes de escolas separados por vírgula |
| Flag | Descrição |
|---|---|
--dms-limit | Máximo de tomadores de decisão a recuperar (requer --dms) |
--posts-limit | Máximo de posts a recuperar (requer --posts) |
--posts-since | Posts 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
| Flag | Descrição |
|---|---|
--term | Palavra-chave de pesquisa |
--limit | Máximo de resultados |
--sizes | Portes separados por vírgula: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
--locations | Localizações separadas por vírgula |
--industries | Indú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
| Flag | Descrição |
|---|---|
--limit | Máximo de conexões a retornar |
--since | Apenas conexões feitas desde um timestamp ISO (funciona apenas quando nenhuma flag de filtro é usada) |
--first-name | Filtrar por primeiro nome |
--last-name | Filtrar por sobrenome |
--position | Filtrar por cargo |
--locations | Localizações separadas por vírgula |
--industries | Indústrias separadas por vírgula |
--current-companies | Nomes de empresas atuais separados por vírgula |
--previous-companies | Nomes de empresas anteriores separados por vírgula |
--schools | Nomes 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
| Flag | Descrição |
|---|---|
--comments | Incluir comentários |
--reactions | Incluir reações |
--comments-limit | Máximo de comentários a recuperar (requer --comments) |
--comments-sort | Ordem de classificação: mostRelevant ou mostRecent (requer --comments) |
--comments-replies | Incluir respostas aos comentários (requer --comments) |
--reactions-limit | Má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
| Flag | Descrição |
|---|---|
--company-url | Postar em nome de uma página da empresa (requer acesso de administrador) |
--attachments | Anexo 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
| Flag | Descrição |
|---|---|
--term | Palavra-chave ou frase de pesquisa |
--limit | Máximo de resultados |
--first-name | Filtrar por primeiro nome |
--last-name | Filtrar por sobrenome |
--position | Filtrar por cargo |
--locations | Localizações separadas por vírgula |
--industries | Indústrias separadas por vírgula |
--current-companies | Nomes de empresas atuais separados por vírgula |
--previous-companies | Nomes de empresas anteriores separados por vírgula |
--schools | Nomes de escolas separados por vírgula |
--years-of-experience | Faixas 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):
| Flag | Descrição |
|---|---|
--employees-limit | Máximo de funcionários a recuperar |
--employees-first-name | Filtrar por primeiro nome |
--employees-last-name | Filtrar por sobrenome |
--employees-positions | Cargos separados por vírgula |
--employees-locations | Localizações separadas por vírgula |
--employees-industries | Indústrias separadas por vírgula |
--employees-schools | Nomes de escolas separados por vírgula |
--employees-years-of-experience | Faixas de experiência separadas por vírgula |
--dms-limit | Má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
| Flag | Descrição |
|---|---|
--term | Palavra-chave de pesquisa |
--limit | Máximo de resultados |
--sizes | Portes separados por vírgula: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
--locations | Localizações separadas por vírgula |
--industries | Indústrias separadas por vírgula |
--revenue-min | Receita anual mínima em milhões de USD: 0, 0.5, 1, 2.5, 5, 10, 20, 50 |
... [truncado para tradução]