Keahlian Agen Pencarian Orang

Lessie — Pencarian & Pengayaan Orang

Penyiapan

Lessie mendukung dua mode: CLI (default, direkomendasikan) dan Server MCP.

Mode A: CLI (default)

Instal biner Lessie CLI:

npm install -g @lessie/cli

Atau gunakan tanpa menginstal:

npx @lessie/cli --version

Otorisasi pertama kali:

lessie auth

Ini akan membuka browser untuk login/pendaftaran. Token di-cache di ~/.lessie/oauth.json.

Verifikasi koneksi:

lessie status

Mode B: Server MCP

Tambahkan ke konfigurasi MCP Anda (Claude Code ~/.claude.json, Cursor ~/.cursor/mcp.json, Codex ~/.codex/config.toml, dll.):

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

Uninstal

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: Hapus entri "lessie" dari .json Anda dan jalankan rm -rf ~/.lessie/

Pemeriksaan Versi

Jalankan pemeriksaan ini sekali di awal setiap sesi, sebelum deteksi mode. Kedua pemeriksaan ini tidak memblokir — jika perintah gagal (kesalahan jaringan, waktu habis), lewati secara diam-diam dan lanjutkan.

Versi Skill

1. Baca versi lokal saat ini dari bidang metadata version di atas.
2. Ambil versi jarak jauh:

   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. Jika versi jarak jauh lebih baru dari versi lokal → beri tahu pengguna:

   ⬆️ Versi baru dari skill people-search tersedia ({local} → {remote}). Jalankan perintah ini untuk memperbarui:

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

4. Jika versi cocok atau pemeriksaan gagal → lewati, jangan katakan apa-apa.

Versi CLI

1. Dapatkan versi CLI lokal:

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

2. Dapatkan versi terbaru yang dipublikasikan:

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

3. Jika versi jarak jauh lebih baru → beri tahu pengguna:

   ⬆️ Versi baru dari Lessie CLI tersedia ({local} → {remote}). Jalankan perintah ini untuk memperbarui:

   npm install -g @lessie/cli
   

4. Jika versi cocok atau salah satu perintah gagal → lewati, jangan katakan apa-apa.

Mulai Cepat

Setelah penyiapan, coba katakan pada Claude:

• "Cari Manajer Teknik di Stripe di San Francisco"
• "Cari info kontak Sam Altman"
• "Riset OpenAI — berita terbaru dan lowongan pekerjaan terbuka"

Deteksi Mode

Tentukan mode yang akan digunakan di awal setiap sesi:

1. Periksa apakah CLI lessie tersedia: jalankan lessie status
2. Jika perintah berhasil → gunakan mode CLI (panggil alat melalui Bash)
3. Jika perintah gagal (tidak ditemukan) → coba instal otomatis: npm install -g @lessie/cli
4. Setelah instalasi, jalankan lessie status lagi untuk memverifikasi
5. Jika instalasi berhasil → gunakan mode CLI
6. Jika instalasi gagal (tidak ada npm, izin ditolak, kesalahan jaringan, dll.) → periksa apakah alat MCP tersedia (authorize, use_lessie)
7. Jika alat MCP tersedia → gunakan mode MCP
8. Jika tidak keduanya → beri tahu pengguna bahwa instalasi gagal dan sarankan instalasi manual atau penyiapan MCP

Kredit & Harga

Lessie adalah layanan berbasis kredit.

Akun baru menerima kredit uji coba gratis. Lihat saldo Anda dan beli lebih banyak di https://lessie.ai/pricing.

Agen akan mendisambiguasi nama perusahaan sebelum mencari untuk menghindari pemborosan kredit pada hasil yang salah.

Data & Privasi

• Sumber data: Informasi kontak dan perusahaan dikumpulkan dari sumber yang tersedia untuk umum (direktori bisnis, profil sosial, situs web perusahaan).
• Pencatatan kueri: Kueri pencarian dicatat untuk peningkatan layanan dan pencegahan penyalahgunaan. Tidak ada data kueri yang dibagikan dengan pihak ketiga.
• Kepatuhan data: Lessie mengikuti peraturan perlindungan data yang berlaku. Pengguna bertanggung jawab untuk menggunakan data kontak yang diambil sesuai dengan hukum setempat (GDPR, CAN-SPAM, dll.).
• Kebijakan privasi: https://lessie.ai/privacy
• Ketentuan layanan: https://lessie.ai/terms-of-service

Otorisasi

Mode CLI

1. Jalankan lessie status untuk memeriksa validitas token.
2. Jika authorized: false → jalankan lessie auth untuk membuka browser untuk login.
3. Setelah pengguna menyelesaikan login, jalankan lessie status lagi untuk mengonfirmasi.

Mode MCP

1. Panggil authorize untuk memeriksa status koneksi.
2. Jika sudah terotorisasi → lanjutkan untuk menggunakan alat secara langsung.
3. Jika tidak terotorisasi → authorize mengembalikan URL otorisasi. Beri tahu pengguna bahwa Anda perlu membuka browser untuk login/pendaftaran Lessie, dan buka menggunakan perintah sistem yang sesuai:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Beri tahu pengguna bahwa browser telah dibuka dan mereka perlu menyelesaikan login/pendaftaran.
5. Setelah pengguna mengonfirmasi, panggil authorize lagi untuk memverifikasi koneksi.
6. Jika otorisasi gagal (waktu habis, ditolak, konflik port), ikuti petunjuk diagnostik yang dikembalikan oleh authorize dan coba lagi.

Selalu beri tahu pengguna sebelum membuka browser — jangan pernah mengalihkan secara diam-diam.

Aturan Perilaku Agen

KRITIS: Konfirmasi sebelum setiap tindakan yang menghabiskan kredit

Setiap panggilan alat Lessie menghabiskan kredit. Biaya kredit per alat:

Sebelum menjalankan perintah apa pun, Anda HARUS:

1. Beri tahu pengguna apa yang akan Anda lakukan dan perkiraan biayanya (mis., "Saya akan memperkaya 3 orang — ini menghabiskan ~3 kredit").
2. Tunggu konfirmasi eksplisit sebelum menjalankan.
3. Jangan pernah menggabungkan beberapa panggilan yang menghabiskan kredit tanpa mengonfirmasi rencana lengkap terlebih dahulu.

Pengecualian — lewati konfirmasi jika pengguna secara eksplisit mengatakan tidak ingin diminta (mis., "jangan tanya saya setiap kali", "lakukan saja", "lewati konfirmasi"). Dalam hal ini, lanjutkan langsung tetapi tetap catat apa yang Anda jalankan dan kredit yang dihabiskan setelah setiap panggilan.

KRITIS: Laporkan penggunaan kredit setelah setiap panggilan

Setelah setiap giliran percakapan yang melibatkan satu atau lebih panggilan alat Lessie, tambahkan ringkasan satu baris dari kredit yang dikonsumsi. Format:

Digunakan <nama-alat>, biaya <N> kredit.

Jika beberapa alat dipanggil dalam giliran yang sama, gabungkan:

Digunakan web-search + enrich-org, total biaya 2 kredit.

KRITIS: Baca referensi sebelum panggilan CLI pertama

Sebelum menjalankan perintah lessie CLI untuk pertama kalinya dalam sesi, Anda HARUS membaca references/cli-reference.md untuk mempelajari sintaks parameter yang tepat. Setiap alat memiliki set flag sendiri — find-people menggunakan --query (NL), enrich-people menggunakan --people (JSON), unlock-emails menggunakan --search-id + --person-ids, dll. Jangan menebak — baca bagian untuk alat yang akan Anda panggil.

Disambiguasi Mode Pencarian (B2B vs KOL)

Lessie mendukung dua mode pencarian dengan sumber data dan jenis hasil yang berbeda:

• Mode B2B: Mencari basis data profesional (berbasis LinkedIn). Terbaik untuk menemukan orang berdasarkan jabatan, perusahaan, senioritas, atau industri. Mengembalikan email kerja, telepon, riwayat pekerjaan.
• Mode KOL: Mencari platform media sosial (Instagram, YouTube, TikTok, Twitter/X). Terbaik untuk menemukan influencer, pembuat konten, atau tokoh publik berdasarkan audiens, jumlah pengikut, atau topik konten. Mengembalikan tautan sosial, jumlah pengikut.

Ketika maksud pengguna ambigu — mis., kueri dapat secara wajar menargetkan profesional di LinkedIn atau pembuat konten di media sosial — Anda HARUS meminta klarifikasi kepada pengguna sebelum mencari. Sajikan kedua opsi secara ringkas:

Contoh kueri ambigu: "Temukan individu yang memiliki pengalaman langsung dengan perangkat pemantauan tidur otak untuk berbagi wawasan mereka."

Ini dapat berarti:

1. B2B: Manajer produk, insinyur, atau peneliti di perusahaan teknologi tidur (melalui LinkedIn)
2. KOL: Influencer kesehatan/teknologi yang telah mengulas atau menggunakan perangkat tersebut (melalui media sosial)

Tanya: "Ini bisa berarti profesional LinkedIn (PM, insinyur di perusahaan teknologi tidur) atau pembuat konten media sosial yang mengulas perangkat tidur. Arah mana yang Anda sukai — atau keduanya?"

Ketika maksud jelas, lanjutkan langsung:

• "Cari CTO di startup fintech" → B2B (jelas)
• "Cari influencer kecantikan di Instagram dengan 100k+ pengikut" → KOL (jelas)

Disambiguasi Entitas

Ketika pengguna menyebutkan nama perusahaan yang dapat merujuk ke beberapa entitas (mis., "Manus" bisa berarti Manus AI, Manus Bio, Manus Plus, dll.), lakukan disambiguasi sebelum mencari:

1. Tanyakan pengguna perusahaan mana yang mereka maksud, atau sajikan kandidat teratas dan biarkan mereka memilih.
2. Jika konteks membuatnya tidak ambigu (mis., pengguna sebelumnya membahas agen AI), nyatakan asumsi Anda dan konfirmasi: "Apakah Anda maksud Manus AI (manus.im), perusahaan agen AI?"
3. Jangan pernah diam-diam berasumsi satu entitas daripada yang lain — domain yang salah = kredit pencarian terbuang dan hasil yang tidak relevan.

Ikhtisar Alat

Orang

Buka Kunci Kontak

Aturan keputusan: jika orang tersebut berasal dari hasil find_people Anda sendiri → gunakan unlock_emails (pembukaan ulang gratis). Jika Anda mendapatkan handle dari luar lessie (URL LinkedIn yang ditempel pengguna, penyebutan manual, dll.) → gunakan unlock_email_by_handle.

Perusahaan

Riset Web

Referensi Rinci

• Contoh perintah CLI & panggilan MCP: Lihat references/cli-reference.md
• Pola alur kerja (resolusi domain, riset perusahaan, cari+kualifikasi): Lihat references/workflow-patterns.md
• Pohon keputusan resolusi domain: Lihat references/domain-resolution.md

Batasan Utama

• enrich_people / enrich_organization: maks 10 per panggilan; pisahkan daftar yang lebih besar menjadi batch
• find_people: batas keras 3 panggilan alat + anggaran waktu dinding 60 detik per permintaan. target_count 1-100 (default 30). TIDAK dipaginasi — jika Anda memerlukan lebih, jalankan panggilan baru dengan kueri yang berbeda
• find_organizations: dipaginasi — gunakan --page untuk hasil lebih banyak
• web_search menyimpan konten halaman dalam cache; jika hasil memiliki has_content: true, memanggil web_fetch pada URL tersebut instan
• Kata kunci yang berguna untuk disertakan dalam kueri find-people: istilah senioritas (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) dan current vs past untuk membiaskan kebaruan pekerjaan. Agen menggunakan ini secara langsung sebagai filter
• Untuk pengayaan orang, menyediakan domain (domain perusahaan) bersama dengan nama sangat meningkatkan akurasi kecocokan
• Output CLI adalah JSON di stdout, pesan status di stderr — parse stdout untuk data