# Habilidade de Agente de Pesquisa de Pessoas

> Habilidade de Agente de Pesquisa de Pessoas para Geração e Enriquecimento de Leads B2B. Encontre, qualifique e enriqueça dados de profissionais, figuras públicas, candidatos e empresas para vendas, recrutamento e pesquisa.

- Canonical: https://nanoskill.ai/pt/skills/people-search
- Markdown: https://nanoskill.ai/pt/skills/people-search.md
- Author: LessieAI
- Published: 2026-05-31T01:39:27.046Z
- Updated: 2026-07-25T04:21:32.916Z
- Language: pt
- Source type: github
- Popularity signal: 22

## Sources

- https://github.com/LessieAI/lessie-skill

## Install

```shell
npx skills add https://github.com/LessieAI/lessie-skill/tree/main/people-search
```

## About

A habilidade Lessie de Pesquisa e Enriquecimento de Pessoas capacita os usuários a encontrar, qualificar e enriquecer informações sobre indivíduos e organizações de forma eficiente. Seja para gerar listas segmentadas de leads B2B, identificar candidatos ideais para recrutamento ou realizar pesquisas aprofundadas de antecedentes, essa habilidade simplifica o processo aproveitando bancos de dados abrangentes e inteligência da web.

Essa poderosa habilidade oferece dois modos de pesquisa: um modo B2B para profissionais com base em cargos, empresas e nível de senioridade, e um modo KOL (Key Opinion Leader) para identificar influenciadores e figuras públicas nas principais plataformas de mídia social. Também fornece recursos robustos de pesquisa de empresas, permitindo aprofundar-se em especificidades do setor, rodadas de financiamento, pilhas de tecnologia e atividades de contratação.

Projetada com transparência, a Lessie opera em um sistema baseado em créditos, garantindo que você sempre esteja ciente dos custos antes de qualquer ação ser tomada. Inclui opções flexíveis para desbloquear informações de contato, sendo que o redesbloqueio de indivíduos encontrados anteriormente costuma ser gratuito. A habilidade também integra ferramentas de pesquisa geral na web e busca para necessidades mais amplas de pesquisa, tornando-se um ativo versátil para inteligência de negócios e prospecção.

## Key features

- **Modos de Pesquisa Dupla (B2B e KOL)**: Utilize o modo B2B para pesquisar bancos de dados profissionais por cargos, empresas e senioridade, ou o modo KOL para encontrar influenciadores e figuras públicas em plataformas de mídia social com base na audiência e contagem de seguidores.
- **Enriquecimento Abrangente de Pessoas**: Enriqueça contatos conhecidos com perfis detalhados, incluindo e-mail, telefone, histórico profissional, links sociais e contagem de seguidores, melhorando a profundidade dos seus dados de contato.
- **Pesquisa e Insights de Empresas**: Pesquise empresas por setor, financiamento, stack tecnológico e atividade de contratação, fornecendo uma visão holística das organizações-alvo.
- **Uso Baseado em Créditos com Confirmação**: Gerencie seu orçamento de forma eficaz com um sistema transparente de créditos. A funcionalidade confirma os custos antes de executar qualquer ação que consuma créditos, evitando cobranças inesperadas.
- **Opções Flexíveis de Desbloqueio de Contatos**: Desbloqueie endereços de e-mail de pessoas de pesquisas anteriores sem custo adicional para re-desbloqueios, ou desbloqueie contatos por identificadores explícitos de plataforma para leads externos.

## Use cases

- **Gerar Listas de Leads B2B**: Crie rapidamente listas de leads segmentados pesquisando profissionais com base em cargo, empresa, localização e senioridade, ideal para equipes de vendas e marketing.
- **Fonte de Candidatos para Recrutamento**: Encontre e qualifique candidatos em potencial para recrutamento com eficiência, pesquisando bancos de dados profissionais e enriquecendo seus perfis com informações de contato essenciais.
- **Realizar Pesquisa de Antecedentes na Web**: Realize uma pesquisa de antecedentes completa sobre indivíduos ou organizações usando ferramentas integradas de busca na web e coleta para reunir inteligência abrangente.
- **Identificar Líderes de Opinião (KOLs)**: Descubra influenciadores e figuras públicas por audiência, contagem de seguidores ou tópico de conteúdo em várias plataformas de mídia social para campanhas de marketing.

## Skill definition

# Lessie — Pesquisa e Enriquecimento de Pessoas

## Configuração

Lessie suporta dois modos: **CLI** (padrão, recomendado) e **Servidor MCP**.

### Modo A: CLI (padrão)

Instale o binário da CLI Lessie:

```bash
npm install -g @lessie/cli
```

Ou use sem instalar:

```bash
npx @lessie/cli --version
```

Autorização inicial:

```bash
lessie auth
```

Isso abre um navegador para login/registro. O token é armazenado em cache em `~/.lessie/oauth.json`.

Verifique a conexão:

```bash
lessie status
```

### Modo B: Servidor MCP

Adicione à sua configuração MCP (Claude Code `~/.claude.json`, Cursor `~/.cursor/mcp.json`, Codex `~/.codex/config.toml`, etc.):

```json
{
  "mcpServers": {
    "lessie": {
      "command": "npx",
      "args": ["-y", "@lessie/mcp-server"],
      "env": {
        "LESSIE_REMOTE_MCP_URL": "https://app.lessie.ai/mcp-server/mcp"
      }
    }
  }
}
```

### Desinstalar

- **CLI:** `npm uninstall -g @lessie/cli && rm -rf ~/.lessie/`
- **MCP:** Remova a entrada `"lessie"` do seu `.json` e `rm -rf ~/.lessie/`

## Verificação de versão

Execute essas verificações uma vez no início de cada sessão, antes da detecção de modo. Ambas são não bloqueantes — se algum comando falhar (erro de rede, timeout), ignore silenciosamente e prossiga.

### Versão da skill

1. Leia a versão local atual do campo de metadados `version` deste arquivo acima.
2. Busque a versão remota:
   ```bash
   curl -sf --max-time 5 https://raw.githubusercontent.com/LessieAI/lessie-skill/main/people-search/SKILL.md | head -5 | grep 'version:' | head -1 | awk '{print $2}'
   ```
3. Se a versão remota for mais recente que a local → informe o usuário:
   > ⬆️ Uma versão mais recente da skill people-search está disponível ({local} → {remote}). Execute este comando para atualizar:
   > ```
   > npx skills add LessieAI/lessie-skill -y -g
   > ```
4. Se as versões coincidirem ou a verificação falhar → pule, não diga nada.

### Versão da CLI

1. Obtenha a versão local da CLI:
   ```bash
   lessie --version 2>/dev/null || npx @lessie/cli --version 2>/dev/null
   ```
2. Obtenha a versão mais recente publicada:
   ```bash
   npm view @lessie/cli version 2>/dev/null
   ```
3. Se a versão remota for mais recente → informe o usuário:
   > ⬆️ Uma versão mais recente da Lessie CLI está disponível ({local} → {remote}). Execute este comando para atualizar:
   > ```
   > npm install -g @lessie/cli
   > ```
4. Se as versões coincidirem ou algum comando falhar → pule, não diga nada.

## Início rápido

Após a configuração, tente dizer ao Claude:

- "Encontre Gerentes de Engenharia na Stripe em São Francisco"
- "Pesquise as informações de contato de Sam Altman"
- "Pesquise sobre a OpenAI — notícias recentes e vagas de emprego abertas"

## Detecção de modo

Determine qual modo usar no início de cada sessão:

1. Verifique se a CLI `lessie` está disponível: execute `lessie status`
2. Se o comando for bem-sucedido → use o **Modo CLI** (chame ferramentas via Bash)
3. Se o comando falhar (não encontrado) → tente a instalação automática: `npm install -g @lessie/cli`
4. Após a instalação, execute `lessie status` novamente para verificar
5. Se a instalação for bem-sucedida → use o **Modo CLI**
6. Se a instalação falhar (sem npm, permissão negada, erro de rede, etc.) → verifique se as ferramentas MCP estão disponíveis (`authorize`, `use_lessie`)
7. Se as ferramentas MCP estiverem disponíveis → use o **Modo MCP**
8. Se nenhum → informe o usuário que a instalação falhou e sugira a instalação manual ou a configuração do MCP

## Créditos e Preços

Lessie é um serviço baseado em créditos.

Novas contas recebem créditos de avaliação gratuitos. Veja seu saldo e compre mais em https://lessie.ai/pricing.

O agente desambiguará nomes de empresas antes de pesquisar para evitar desperdício de créditos em resultados errados.

## Dados e Privacidade

- **Fontes de dados:** As informações de contato e empresa são agregadas de fontes publicamente disponíveis (diretórios de negócios, perfis sociais, sites corporativos).
- **Registro de consultas:** As consultas de pesquisa são registradas para melhoria do serviço e prevenção de abusos. Nenhum dado de consulta é compartilhado com terceiros.
- **Conformidade de dados:** Lessie segue os regulamentos de proteção de dados aplicáveis. Os usuários são responsáveis por usar os dados de contato recuperados em conformidade com as leis locais (GDPR, CAN-SPAM, etc.).
- **Política de privacidade:** https://lessie.ai/privacy
- **Termos de serviço:** https://lessie.ai/terms-of-service

## Autorização

### Modo CLI

1. Execute `lessie status` para verificar a validade do token.
2. Se `authorized: false` → execute `lessie auth` para abrir o navegador para login.
3. Após o usuário concluir o login, execute `lessie status` novamente para confirmar.

### Modo MCP

1. Chame `authorize` para verificar o status da conexão.
2. **Se já autorizado** → prossiga para usar as ferramentas diretamente.
3. **Se não autorizado** → `authorize` retorna uma URL de autorização. Diga ao usuário que você precisa abrir um navegador para login/registro no Lessie e abra-o usando o comando de sistema apropriado:
   - macOS: `open "<url>"`
   - Linux: `xdg-open "<url>"`
   - Windows: `start "<url>"`
4. Informe ao usuário que o navegador foi aberto e que ele precisa concluir o login/registro.
5. Após o usuário confirmar, chame `authorize` novamente para verificar a conexão.
6. Se a autorização falhar (timeout, negada, conflito de porta), siga as dicas de diagnóstico retornadas por `authorize` e tente novamente.

Sempre informe o usuário antes de abrir o navegador — nunca redirecione silenciosamente.

## Regras de comportamento do agente

### CRÍTICO: Confirme antes de cada ação que consome créditos

Cada chamada de ferramenta Lessie custa créditos. Custos em créditos por ferramenta:

| Ferramenta | Custo |
|------|------|
| `find-people` | **20 créditos** por pesquisa |
| `enrich-people` | 1 crédito × número de pessoas (cobrado apenas por correspondências bem-sucedidas) |
| `review-people` | 1 crédito × número de pessoas |
| `enrich-org` | 1 crédito |
| `find-orgs` | 1 crédito |
| `job-postings` | 1 crédito |
| `company-news` | 1 crédito |
| `web-search` | 1 crédito |
| `web-fetch` | 1 crédito |
| `unlock_emails` | **3 créditos** por pessoa recém-desbloqueada (taxa atual; verifique `price_per_unlock` na resposta para o valor ao vivo). Pessoas já desbloqueadas (em qualquer uma de suas pesquisas anteriores) são gratuitas. Pesquisas com falha não são cobradas |
| `unlock_email_by_handle` | **3 créditos** por desbloqueio bem-sucedido (taxa atual; verifique `price_per_unlock` na resposta para o valor ao vivo). `not_found` e `failed` são gratuitos. **Não idempotente** — reexecutar no mesmo identificador cobra novamente |

**Antes de executar qualquer comando**, você DEVE:

1. Informar ao usuário o que você está prestes a fazer e o custo estimado (por exemplo, "Vou enriquecer 3 pessoas — isso custa ~3 créditos").
2. **Aguardar confirmação explícita** antes de executar.
3. Nunca agrupar várias chamadas que consomem créditos sem confirmar o plano completo primeiro.

**Exceção — pular confirmação** se o usuário tiver explicitamente dito que não quer ser solicitado (por exemplo, "não me pergunte toda vez", "apenas faça", "pular confirmações"). Nesse caso, prossiga diretamente, mas ainda registre o que você executou e os créditos gastos após cada chamada.

### CRÍTICO: Relate o uso de créditos após cada chamada

Após cada turno de conversa que envolveu uma ou mais chamadas de ferramenta Lessie, anexe um resumo de uma linha dos créditos consumidos. Formato:

> Usado(s) `<tool-name>`, custo <N> crédito(s).

Se várias ferramentas foram chamadas no mesmo turno, combine-as:

> Usado(s) `web-search` + `enrich-org`, custo 2 créditos no total.

### CRÍTICO: Leia as referências antes da primeira chamada CLI

**Antes de executar qualquer comando `lessie` CLI pela primeira vez em uma sessão**, você DEVE ler [references/cli-reference.md](references/cli-reference.md) para aprender a sintaxe exata dos parâmetros. Cada ferramenta tem seu próprio conjunto de flags — `find-people` aceita `--query` (NL), `enrich-people` aceita `--people` (JSON), `unlock-emails` aceita `--search-id` + `--person-ids`, etc. Não adivinhe — leia a seção da ferramenta que você está prestes a chamar.

### Desambiguação do modo de pesquisa (B2B vs KOL)

Lessie suporta dois modos de pesquisa com diferentes fontes de dados e tipos de resultado:

- **Modo B2B**: Pesquisa bancos de dados profissionais (baseados no LinkedIn). Melhor para encontrar pessoas por cargo, empresa, senioridade ou setor. Retorna e-mail de trabalho, telefone, histórico de emprego.
- **Modo KOL**: Pesquisa plataformas de mídia social (Instagram, YouTube, TikTok, Twitter/X). Melhor para encontrar influenciadores, criadores de conteúdo ou figuras públicas por audiência, contagem de seguidores ou tópico de conteúdo. Retorna links sociais, contagens de seguidores.

**Quando a intenção do usuário for ambígua** — ou seja, a consulta poderia razoavelmente visar profissionais no LinkedIn ou criadores nas mídias sociais — você DEVE pedir ao usuário que esclareça antes de pesquisar. Apresente ambas as opções de forma concisa:

Exemplo de consulta ambígua: *"Encontre indivíduos que têm experiência prática com dispositivos de monitoramento cerebral do sono para compartilhar suas percepções."*

Isso poderia significar:
1. **B2B**: Gerentes de produto, engenheiros ou pesquisadores em empresas de tecnologia do sono (via LinkedIn)
2. **KOL**: Influenciadores de saúde/tecnologia que revisaram ou usaram tais dispositivos (via mídias sociais)

Pergunte: "Isso poderia ser profissionais do LinkedIn (PMs, engenheiros em empresas de tecnologia do sono) ou criadores de mídia social que revisam dispositivos de sono. Qual direção você prefere — ou ambos?"

**Quando a intenção for clara**, prossiga diretamente:
- "Encontre CTOs em startups de fintech" → B2B (óbvio)
- "Encontre influenciadores de beleza no Instagram com mais de 100 mil seguidores" → KOL (óbvio)

### Desambiguação de entidade

Quando um usuário menciona um nome de empresa que poderia se referir a várias entidades (por exemplo, "Manus" poderia ser Manus AI, Manus Bio, Manus Plus, etc.), desambigue antes de pesquisar:

1. **Pergunte ao usuário** a qual empresa ele se refere, ou apresente os principais candidatos e deixe-o escolher.
2. Se o contexto tornar isso inequívoco (por exemplo, o usuário discutiu anteriormente agentes de IA), declare sua suposição e confirme: "Você quis dizer Manus AI (manus.im), a empresa de agentes de IA?"
3. **Nunca assuma silenciosamente** uma entidade em detrimento de outra — domínio errado = créditos de pesquisa desperdiçados e resultados irrelevantes.

## Visão geral das ferramentas

### Pessoas

| Ferramenta | Comando CLI | Quando usar |
|------|-------------|-------------|
| `find_people` | `lessie find-people` | Descubra pessoas por meio de uma **tarefa em linguagem natural**. Passe a solicitação do usuário literalmente através de `--query`. O agente escolhe fontes (B2B / KOL / web), palavras-chave e para automaticamente. **Limite rígido: 3 chamadas de ferramenta + 60s de orçamento por solicitação.** Se a resposta tiver `partial: true`, o agente atingiu o orçamento — os resultados são o que foi coletado antes do timeout |
| `enrich_people` | `lessie enrich-people` | Enriqueça pessoas conhecidas com perfis completos. **Dois caminhos**: B2B (via linkedin_url ou nome+domínio → e-mail, telefone, histórico de trabalho) e KOL (via nome de usuário do twitter/instagram/tiktok/youtube → contagem de seguidores, links sociais). Máximo 10 por chamada |
| `review_people` | `lessie review-people` | Qualifique profundamente candidatos **ambíguos** por meio de pesquisa na web — pule para correspondências/claras incompatibilidades |

### Desbloqueio de contato

| Ferramenta | Comando CLI | Quando usar |
|------|-------------|-------------|
| `unlock_emails` | `lessie unlock-emails` | Desbloqueie endereços de e-mail para pessoas de um resultado anterior de `find_people`. **Idempotente por usuário**: pessoas que você já desbloqueou (em qualquer pesquisa) custam 0. Aceita `search_id` + `person_ids` (1–50) |
| `unlock_email_by_handle` | `lessie unlock-email-by-handle` | Desbloqueie e-mail por um `(platform, handle)` explícito, **sem uma pesquisa anterior**. Aceita uma lista de `{platform, handle}` (1–10). **NÃO idempotente** — chamadas repetidas no mesmo identificador cobram novamente. Use apenas quando o identificador não estiver em nenhum `find_people` que você executou |

**Regra de decisão:** se a pessoa veio do seu próprio resultado de `find_people` → use `unlock_emails` (redesbloqueios são gratuitos). Se você obteve o identificador de fora do lessie (uma URL do LinkedIn que o usuário colou, uma menção manual, etc.) → use `unlock_email_by_handle`.

### Empresas

| Ferramenta | Comando CLI | Quando usar |
|------|-------------|-------------|
| `find_organizations` | `lessie find-orgs` | Descubra empresas por nome, palavra-chave, localização, tamanho, financiamento |
| `enrich_organization` | `lessie enrich-org` | Obtenha perfil completo para domínio(s) de empresa conhecido(s) — setor, funcionários, financiamento, pilha tecnológica |
| `get_company_job_postings` | `lessie job-postings` | Veja vagas de emprego ativas (precisa de `organization_id` do enriquecimento) |
| `search_company_news` | `lessie company-news` | Encontre artigos de notícias recentes (precisa de `organization_id` do enriquecimento) |

### Pesquisa na web

| Ferramenta | Comando CLI | Quando usar |
|------|-------------|-------------|
| `web_search` | `lessie web-search` | Pesquisa geral na web; resultados em cache tornam o `web_fetch` de acompanhamento gratuito |
| `web_fetch` | `lessie web-fetch` | Extraia informações específicas de uma URL por meio de sumarização de IA |

## Referências detalhadas

- **Exemplos de comandos CLI e chamada MCP**: Veja [references/cli-reference.md](references/cli-reference.md)
- **Padrões de fluxo de trabalho** (resolução de domínio, pesquisa de empresa, pesquisa+qualificação): Veja [references/workflow-patterns.md](references/workflow-patterns.md)
- **Árvore de decisão de resolução de domínio**: Veja [references/domain-resolution.md](references/domain-resolution.md)

## Restrições principais

- `enrich_people` / `enrich_organization`: máximo 10 por chamada; divida listas maiores em lotes
- `find_people`: limite rígido de **3 chamadas de ferramenta + 60s de orçamento de tempo real** por solicitação. `target_count` 1-100 (padrão 30). NÃO paginado — se você precisar de mais, execute uma nova chamada com uma consulta diferente
- `find_organizations`: paginado — use `--page` para mais resultados
- `web_search` armazena em cache o conteúdo da página; se um resultado tiver `has_content: true`, chamar `web_fetch` nessa URL é instantâneo
- Palavras-chave úteis para incluir em uma consulta `find-people`: termos de senioridade (`owner`, `founder`, `c_suite`, `partner`, `vp`, `head`, `director`, `manager`, `senior`, `entry`, `intern`) e `current` vs `past` para influenciar a recência do emprego. O agente usa esses diretamente como filtros
- Para enriquecimento de pessoas, fornecer `domain` (domínio da empresa) junto ao nome melhora muito a precisão da correspondência
- A saída da CLI é JSON no stdout, mensagens de status no stderr — analise o stdout para obter dados

## FAQ

### O que é a funcionalidade Lessie People Search & Enrichment?

A funcionalidade de Busca e Enriquecimento de Pessoas do Lessie é uma ferramenta projetada para ajudar os usuários a encontrar, qualificar e enriquecer informações sobre pessoas e empresas. Ela oferece suporte a vários casos de uso, como geração de leads B2B, sourcing de candidatos e pesquisa de antecedentes.

### Como faço para instalar a CLI do Lessie?

Você pode instalar a CLI do Lessie globalmente usando o npm com o comando: \`npm install -g @lessie/cli\`. Como alternativa, você pode usar \`npx @lessie/cli --version\` para usá-la sem uma instalação global.

### Esta funcionalidade suporta buscas tanto B2B quanto KOL?

Sim, a funcionalidade oferece suporte ao modo B2B para bancos de dados profissionais (baseados no LinkedIn) e ao modo KOL para plataformas de mídia social (Instagram, YouTube, TikTok, Twitter/X) para encontrar influenciadores e figuras públicas.

### Como o Lessie lida com o uso de créditos e precificação?

O Lessie é um serviço baseado em créditos. Novas contas recebem créditos de avaliação gratuita, e você pode comprar mais em lessie.ai/pricing. O agente sempre confirmará o custo estimado antes de executar qualquer ação que consuma créditos.

### Posso desbloquear endereços de e-mail de pessoas que já pesquisei?

Sim, se a pessoa veio de um resultado anterior de \`find\_people\`, usar \`unlock\_emails\` não cobrará novamente por indivíduos já desbloqueados. Se o identificador do contato for de fora do Lessie, use \`unlock\_email\_by\_handle\`.

### Que tipo de informação de empresa posso pesquisar?

Você pode enriquecer domínios de empresas conhecidas para obter perfis completos, incluindo setor, número de funcionários, detalhes de financiamento, stack tecnológico, vagas de emprego ativas e artigos de notícias recentes.