Como extrair um perfil do LinkedIn com agentes de IA

Para extrair um perfil do LinkedIn com um agente de IA, forneça a URL completa e peça que ele use linkedin_lookup_profile da SalesTouch. O resultado contém dados estruturados que o agente pode verificar, resumir, comparar ou formatar para o próximo fluxo.

Essa abordagem é ideal para pesquisar uma pessoa quando você precisa dos dados. Não é necessário criar um scraper em Python, manter seletores, usar uma extensão nem copiar cada campo manualmente.

A maneira mais rápida de extrair um perfil do LinkedIn

Depois de conectar a SalesTouch, o fluxo é um único prompt:

O agente chama a SalesTouch, recebe os dados disponíveis e formata a resposta. Verificar a identidade, marcar campos ausentes ou preparar uma exportação faz parte do prompt, não de outra etapa do produto.

Use a URL completa linkedin.com/in/ sempre que possível. Ela é menos ambígua que um nome e mais confiável que um resultado de busca, captura ou redirecionamento curto.

O que é a SalesTouch e por que você precisa dela?

Um agente pode raciocinar sobre texto, mas colar uma URL do LinkedIn no chat não oferece acesso ao perfil ao vivo. Ele precisa de uma ferramenta para fazer a consulta.

A SalesTouch é um MCP hospedado do LinkedIn para agentes de IA. O MCP permite que Claude, Codex e outros agentes descubram e chamem ferramentas externas. Neste fluxo:

1. Seu agente de IA entende a solicitação e decide como usar o resultado.
2. A SalesTouch fornece ferramentas autenticadas do LinkedIn e retorna dados estruturados.
3. Sua conta conectada do LinkedIn determina quais informações estão disponíveis.

Essa separação evita colocar sua senha ou cookies do LinkedIn no prompt. Você conecta o LinkedIn na SalesTouch e autoriza o agente a usar o MCP.

Quais dados do perfil do LinkedIn podem ser extraídos?

A chamada linkedin_lookup_profile retorna dados normalizados, não uma captura nem o HTML bruto. Conforme o perfil e o acesso da conta conectada, o resultado pode incluir:

• nome completo e título
• cargo e empresa atuais
• localização
• URL canônica do perfil
• identificadores do perfil do LinkedIn
• outros campos públicos disponíveis

Os campos exatos variam. O prompt deve pedir ao agente que marque valores ausentes como indisponíveis, em vez de adivinhar.

A chamada não é um serviço de enriquecimento de contatos. Ela não promete e-mail, telefone, dados privados nem campos inacessíveis para a conta conectada.

Adicionar contexto de empresa, publicações ou conversa

A consulta deve permanecer focada na pessoa. Para uma pesquisa mais completa, peça ao agente para combiná-la com outra chamada da SalesTouch:

São chamadas separadas, não opções ocultas de linkedin_lookup_profile. Assim, o fluxo permanece preciso: solicite apenas o contexto necessário e deixe cada fonte visível.

Configure a SalesTouch uma única vez

Se nunca usou a SalesTouch, conclua esta configuração antes dos prompts:

1. Crie uma conta da SalesTouch.
2. Conecte na SalesTouch a conta do LinkedIn que fará as consultas.
3. Adicione o MCP remoto ao cliente. Use o guia do Claude ou o guia do Codex.

O endpoint hospedado é https://www.salestouch.io/api/mcp. Seu cliente autoriza a conexão e descobre as ferramentas disponíveis.

Para conferir a configuração, peça ao agente para listar contas conectadas ou ferramentas. linkedin_lookup_profile deve aparecer. Se estiver ausente, atualize a conexão ou inicie uma nova conversa.

Como funciona a consulta de perfil

A consulta é propositalmente pequena. Ela tem uma entrada obrigatória e outra opcional.

A chamada é somente leitura. Ela retorna conteúdo de texto MCP com JSON formatado e dados disponíveis. O agente pode transformá-lo no formato solicitado.

A consulta de perfil não aceita:

• um limit para publicações
• uma opção que adicione empresa ou publicações automaticamente
• uma expressão cron ou valor scheduled_for
• uma opção nativa de exportação CSV ou JSONL

Para publicações, use linkedin_lookup_profile_posts com o mesmo identificador e um limit opcional de 1 a 100. Para empresas, use linkedin_lookup_company. Para recorrência, o cliente de IA ou host de automação repete o prompt.

Casos de uso e prompts para extrair perfis do LinkedIn

Escolha o prompt conforme a decisão ou entrega necessária. Cada exemplo usa a mesma consulta em um fluxo real diferente.

Qualificar rapidamente um perfil

Use antes de aceitar um lead, preparar uma reunião ou decidir se alguém corresponde ao seu público.

Use a SalesTouch para consultar este perfil do LinkedIn:
https://www.linkedin.com/in/example/

Chame linkedin_lookup_profile antes de responder.

Retorne um resumo breve de qualificação com:
1. Nome completo e título.
2. Cargo e empresa atuais.
3. Localização.
4. Dois fatos relevantes para entender o contexto profissional.
5. Uma linha separada "Dados ausentes".

Primeiro, confirme que a URL e a identidade correspondem à minha entrada.
Separe os fatos da sua análise. Não deduza dados ausentes
nem execute ações de escrita no LinkedIn.

Criar um relatório de perfil, empresa e conteúdo

Use quando o perfil básico não for suficiente. O prompt adiciona contexto da empresa e publicações por chamadas separadas.

Pesquise esta pessoa com a SalesTouch:
https://www.linkedin.com/in/example/

1. Chame linkedin_lookup_profile para a pessoa.
2. Chame linkedin_lookup_profile_posts para o mesmo perfil com limit 10.
3. Se o perfil contiver URL, handle ou identificador resolvível da empresa
   atual, chame linkedin_lookup_company.
4. Se não houver identificador resolvível, informe a limitação e não invente um.

Retorne quatro seções:
- Perfil verificado
- Empresa atual
- Temas recentes das publicações
- Dados ausentes ou indisponíveis

Informe a fonte da SalesTouch em cada seção. Separe fatos da análise.
Não envie mensagens nem execute ações de escrita no LinkedIn.

Esse fluxo revela contexto profissional que uma única consulta talvez não forneça. A origem fica clara porque cada seção corresponde a uma ferramenta.

Criar uma linha CSV pronta para o CRM

Use para colar ou salvar um registro verificado em uma planilha ou CRM. O agente cria o CSV a partir do perfil.

Use a SalesTouch para chamar linkedin_lookup_profile para:
https://www.linkedin.com/in/example/

Verifique se a identidade corresponde à URL. Depois, retorne exatamente
duas linhas de CSV válido com este cabeçalho:
full_name,headline,current_role,current_company,location,linkedin_url,linkedin_id

Regras:
- Coloque todos os valores entre aspas duplas.
- Escape aspas duplas conforme as regras do CSV.
- Deixe vazios os campos indisponíveis.
- Não deduza nem enriqueça dados ausentes.
- Retorne apenas o cabeçalho e uma linha, sem bloco Markdown ou comentários.

Se o agente criar arquivos, acrescente: Salve o resultado como linkedin-profile.csv e me dê o arquivo. O arquivo é criado pelo agente, não exportado nativamente por linkedin_lookup_profile.

Retornar JSON estrito para outro agente ou API

Use JSON quando outro sistema processar o registro e um esquema estável for mais importante que a leitura.

Use a SalesTouch para chamar linkedin_lookup_profile para:
https://www.linkedin.com/in/example/

Retorne um objeto JSON válido com exatamente estas chaves:
full_name
headline
current_role
current_company
location
linkedin_url
linkedin_identifiers
unavailable_fields
source_tool

Use null para um valor escalar indisponível e um array vazio para uma lista.
Defina source_tool como "linkedin_lookup_profile". Não deduza dados ausentes.
Retorne somente JSON, sem bloco Markdown ou comentários.

Monitorar um perfil toda semana

Use se o cliente aceitar tarefas recorrentes. O cliente gerencia o horário e pede à SalesTouch uma consulta nova em cada execução.

Crie uma tarefa recorrente chamada "Verificação semanal de perfil do LinkedIn".

Agenda: toda segunda-feira às 09:00 Europe/Paris.

Em cada execução:
1. Chame linkedin_lookup_profile da SalesTouch para:
   https://www.linkedin.com/in/example/
2. Verifique a identidade e normalize nome completo, título, cargo atual,
   empresa atual, localização e URL canônica do LinkedIn.
3. Compare o resultado com a execução bem-sucedida anterior.
4. Informe apenas mudanças confirmadas com valores antigo e novo.
5. Na primeira execução, salve o resultado como referência.
6. Se não for possível guardar ou recuperar o histórico, informe a limitação
   em vez de afirmar que nada mudou.

Use apenas dados da SalesTouch. Não deduza fatos, envie mensagens
nem execute ações de escrita no LinkedIn.

Não adicione parâmetros de agendamento à consulta. A recorrência pertence ao cliente ou host de automação, que repete o prompt e inicia uma nova chamada.

Escolher o formato certo de saída ou exportação

O formato depende do que acontece depois.

Para um perfil, linkedin_lookup_profile retorna uma resposta estruturada pelo MCP, mas não um link. Peça ao agente para converter em JSON, CSV ou arquivo.

Nas extrações em massa, as ferramentas scrape_* usam outro fluxo. Elas salvam o conjunto, retornam prévia e result_id, e oferecem links assinados CSV e JSONL. Use scrape_result_page para ler outras páginas sem carregar tudo no contexto.

Como deve ser um resultado verificado

Uma resposta correta deve mostrar a fonte e a incerteza. Antes de reutilizar os dados, verifique se:

1. A chamada terminou com sucesso.
2. O nome e a URL canônica correspondem à pessoa.
3. Cargo, empresa e localização vieram do resultado.
4. Campos ausentes estão marcados como indisponíveis.
5. A análise está separada dos fatos obtidos.
6. Nenhum contato não compatível foi adicionado.

Ao combinar chamadas, confirme também que a empresa corresponde ao cargo atual e as publicações pertencem ao membro resolvido. Um resultado parcial continua útil se o agente indicar qual chamada ou campo não estava disponível.

Um perfil ou uma extração em massa?

Use linkedin_lookup_profile quando já conhece a pessoa e precisa de contexto recente para pesquisa, qualificação, personalização ou monitoramento.

Use uma ferramenta em massa quando a fonte for pesquisa de pessoas ou Sales Navigator, grupo, lista de conexões, audiência de publicação ou outra fonte com vários registros. Essas ferramentas são criadas para resultados salvos, paginação e downloads.

Não transforme automaticamente uma tarefa para uma pessoa em extração em massa. A chamada pequena é mais rápida de revisar, fácil de verificar e alinhada à decisão imediata.

Por que a SalesTouch é a melhor forma de fazer isso

A SalesTouch oferece ao agente uma interface controlada, em vez de pedir credenciais no prompt, executar um script desconhecido ou expor cookies a uma extensão.

As proteções práticas são:

• senha e cookies do LinkedIn ficam fora do prompt
• a conexão MCP é autorizada separadamente
• linkedin_lookup_profile é uma chamada tipada somente leitura
• ações de escrita usam ferramentas separadas e exigem intenção explícita
• a conta conectada limita o acesso
• prompts podem proibir deduções e ações de escrita

Nenhum método de automação do LinkedIn é isento de risco. O Contrato do Usuário e as orientações sobre software proibido restringem extração e automação não autorizadas. A SalesTouch não anula essas regras nem sugere endosso do LinkedIn.

Use dados de perfil para uma finalidade legítima e proporcional. Evite informações sensíveis, não deduza características protegidas, reduza a retenção e revise as leis e regras aplicáveis.

Erros comuns e como corrigir

O agente não vê as ferramentas da SalesTouch

A conexão MCP está ausente ou desatualizada. Reconecte a SalesTouch, inicie uma conversa nova e peça ao agente para listar as ferramentas.

Nenhuma conta do LinkedIn está disponível

Conecte o LinkedIn na SalesTouch. A conexão MCP leva o agente à SalesTouch e a conexão do LinkedIn fornece a conta para a consulta.

A pessoa errada é retornada

Tente novamente com a URL canônica completa linkedin.com/in/. Evite um nome comum e peça para comparar a URL retornada antes de continuar.

Alguns campos estão vazios

A disponibilidade varia por perfil e conta. Trate dados ausentes como indisponíveis e não peça ao agente para preencher lacunas com suposições.

O agente afirma que exportou um CSV nativo

Para um perfil, CSV é uma transformação do agente. Links nativos CSV e JSONL pertencem aos resultados em massa scrape_*. Peça para indicar o mecanismo usado.

Perguntas frequentes

ChatGPT, Claude ou Codex pode extrair sozinho um perfil do LinkedIn?

Não apenas a partir de uma URL. O agente precisa de uma ferramenta conectada. A SalesTouch oferece essa ferramenta por MCP, e o agente cuida do raciocínio e da saída.

A consulta retorna e-mails ou telefones?

Nenhum contato é garantido. linkedin_lookup_profile retorna informações acessíveis para a conta conectada. Trate o enriquecimento como outro fluxo com fontes e regras próprias.

Posso obter as publicações da pessoa?

Sim. Peça linkedin_lookup_profile_posts separadamente com o identificador e limite opcional de 1 a 100. Os resultados são dos mais recentes aos mais antigos e podem incluir publicações com mais de 30 dias.

Posso consultar a empresa da pessoa?

Sim. Use linkedin_lookup_company com URL, handle ou identificador resolvível. Não deduza um identificador pelo nome quando o perfil não tiver informação suficiente.

A SalesTouch pode monitorar o perfil semanalmente?

A SalesTouch faz uma consulta nova em cada execução. O horário pertence ao cliente ou host de automação. Salve uma referência inicial e defina o comportamento se o histórico não estiver disponível.

A consulta é somente leitura?

Sim. linkedin_lookup_profile, linkedin_lookup_profile_posts e linkedin_lookup_company são operações de leitura. Elas não enviam convites nem mensagens.

Posso exportar o resultado para CSV?

Para um perfil, peça ao agente uma linha ou arquivo CSV. Para um resultado em massa scrape_*, use os links assinados CSV ou JSONL.

Extraia seu primeiro perfil do LinkedIn

O fluxo mais simples é conectar a SalesTouch uma vez, fornecer a URL completa, pedir o formato adequado e incluir a verificação da fonte no prompt.

Comece com o prompt de qualificação. Adicione empresa, publicações, exportação ou recorrência apenas quando a próxima decisão exigir.