Навык агента по поиску людей

Лесси — поиск и обогащение данных о людях

Настройка

Лесси поддерживает два режима: CLI (по умолчанию, рекомендуется) и MCP Server.

Режим A: CLI (по умолчанию)

Установите исполняемый файл Лесси CLI:

npm install -g @lessie/cli

Или используйте без установки:

npx @lessie/cli --version

Авторизация при первом запуске:

lessie auth

Откроется браузер для входа/регистрации. Токен кэшируется в ~/.lessie/oauth.json.

Проверьте соединение:

lessie status

Режим B: MCP Server

Добавьте в конфигурацию MCP (Claude Code ~/.claude.json, Cursor ~/.cursor/mcp.json, Codex ~/.codex/config.toml и т.д.):

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

Удаление

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Удалите запись "lessie" из вашего .json и выполните rm -rf ~/.lessie/

Проверка версий

Выполняйте эти проверки один раз в начале каждой сессии, до определения режима. Обе проверки неблокирующие — если какая-либо команда завершится ошибкой (сетевая ошибка, тайм-аут), пропустите её без уведомления и продолжайте.

Версия навыка

1. Прочитайте текущую локальную версию из поля version в метаданных этого файла выше.
2. Получите удалённую версию:

   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. Если удалённая версия новее локальной → сообщите пользователю:

   ⬆️ Доступна более новая версия навыка people-search ({local} → {remote}). Выполните эту команду для обновления:

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

4. Если версии совпадают или проверка не удалась → пропустите, ничего не говорите.

Версия CLI

1. Получите локальную версию CLI:

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

2. Получите последнюю опубликованную версию:

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

3. Если удалённая версия новее → сообщите пользователю:

   ⬆️ Доступна более новая версия Лесси CLI ({local} → {remote}). Выполните эту команду для обновления:

   npm install -g @lessie/cli
   

4. Если версии совпадают или какая-либо команда завершилась ошибкой → пропустите, ничего не говорите.

Быстрый старт

После настройки попробуйте сказать Клоду:

• "Найти менеджеров по разработке в Stripe в Сан-Франциско"
• "Найти контактную информацию Сэма Альтмана"
• "Исследовать OpenAI — последние новости и открытые вакансии"

Определение режима

Определите, какой режим использовать, в начале каждой сессии:

1. Проверьте, доступен ли CLI lessie: выполните lessie status
2. Если команда выполнена успешно → используйте режим CLI (вызывайте инструменты через Bash)
3. Если команда не выполнена (не найдена) → попробуйте автоматическую установку: npm install -g @lessie/cli
4. После установки снова выполните lessie status для проверки
5. Если установка успешна → используйте режим CLI
6. Если установка не удалась (нет npm, отказано в доступе, сетевая ошибка и т.д.) → проверьте, доступны ли инструменты MCP (authorize, use_lessie)
7. Если инструменты MCP доступны → используйте режим MCP
8. Если ни то, ни другое → сообщите пользователю, что установка не удалась, и предложите ручную установку или настройку MCP

Кредиты и цены

Лесси — это сервис, работающий на основе кредитов.

Новые аккаунты получают бесплатные пробные кредиты. Просмотрите свой баланс и приобретите дополнительные кредиты на https://lessie.ai/pricing.

Агент будет уточнять названия компаний перед поиском, чтобы избежать траты кредитов на неверные результаты.

Данные и конфиденциальность

• Источники данных: Контактная информация и данные о компаниях собираются из общедоступных источников (бизнес-справочники, социальные профили, корпоративные веб-сайты).
• Логирование запросов: Поисковые запросы регистрируются для улучшения сервиса и предотвращения злоупотреблений. Данные запросов не передаются третьим лицам.
• Соответствие требованиям: Лесси соблюдает применимые правила защиты данных. Пользователи несут ответственность за использование полученных контактных данных в соответствии с местными законами (GDPR, CAN-SPAM и т.д.).
• Политика конфиденциальности: https://lessie.ai/privacy
• Условия использования: https://lessie.ai/terms-of-service

Авторизация

Режим CLI

1. Выполните lessie status для проверки действительности токена.
2. Если authorized: false → выполните lessie auth, чтобы открыть браузер для входа.
3. После того как пользователь завершит вход, снова выполните lessie status для подтверждения.

Режим MCP

1. Вызовите authorize, чтобы проверить статус подключения.
2. Если уже авторизованы → сразу приступайте к использованию инструментов.
3. Если не авторизованы → authorize возвращает URL для авторизации. Сообщите пользователю, что нужно открыть браузер для входа/регистрации в Лесси, и откройте его с помощью соответствующей системной команды:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Сообщите пользователю, что браузер открыт, и ему необходимо завершить вход/регистрацию.
5. После подтверждения пользователем снова вызовите authorize для проверки подключения.
6. Если авторизация не удалась (тайм-аут, отказ, конфликт портов), следуйте диагностическим подсказкам, возвращаемым authorize, и повторите попытку.

Всегда информируйте пользователя перед открытием браузера — никогда не перенаправляйте без предупреждения.

Правила поведения агента

ВАЖНО: Подтверждайте перед каждым действием, потребляющим кредиты

Каждый вызов инструмента Лесси стоит кредитов. Стоимость в кредитах за инструмент:

Перед выполнением любой команды вы ДОЛЖНЫ:

1. Сообщить пользователю, что вы собираетесь сделать, и приблизительную стоимость (например, «Я обогащу данные о 3 людях — это будет стоить ~3 кредита»).
2. Дождаться явного подтверждения перед выполнением.
3. Никогда не выполняйте несколько вызовов, потребляющих кредиты, без предварительного подтверждения всего плана.

Исключение — пропускайте подтверждение, если пользователь явно сказал, что не хочет, чтобы его спрашивали (например, «не спрашивай меня каждый раз», «просто сделай это», «пропускай подтверждения»). В этом случае действуйте напрямую, но всё равно регистрируйте, что вы выполнили и сколько кредитов потратили после каждого вызова.

ВАЖНО: Сообщайте об использовании кредитов после каждого вызова

После каждого раунда диалога, в котором был сделан один или несколько вызовов инструментов Лесси, добавьте однострочную сводку потраченных кредитов. Формат:

Использован <название-инструмента>, стоимость <N> кредит(ов).

Если в одном раунде было вызвано несколько инструментов, объедините их:

Использованы web-search + enrich-org, общая стоимость 2 кредита.

ВАЖНО: Читайте справочные материалы перед первым вызовом CLI

Перед первым выполнением любой команды lessie CLI в сессии вы ДОЛЖНЫ прочитать references/cli-reference.md, чтобы узнать точный синтаксис параметров. У каждого инструмента свой набор флагов — find-people принимает --query (NL), enrich-people принимает --people (JSON), unlock-emails принимает --search-id + --person-ids и т.д. Не гадайте — прочитайте раздел для инструмента, который собираетесь вызвать.

Уточнение режима поиска (B2B или KOL)

Лесси поддерживает два режима поиска с разными источниками данных и типами результатов:

• Режим B2B: Поиск в профессиональных базах данных (на основе LinkedIn). Лучше всего подходит для поиска людей по должности, компании, уровню или отрасли. Возвращает рабочий email, телефон, историю занятости.
• Режим KOL: Поиск на платформах социальных сетей (Instagram, YouTube, TikTok, Twitter/X). Лучше всего подходит для поиска инфлюенсеров, создателей контента или публичных лиц по аудитории, количеству подписчиков или тематике контента. Возвращает ссылки на социальные сети, количество подписчиков.

Когда намерение пользователя неоднозначно — т.е. запрос может разумно нацеливаться как на профессионалов в LinkedIn, так и на создателей в социальных сетях — вы ДОЛЖНЫ попросить пользователя уточнить перед поиском. Кратко представьте оба варианта:

Пример неоднозначного запроса: «Найти людей, у которых есть практический опыт работы с устройствами для мониторинга сна, чтобы поделиться своими мыслями.»

Это может означать:

1. B2B: Менеджеры по продукту, инженеры или исследователи в компаниях, занимающихся технологиями сна (через LinkedIn)
2. KOL: Инфлюенсеры в области здоровья/технологий, которые обозревали или использовали такие устройства (через социальные сети)

Спросите: «Это могут быть профессионалы LinkedIn (менеджеры по продуктам, инженеры в компаниях по технологиям сна) или создатели контента в социальных сетях, которые обозревают устройства для сна. Какое направление вы предпочитаете — или оба?»

Когда намерение ясно, действуйте напрямую:

• «Найти технических директоров в финтех-стартапах» → B2B (очевидно)
• «Найти бьюти-инфлюенсеров в Instagram с 100 тыс.+ подписчиков» → KOL (очевидно)

Уточнение сущностей

Когда пользователь упоминает название компании, которое может относиться к нескольким объектам (например, «Manus» может быть Manus AI, Manus Bio, Manus Plus и т.д.), уточните перед поиском:

1. Спросите пользователя, какую компанию он имеет в виду, или представьте основных кандидатов и позвольте выбрать.
2. Если контекст делает это однозначным (например, пользователь ранее обсуждал ИИ-агентов), сформулируйте своё предположение и подтвердите: «Вы имели в виду Manus AI (manus.im), компанию по разработке ИИ-агентов?»
3. Никогда не предполагайте молча одну сущность вместо другой — неправильный домен = потраченные кредиты на поиск и нерелевантные результаты.

Обзор инструментов

Люди

Разблокировка контактов

Решающее правило: если человек взят из вашего собственного результата find_people → используйте unlock_emails (повторные разблокировки бесплатны). Если вы получили дескриптор извне Лесси (URL LinkedIn, вставленный пользователем, упоминание вручную и т.д.) → используйте unlock_email_by_handle.

Компании

Веб-исследования

Подробные справочные материалы

• Примеры команд CLI и вызов MCP: См. references/cli-reference.md
• Шаблоны рабочих процессов (разрешение доменов, исследование компаний, поиск+квалификация): См. references/workflow-patterns.md
• Дерево решений для разрешения доменов: См. references/domain-resolution.md

Ключевые ограничения

• enrich_people / enrich_organization: максимум 10 за вызов; разбивайте большие списки на пакеты.
• find_people: жёсткий предел 3 вызова инструмента + бюджет 60 секунд реального времени на запрос. target_count 1-100 (по умолчанию 30). БЕЗ пагинации — если нужно больше, выполните новый вызов с другим запросом.
• find_organizations: с пагинацией — используйте --page для дополнительных результатов.
• web_search кэширует содержимое страниц; если результат имеет has_content: true, вызов web_fetch для этого URL выполняется мгновенно.
• Полезные ключевые слова для включения в запрос find-people: термины уровня должности (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) и current против past для смещения в сторону актуальности занятости. Агент использует их напрямую как фильтры.
• Для обогащения данных о людях указание domain (домен компании) вместе с именем значительно повышает точность сопоставления.
• Вывод CLI — JSON в stdout, сообщения о статусе в stderr — анализируйте stdout для получения данных.