Dados de Pessoas

Visão Geral

Realize pesquisas autorizadas de perfis profissionais e contatos comerciais públicos através do servidor Agent Body MCP em /mcp/people-data. Abrange recuperação de perfil do LinkedIn, busca de e-mail e telefone, pesquisa filtrada de pessoas e descoberta de e-mail comercial de canais do YouTube.

Leia references/tool-reference.md para nomes exatos de ferramentas e campos de entrada.

Quando Usar Esta Habilidade

• Use quando o usuário pedir para procurar, enriquecer ou verificar um perfil profissional do LinkedIn.
• Use quando o usuário precisar de um e-mail comercial ou número de telefone para um perfil do LinkedIn com o qual ele está autorizado a entrar em contato.
• Use quando o usuário quiser encontrar pessoas por cargo, empresa, localização, senioridade ou outros filtros do LinkedIn.
• Use quando o usuário quiser encontrar e-mails de contato comercial públicos para canais do YouTube.
• Use quando o usuário pedir para validar ou deduplicar resultados de pesquisa de pessoas antes do contato.

Como Funciona

Passo 1: Escolha uma operação

• linkedin_person_profile com linkedin_url recupera um perfil profissional.
• linkedin_email_lookup com profileUrl procura um endereço de e-mail de perfil.
• linkedin_phone_lookup com profileUrl procura um número de telefone de perfil.
• linkedin_people_search aceita filtros opcionais e retorna um nextPageToken para continuação.
• youtube_email_finder recebe channels (1-1000 URLs de canais) e scrape_fresh_emails opcionais para encontrar e-mails comerciais públicos.

Passo 2: Prefira URLs canônicas e filtros explícitos

Use URLs canônicas de perfil ou canal quando disponíveis. Para pesquisas apenas por nome, adicione filtros explícitos de cargo, empresa, localização ou palavra-chave. companyFilter deve ser current, past ou all.

Passo 3: Verifique e apresente apenas os dados retornados

Confirme que as identidades retornadas correspondem à solicitação, deduplique os resultados da pesquisa pela identidade canônica do perfil e nunca construa ou adivinhe um endereço de e-mail ou número de telefone. Preserve o estado encontrado/não encontrado por canal dos resultados do YouTube.

Exemplos

Exemplo 1: Procurar um perfil do LinkedIn

Chame linkedin_person_profile com:

{
  "linkedin_url": "https://www.linkedin.com/in/example-person"
}

Exemplo 2: Encontrar e-mails comerciais públicos para canais do YouTube

Chame youtube_email_finder com:

{
  "channels": ["https://www.youtube.com/@example"],
  "scrape_fresh_emails": false
}

Melhores Práticas

• ✅ Use URLs canônicas de perfil ou canal em vez de adivinhar identificadores.
• ✅ Confirme se a identidade retornada corresponde à pessoa ou canal antes de apresentá-la.
• ✅ Use apenas dados comerciais públicos, autorizados ou explicitamente permitidos.
• ✅ Mantenha nextPageToken inalterado ao continuar uma linkedin_people_search.
• ❌ Não fabrique, adivinhe ou infira endereços de e-mail ou números de telefone.
• ❌ Não contorne controles de acesso ou colete perfis privados sem autorização.

Limitações

• Requer uma chave de API do Agent Body e acesso ao servidor MCP /mcp/people-data; os resultados dependem do esquema da ferramenta ativa.
• A busca de e-mail e telefone pode não retornar resultados para perfis sem dados de contato públicos; um resultado ausente não é evidência de que uma pessoa não possui informações de contato.
• Os filtros de pesquisa são opcionais, mas pesquisas apenas por nome sem filtros podem retornar correspondências ambíguas que precisam de verificação manual.
• youtube_email_finder encontra apenas e-mails comerciais públicos e pode relatar canais onde nenhum e-mail foi encontrado.

Notas de Segurança e Proteção

• Nunca imprima, registre ou confirme chaves de API ou outras credenciais.
• Use informações de contato apenas para fins comerciais autorizados e respeite as regras de privacidade, anti-assédio e contato.
• Não use esta habilidade para construir listas de contatos sem uma base legal ou para contatar pessoas que optaram por não receber.
• Esta habilidade é somente leitura: ela consulta dados comerciais e não modifica arquivos ou sistemas.

Armadilhas Comuns

• Problema: Usar a chave de entrada errada para pesquisas de perfil versus e-mail/telefone. Solução: A pesquisa de perfil usa linkedin_url; a pesquisa de e-mail e telefone usa profileUrl.
• Problema: Adivinhar um e-mail quando a pesquisa não retorna nada. Solução: Relate o resultado ausente e pare; nunca invente dados de contato.
• Problema: Repetir a mesma página de pesquisa de pessoas. Solução: Passe o nextPageToken retornado inalterado para continuar em vez de reproduzir a consulta inicial.