Habilidade de Agente de Pesquisa de Pessoas

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:

npm install -g @lessie/cli

Ou use sem instalar:

npx @lessie/cli --version

Autorização inicial:

lessie auth

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

Verifique a conexão:

lessie status

Modo B: Servidor MCP

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

{
  "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:

   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:

   lessie --version 2>/dev/null || npx @lessie/cli --version 2>/dev/null
   

2. Obtenha a versão mais recente publicada:

   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:

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 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

Desbloqueio de contato

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

Pesquisa na web

Referências detalhadas

• Exemplos de comandos CLI e chamada MCP: Veja 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
• Árvore de decisão de resolução de domínio: Veja 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