Habilidad del Agente de Búsqueda de Personas

Lessie — Búsqueda y Enriquecimiento de Personas

Configuración

Lessie admite dos modos: CLI (predeterminado, recomendado) y Servidor MCP.

Modo A: CLI (predeterminado)

Instala el binario de Lessie CLI:

npm install -g @lessie/cli

O úsalo sin instalar:

npx @lessie/cli --version

Autorización por primera vez:

lessie auth

Esto abre un navegador para iniciar sesión/registrarse. El token se almacena en caché en ~/.lessie/oauth.json.

Verifica la conexión:

lessie status

Modo B: Servidor MCP

Añade a tu configuración 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"
      }
    }
  }
}

Desinstalación

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Elimina la entrada "lessie" de tu .json y ejecuta rm -rf ~/.lessie/

Verificación de versión

Ejecuta estas comprobaciones una vez al inicio de cada sesión, antes de la detección de modo. Ambas comprobaciones son no bloqueantes — si algún comando falla (error de red, tiempo de espera), omítelo silenciosamente y continúa.

Versión de la skill

1. Lee la versión local actual del campo de metadatos version de este archivo arriba.
2. Obtén la versión 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. Si la versión remota es más reciente que la versión local → dile al usuario:

   ⬆️ Hay una versión más reciente de la skill people-search disponible ({local} → {remote}). Ejecuta este comando para actualizar:

   npx skills add LessieAI/lessie-skill -y -g
   

4. Si las versiones coinciden o la comprobación falla → omite, no digas nada.

Versión de CLI

1. Obtén la versión local de CLI:

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

2. Obtén la última versión publicada:

   npm view @lessie/cli version 2>/dev/null
   

3. Si la versión remota es más reciente → dile al usuario:

   ⬆️ Hay una versión más reciente de Lessie CLI disponible ({local} → {remote}). Ejecuta este comando para actualizar:

   npm install -g @lessie/cli
   

4. Si las versiones coinciden o algún comando falla → omite, no digas nada.

Inicio rápido

Después de la configuración, intenta decirle a Claude:

• "Encuentra Gerentes de Ingeniería en Stripe en San Francisco"
• "Busca la información de contacto de Sam Altman"
• "Investiga OpenAI — noticias recientes y ofertas de trabajo abiertas"

Detección de modo

Determina qué modo usar al inicio de cada sesión:

1. Comprueba si el CLI lessie está disponible: ejecuta lessie status
2. Si el comando tiene éxito → usa modo CLI (llama a las herramientas mediante Bash)
3. Si el comando falla (no encontrado) → intenta la instalación automática: npm install -g @lessie/cli
4. Después de la instalación, ejecuta lessie status de nuevo para verificar
5. Si la instalación tiene éxito → usa modo CLI
6. Si la instalación falla (sin npm, permiso denegado, error de red, etc.) → comprueba si las herramientas MCP están disponibles (authorize, use_lessie)
7. Si las herramientas MCP están disponibles → usa modo MCP
8. Si ninguna → informa al usuario que la instalación falló y sugiere instalación manual o configuración MCP

Créditos y Precios

Lessie es un servicio basado en créditos.

Las cuentas nuevas reciben créditos de prueba gratuitos. Consulta tu saldo y compra más en https://lessie.ai/pricing.

El agente desambiguará los nombres de las empresas antes de buscar para evitar gastar créditos en resultados incorrectos.

Datos y Privacidad

• Fuentes de datos: La información de contacto y de la empresa se agrega a partir de fuentes disponibles públicamente (directorios de empresas, perfiles sociales, sitios web corporativos).
• Registro de consultas: Las consultas de búsqueda se registran para mejorar el servicio y prevenir abusos. Ningún dato de consulta se comparte con terceros.
• Cumplimiento de datos: Lessie cumple con las regulaciones de protección de datos aplicables. Los usuarios son responsables de usar los datos de contacto recuperados en cumplimiento con las leyes locales (GDPR, CAN-SPAM, etc.).
• Política de privacidad: https://lessie.ai/privacy
• Términos de servicio: https://lessie.ai/terms-of-service

Autorización

Modo CLI

1. Ejecuta lessie status para comprobar la validez del token.
2. Si authorized: false → ejecuta lessie auth para abrir el navegador e iniciar sesión.
3. Después de que el usuario complete el inicio de sesión, ejecuta lessie status nuevamente para confirmar.

Modo MCP

1. Llama a authorize para comprobar el estado de la conexión.
2. Si ya está autorizado → procede a usar las herramientas directamente.
3. Si no está autorizado → authorize devuelve una URL de autorización. Dile al usuario que necesitas abrir un navegador para iniciar sesión/registrarse en Lessie, y ábrelo usando el comando del sistema apropiado:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Dile al usuario que el navegador se ha abierto y que necesita completar el inicio de sesión/registro.
5. Después de que el usuario confirme, llama a authorize nuevamente para verificar la conexión.
6. Si la autorización falla (tiempo de espera, denegada, conflicto de puerto), sigue las pistas de diagnóstico devueltas por authorize y reintenta.

Siempre informa al usuario antes de abrir el navegador — nunca redirijas silenciosamente.

Reglas de comportamiento del agente

CRÍTICO: Confirma antes de cada acción que consuma créditos

Cada llamada a una herramienta de Lessie cuesta créditos. Costos de crédito por herramienta:

Antes de ejecutar cualquier comando, DEBES:

1. Dile al usuario lo que estás a punto de hacer y el costo estimado (ej., "Voy a enriquecer 3 personas — esto cuesta ~3 créditos").
2. Espera confirmación explícita antes de ejecutar.
3. Nunca agrupes múltiples llamadas que consuman créditos sin confirmar el plan completo primero.

Excepción — omite la confirmación si el usuario ha dicho explícitamente que no quiere que se le pregunte (ej., "no me preguntes cada vez", "simplemente hazlo", "omite las confirmaciones"). En ese caso, procede directamente pero aún así registra lo que ejecutaste y los créditos gastados después de cada llamada.

CRÍTICO: Informa el uso de créditos después de cada llamada

Después de cada turno de conversación que involucre una o más llamadas a herramientas de Lessie, añade un resumen de una línea de los créditos consumidos. Formato:

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

Si se llamaron múltiples herramientas en el mismo turno, combínalas:

Usado web-search + enrich-org, costo 2 créditos en total.

CRÍTICO: Lee las referencias antes de la primera llamada CLI

Antes de ejecutar cualquier comando CLI de lessie por primera vez en una sesión, DEBES leer references/cli-reference.md para aprender la sintaxis exacta de los parámetros. Cada herramienta tiene su propio conjunto de banderas — find-people acepta --query (NL), enrich-people acepta --people (JSON), unlock-emails acepta --search-id + --person-ids, etc. No adivines — lee la sección de la herramienta que estás a punto de llamar.

Desambiguación del modo de búsqueda (B2B vs KOL)

Lessie admite dos modos de búsqueda con diferentes fuentes de datos y tipos de resultados:

• Modo B2B: Busca en bases de datos profesionales (basadas en LinkedIn). Ideal para encontrar personas por cargo, empresa, antigüedad o industria. Devuelve correo electrónico laboral, teléfono, historial de empleo.
• Modo KOL: Busca en plataformas de redes sociales (Instagram, YouTube, TikTok, Twitter/X). Ideal para encontrar influencers, creadores de contenido o figuras públicas por audiencia, número de seguidores o tema del contenido. Devuelve enlaces a redes sociales, número de seguidores.

Cuando la intención del usuario sea ambigua — es decir, la consulta podría apuntar razonablemente tanto a profesionales en LinkedIn como a creadores en redes sociales — DEBES pedir al usuario que aclare antes de buscar. Presenta ambas opciones de manera concisa:

Ejemplo de consulta ambigua: "Encuentra individuos que tengan experiencia práctica con dispositivos de sueño que monitorean el cerebro para compartir sus ideas."

Esto podría significar:

1. B2B: Gerentes de producto, ingenieros o investigadores en empresas de tecnología del sueño (a través de LinkedIn)
2. KOL: Influencers de salud/tecnología que han revisado o usado dichos dispositivos (a través de redes sociales)

Pregunta: "Esto podría ser profesionales de LinkedIn (PMs, ingenieros en empresas de tecnología del sueño) o creadores de redes sociales que revisan dispositivos de sueño. ¿Qué dirección prefieres, o ambas?"

Cuando la intención es clara, procede directamente:

• "Encuentra CTOs en startups fintech" → B2B (obvio)
• "Encuentra influencers de belleza en Instagram con más de 100k seguidores" → KOL (obvio)

Desambiguación de entidades

Cuando un usuario menciona el nombre de una empresa que podría referirse a múltiples entidades (ej., "Manus" podría ser Manus AI, Manus Bio, Manus Plus, etc.), desambigua antes de buscar:

1. Pregunta al usuario a qué empresa se refiere, o presenta los principales candidatos y déjalo elegir.
2. Si el contexto lo hace inequívoco (ej., el usuario discutió previamente agentes de IA), manifiesta tu suposición y confirma: "¿Te refieres a Manus AI (manus.im), la empresa de agentes de IA?"
3. Nunca asumas silenciosamente una entidad sobre otra — dominio incorrecto = créditos de búsqueda desperdiciados y resultados irrelevantes.

Descripción general de herramientas

Personas

Desbloqueo de contacto

Regla de decisión: si la persona proviene de tu propio resultado de find_people → usa unlock_emails (los redesbloqueos son gratis). Si obtuviste el handle desde fuera de Lessie (una URL de LinkedIn que el usuario pegó, una mención manual, etc.) → usa unlock_email_by_handle.

Empresas

Investigación web

Referencias detalladas

• Ejemplos de comandos CLI y llamadas MCP: Consulta references/cli-reference.md
• Patrones de flujo de trabajo (resolución de dominio, investigación de empresas, búsqueda+calificación): Consulta references/workflow-patterns.md
• Árbol de decisión de resolución de dominio: Consulta references/domain-resolution.md

Restricciones clave

• enrich_people / enrich_organization: máximo 10 por llamada; divide listas más grandes en lotes
• find_people: límite estricto de 3 llamadas a la herramienta + 60s de presupuesto de reloj de pared por solicitud. target_count 1-100 (predeterminado 30). NO paginado — si necesitas más, ejecuta una nueva llamada con una consulta diferente
• find_organizations: paginado — usa --page para más resultados
• web_search almacena en caché el contenido de la página; si un resultado tiene has_content: true, llamar a web_fetch en esa URL es instantáneo
• Palabras clave útiles para incluir en una consulta find-people: términos de antigüedad (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) y current vs past para sesgar la antigüedad laboral. El agente las usa directamente como filtros
• Para el enriquecimiento de personas, proporcionar domain (dominio de la empresa) junto con el nombre mejora enormemente la precisión de la coincidencia
• La salida de CLI es JSON en stdout, los mensajes de estado en stderr — analiza stdout para los datos