Compétence d'agent de recherche de personnes

Lessie — Recherche de personnes & Enrichissement

Configuration

Lessie prend en charge deux modes : CLI (par défaut, recommandé) et Serveur MCP.

Mode A : CLI (par défaut)

Installez le binaire CLI Lessie :

npm install -g @lessie/cli

Ou utilisez sans installer :

npx @lessie/cli --version

Autorisation initiale :

lessie auth

Cela ouvre un navigateur pour la connexion/l'inscription. Le jeton est mis en cache dans ~/.lessie/oauth.json.

Vérifiez la connexion :

lessie status

Mode B : Serveur MCP

Ajoutez à votre configuration 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"
      }
    }
  }
}

Désinstallation

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Supprimez l'entrée "lessie" de votre .json et rm -rf ~/.lessie/

Vérification de la version

Exécutez ces vérifications une fois au début de chaque session, avant la détection du mode. Les deux vérifications sont non bloquantes — si une commande échoue (erreur réseau, délai dépassé), ignorez silencieusement et continuez.

Version de la compétence

1. Lisez la version locale actuelle à partir du champ version des métadonnées de ce fichier ci-dessus.
2. Récupérez la version distante :

   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 version distante est plus récente que la version locale → informez l'utilisateur :

   ⬆️ Une version plus récente de la compétence people-search est disponible ({local} → {remote}). Exécutez cette commande pour mettre à jour :

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

4. Si les versions correspondent ou si la vérification échoue → ignorez, ne dites rien.

Version de la CLI

1. Obtenez la version locale de la CLI :

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

2. Obtenez la dernière version publiée :

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

3. Si la version distante est plus récente → informez l'utilisateur :

   ⬆️ Une version plus récente de Lessie CLI est disponible ({local} → {remote}). Exécutez cette commande pour mettre à jour :

   npm install -g @lessie/cli
   

4. Si les versions correspondent ou si l'une des commandes échoue → ignorez, ne dites rien.

Démarrage rapide

Après la configuration, essayez de dire à Claude :

• "Trouver des responsables Ingénierie chez Stripe à San Francisco"
• "Rechercher les coordonnées de Sam Altman"
• "Rechercher OpenAI — actualités récentes et offres d'emploi ouvertes"

Détection du mode

Déterminez quel mode utiliser au début de chaque session :

1. Vérifiez si la CLI lessie est disponible : exécutez lessie status
2. Si la commande réussit → utilisez le mode CLI (appelez les outils via Bash)
3. Si la commande échoue (non trouvée) → tentez une installation automatique : npm install -g @lessie/cli
4. Après l'installation, exécutez à nouveau lessie status pour vérifier
5. Si l'installation réussit → utilisez le mode CLI
6. Si l'installation échoue (pas de npm, autorisation refusée, erreur réseau, etc.) → vérifiez si les outils MCP sont disponibles (authorize, use_lessie)
7. Si les outils MCP sont disponibles → utilisez le mode MCP
8. Si aucun des deux → informez l'utilisateur que l'installation a échoué et suggérez une installation manuelle ou la configuration MCP

Crédits et tarification

Lessie est un service basé sur des crédits.

Les nouveaux comptes reçoivent des crédits d'essai gratuits. Consultez votre solde et achetez-en plus sur https://lessie.ai/pricing.

L'agent désambiguïsera les noms d'entreprise avant la recherche pour éviter de gaspiller des crédits sur de mauvais résultats.

Données et confidentialité

• Sources de données : Les informations de contact et d'entreprise sont agrégées à partir de sources accessibles au public (annuaires d'entreprises, profils sociaux, sites Web d'entreprise).
• Journalisation des requêtes : Les requêtes de recherche sont journalisées pour l'amélioration du service et la prévention des abus. Aucune donnée de requête n'est partagée avec des tiers.
• Conformité des données : Lessie suit les réglementations applicables en matière de protection des données. Les utilisateurs sont responsables de l'utilisation des données de contact récupérées conformément aux lois locales (RGPD, CAN-SPAM, etc.).
• Politique de confidentialité : https://lessie.ai/privacy
• Conditions d'utilisation : https://lessie.ai/terms-of-service

Autorisation

mode CLI

1. Exécutez lessie status pour vérifier la validité du jeton.
2. Si authorized: false → exécutez lessie auth pour ouvrir le navigateur de connexion.
3. Une fois que l'utilisateur a terminé la connexion, exécutez à nouveau lessie status pour confirmer.

mode MCP

1. Appelez authorize pour vérifier l'état de la connexion.
2. Si déjà autorisé → utilisez les outils directement.
3. Si non autorisé → authorize renvoie une URL d'autorisation. Dites à l'utilisateur que vous devez ouvrir un navigateur pour la connexion/inscription Lessie, et ouvrez-le en utilisant la commande système appropriée :
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Dites à l'utilisateur que le navigateur a été ouvert et qu'il doit terminer la connexion/inscription.
5. Après confirmation de l'utilisateur, appelez à nouveau authorize pour vérifier la connexion.
6. Si l'autorisation échoue (délai dépassé, refusée, conflit de port), suivez les conseils de diagnostic renvoyés par authorize et réessayez.

Informez toujours l'utilisateur avant d'ouvrir le navigateur — ne redirigez jamais silencieusement.

Règles de comportement de l'agent

CRITIQUE : Confirmez avant chaque action consommant des crédits

Chaque appel d'outil Lessie coûte des crédits. Coûts par outil :

Avant d'exécuter une commande, vous DEVEZ :

1. Dites à l'utilisateur ce que vous allez faire et le coût estimé (par exemple, "Je vais enrichir 3 personnes — cela coûte environ 3 crédits").
2. Attendez une confirmation explicite avant d'exécuter.
3. Ne regroupez jamais plusieurs appels consommateurs de crédits sans d'abord confirmer le plan complet.

Exception — sautez la confirmation si l'utilisateur a explicitement dit qu'il ne voulait pas être sollicité (par exemple, "ne me demande pas à chaque fois", "fais-le", "saute les confirmations"). Dans ce cas, procédez directement mais consignez tout de même ce que vous avez exécuté et les crédits dépensés après chaque appel.

CRITIQUE : Signalez l'utilisation des crédits après chaque appel

Après chaque tour de conversation ayant impliqué un ou plusieurs appels d'outils Lessie, ajoutez un résumé d'une ligne des crédits consommés. Format :

Utilisé <tool-name>, coût <N> crédit(s).

Si plusieurs outils ont été appelés dans le même tour, combinez-les :

Utilisé web-search + enrich-org, coût total 2 crédits.

CRITIQUE : Lisez les références avant le premier appel CLI

Avant d'exécuter une commande CLI lessie pour la première fois dans une session, vous DEVEZ lire references/cli-reference.md pour connaître la syntaxe exacte des paramètres. Chaque outil a son propre ensemble de drapeaux — find-people prend --query (NL), enrich-people prend --people (JSON), unlock-emails prend --search-id + --person-ids, etc. Ne devinez pas — lisez la section de l'outil que vous allez appeler.

Désambiguïsation du mode de recherche (B2B vs KOL)

Lessie prend en charge deux modes de recherche avec des sources de données et des types de résultats différents :

• Mode B2B : Recherche dans les bases de données professionnelles (basées sur LinkedIn). Idéal pour trouver des personnes par poste, entreprise, ancienneté ou secteur. Renvoie l'e-mail professionnel, le téléphone, l'historique d'emploi.
• Mode KOL : Recherche sur les plateformes de médias sociaux (Instagram, YouTube, TikTok, Twitter/X). Idéal pour trouver des influenceurs, des créateurs de contenu ou des personnalités publiques par audience, nombre d'abonnés ou sujet de contenu. Renvoie les liens sociaux, le nombre d'abonnés.

Lorsque l'intention de l'utilisateur est ambiguë — c'est-à-dire que la requête pourrait raisonnablement cibler soit des professionnels sur LinkedIn, soit des créateurs sur les médias sociaux — vous DEVEZ demander à l'utilisateur de clarifier avant de rechercher. Présentez les deux options de manière concise :

Exemple de requête ambiguë : "Trouver des personnes ayant une expérience pratique avec des appareils de surveillance du sommeil cérébral pour partager leurs idées."

Cela pourrait signifier :

1. B2B : Chefs de produit, ingénieurs ou chercheurs dans des entreprises de technologie du sommeil (via LinkedIn)
2. KOL : Influenceurs santé/technologie qui ont examiné ou utilisé de tels appareils (via les médias sociaux)

Demandez : "Cela pourrait être des professionnels LinkedIn (chefs de produit, ingénieurs dans des entreprises de technologie du sommeil) ou des créateurs de médias sociaux qui examinent les appareils de sommeil. Quelle direction préférez-vous — ou les deux ?"

Lorsque l'intention est claire, procédez directement :

• "Trouver des CTOs dans des startups fintech" → B2B (évident)
• "Trouver des influenceurs beauté sur Instagram avec plus de 100k abonnés" → KOL (évident)

Désambiguïsation des entités

Lorsqu'un utilisateur mentionne un nom d'entreprise qui pourrait faire référence à plusieurs entités (par exemple, "Manus" pourrait être Manus AI, Manus Bio, Manus Plus, etc.), désambiguïsez avant de rechercher :

1. Demandez à l'utilisateur quelle entreprise il veut dire, ou présentez les principaux candidats et laissez-le choisir.
2. Si le contexte le rend sans ambiguïté (par exemple, l'utilisateur a précédemment parlé d'agents IA), énoncez votre hypothèse et confirmez : "Vouliez-vous dire Manus AI (manus.im), l'entreprise d'agents IA ?"
3. Ne présumez jamais silencieusement une entité par rapport à une autre — un mauvais domaine = gaspillage de crédits de recherche et résultats non pertinents.

Aperçu des outils

Personnes

Déverrouillage de contact

Règle de décision : si la personne provient de votre propre résultat find_people → utilisez unlock_emails (les re-déverrouillages sont gratuits). Si vous avez obtenu l'identifiant en dehors de lessie (une URL LinkedIn que l'utilisateur a collée, une mention manuelle, etc.) → utilisez unlock_email_by_handle.

Entreprises

Recherche Web

Références détaillées

• Exemples de commandes CLI et appel MCP : Voir references/cli-reference.md
• Modèles de flux de travail (résolution de domaine, recherche d'entreprise, recherche+qualification) : Voir references/workflow-patterns.md
• Arbre de décision de résolution de domaine : Voir references/domain-resolution.md

Contraintes clés

• enrich_people / enrich_organization : max 10 par appel ; divisez les listes plus grandes en lots
• find_people : plafond strict de 3 appels d'outils + budget de 60 s en temps réel par requête. target_count 1-100 (par défaut 30). NON paginé — si vous avez besoin de plus, exécutez un nouvel appel avec une requête différente
• find_organizations : paginé — utilisez --page pour plus de résultats
• web_search met en cache le contenu de la page ; si un résultat a has_content: true, appeler web_fetch sur cette URL est instantané
• Mots-clés utiles à inclure dans une requête find-people : termes d'ancienneté (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) et current vs past pour privilégier la récence de l'emploi. L'agent les utilise directement comme filtres
• Pour l'enrichissement de personnes, fournir domain (domaine de l'entreprise) en plus du nom améliore considérablement la précision de la correspondance
• La sortie CLI est JSON sur stdout, les messages d'état sur stderr — analysez stdout pour les données