Kişi Arama Ajanı Becerisi

Lessie — Kişi Arama ve Zenginleştirme

Kurulum

Lessie iki modu destekler: CLI (varsayılan, önerilen) ve MCP Server.

Mod A: CLI (varsayılan)

Lessie CLI ikili dosyasını yükleyin:

npm install -g @lessie/cli

Veya kurulum yapmadan kullanın:

npx @lessie/cli --version

İlk yetkilendirme:

lessie auth

Bu, giriş/kayıt için bir tarayıcı açar. Token ~/.lessie/oauth.json konumunda önbelleğe alınır.

Bağlantıyı doğrulayın:

lessie status

Mod B: MCP Sunucusu

MCP yapılandırmanıza ekleyin (Claude Code ~/.claude.json, Cursor ~/.cursor/mcp.json, Codex ~/.codex/config.toml, vb.):

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

Kaldırma

• CLI: npm uninstall -g @lessie/cli && rm -rf ~/.lessie/
• MCP: .json dosyanızdaki "lessie" girdisini kaldırın ve rm -rf ~/.lessie/

Sürüm Kontrolü

Bu kontrolleri her oturumun başında, mod algılamadan önce bir kez çalıştırın. Her iki kontrol de engellemez — bir komut başarısız olursa (ağ hatası, zaman aşımı) sessizce atlayın ve devam edin.

Yetenek Sürümü

1. Bu dosyanın üst kısmındaki meta verideki version alanından mevcut yerel sürümü okuyun.
2. Uzak sürümü alın:

   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. Uzak sürüm yerel sürümden daha yeniyse → kullanıcıya şunu söyleyin:

   ⬆️ Kişi arama yeteneğinin daha yeni bir sürümü mevcut ({local} → {remote}). Güncellemek için bu komutu çalıştırın:

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

4. Sürümler eşleşirse veya kontrol başarısız olursa → atla, bir şey söyleme.

CLI Sürümü

1. Yerel CLI sürümünü alın:

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

2. Yayınlanan en son sürümü alın:

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

3. Uzak sürüm daha yeniyse → kullanıcıya şunu söyleyin:

   ⬆️ Lessie CLI'nin daha yeni bir sürümü mevcut ({local} → {remote}). Güncellemek için bu komutu çalıştırın:

   npm install -g @lessie/cli
   

4. Sürümler eşleşirse veya herhangi bir komut başarısız olursa → atla, bir şey söyleme.

Hızlı Başlangıç

Kurulumdan sonra Claude'a şunları söylemeyi deneyin:

• "San Francisco'daki Stripe'da Mühendislik Yöneticilerini bul"
• "Sam Altman'ın iletişim bilgilerini ara"
• "OpenAI'ı araştır — son haberler ve açık iş ilanları"

Mod Algılama

Her oturumun başında hangi modun kullanılacağını belirleyin:

1. lessie CLI'nin mevcut olup olmadığını kontrol edin: lessie status çalıştırın
2. Komut başarılı olursa → CLI modu'nu kullanın (araçları Bash aracılığıyla çağırın)
3. Komut başarısız olursa (bulunamadı) → otomatik kurulumu deneyin: npm install -g @lessie/cli
4. Kurulumdan sonra doğrulamak için tekrar lessie status çalıştırın
5. Kurulum başarılı olursa → CLI modu'nu kullanın
6. Kurulum başarısız olursa (npm yok, izin reddedildi, ağ hatası, vb.) → MCP araçlarının mevcut olup olmadığını kontrol edin (authorize, use_lessie)
7. MCP araçları mevcutsa → MCP modu'nu kullanın
8. Hiçbiri yoksa → kullanıcıya kurulumun başarısız olduğunu bildirin ve manuel kurulum veya MCP kurulumu önerin

Krediler ve Fiyatlandırma

Lessie kredi tabanlı bir hizmettir.

Yeni hesaplar ücretsiz deneme kredileri alır. Bakiyenizi görüntüleyin ve daha fazlasını https://lessie.ai/pricing adresinden satın alın.

Aracı, yanlış sonuçlar için kredi harcamamak için aramadan önce şirket adlarını netleştirecektir.

Veri ve Gizlilik

• Veri kaynakları: İletişim ve şirket bilgileri halka açık kaynaklardan (iş dizinleri, sosyal profiller, kurumsal web siteleri) toplanır.
• Sorgu günlüğü: Arama sorguları hizmet iyileştirme ve kötüye kullanımı önleme amacıyla günlüğe kaydedilir. Hiçbir sorgu verisi üçüncü taraflarla paylaşılmaz.
• Veri uyumluluğu: Lessie geçerli veri koruma düzenlemelerine uyar. Kullanıcılar, alınan iletişim verilerini yerel yasalara (GDPR, CAN-SPAM, vb.) uygun olarak kullanmaktan sorumludur.
• Gizlilik politikası: https://lessie.ai/privacy
• Hizmet şartları: https://lessie.ai/terms-of-service

Yetkilendirme

CLI Modu

1. Token geçerliliğini kontrol etmek için lessie status çalıştırın.
2. authorized: false ise → giriş için tarayıcıyı açmak üzere lessie auth çalıştırın.
3. Kullanıcı girişi tamamladıktan sonra onaylamak için tekrar lessie status çalıştırın.

MCP Modu

1. Bağlantı durumunu kontrol etmek için authorize'ı çağırın.
2. Zaten yetkilendirilmişse → doğrudan araçları kullanmaya devam edin.
3. Yetkilendirilmemişse → authorize bir yetkilendirme URL'si döndürür. Kullanıcıya Lessie giriş/kayıt için bir tarayıcı açmanız gerektiğini söyleyin ve uygun sistem komutunu kullanarak açın:
   • macOS: open "<url>"
   • Linux: xdg-open "<url>"
   • Windows: start "<url>"
4. Kullanıcıya tarayıcının açıldığını ve giriş/kaydı tamamlaması gerektiğini söyleyin.
5. Kullanıcı onayladıktan sonra bağlantıyı doğrulamak için tekrar authorize'ı çağırın.
6. Yetkilendirme başarısız olursa (zaman aşımı, reddedildi, bağlantı noktası çakışması), authorize tarafından döndürülen tanı ipuçlarını izleyin ve yeniden deneyin.

Tarayıcıyı açmadan önce her zaman kullanıcıyı bilgilendirin — asla sessizce yönlendirme yapmayın.

Ajan Davranış Kuralları

KRİTİK: Her kredi harcayan eylemden önce onaylayın

Her Lessie araç çağrısı kredi harcar. Araç başına kredi maliyetleri:

Herhangi bir komutu çalıştırmadan önce ŞUNLARI YAPMALISINIZ:

1. Kullanıcıya ne yapmak üzere olduğunuzu ve tahmini maliyeti söyleyin (örn. "3 kişiyi zenginleştireceğim — bu yaklaşık 3 kredi tutar").
2. Çalıştırmadan önce açık onay bekleyin.
3. Tam planı onaylamadan birden fazla kredi harcayan çağrıyı asla toplu olarak yapmayın.

İstisna — onayı atla eğer kullanıcı açıkça uyarılmak istemediğini söylemişse (örn. "bana her seferinde sorma", "sadece yap", "onayları atla"). Bu durumda doğrudan devam edin ancak yine de her çağrıdan sonra ne yürüttüğünüzü ve harcanan kredileri günlüğe kaydedin.

KRİTİK: Her çağrıdan sonra kredi kullanımını raporlayın

Bir veya daha fazla Lessie araç çağrısı içeren her konuşma turundan sonra, tüketilen kredilerin tek satırlık bir özetini ekleyin. Biçim:

<araç-adı> kullanıldı, maliyet <N> kredi.

Aynı turda birden fazla araç çağrıldıysa, bunları birleştirin:

web-search + enrich-org kullanıldı, toplam maliyet 2 kredi.

KRİTİK: İlk CLI çağrısından önce referansları okuyun

Bir oturumda herhangi bir lessie CLI komutunu ilk kez çalıştırmadan önce, tam parametre sözdizimini öğrenmek için references/cli-reference.md dosyasını OKUMALISINIZ. Her aracın kendi bayrak kümesi vardır — find-people --query (NL) alır, enrich-people --people (JSON) alır, unlock-emails --search-id + --person-ids alır, vb. Tahmin etmeyin — çağırmak üzere olduğunuz araç için bölümü okuyun.

Arama modu belirsizliğini giderme (B2B vs KOL)

Lessie, farklı veri kaynakları ve sonuç türleri olan iki arama modunu destekler:

• B2B modu: Profesyonel veritabanlarında (LinkedIn tabanlı) arama yapar. İş unvanı, şirket, kıdem veya sektöre göre kişi bulmak için en iyisidir. İş e-postası, telefon, iş geçmişi döndürür.
• KOL modu: Sosyal medya platformlarında (Instagram, YouTube, TikTok, Twitter/X) arama yapar. Kitleye, takipçi sayısına veya içerik konusuna göre etkileyicileri, içerik oluşturucuları veya tanınmış kişileri bulmak için en iyisidir. Sosyal bağlantılar, takipçi sayıları döndürür.

Kullanıcının amacı belirsizse — yani sorgu makul bir şekilde LinkedIn'daki profesyonelleri veya sosyal medyadaki içerik oluşturucuları hedefleyebilirse — aramadan önce kullanıcıdan netleştirmesini istemelisiniz. Her iki seçeneği de kısaca sunun:

Örnek belirsiz sorgu: "Beyin izlemeli uyku cihazları konusunda uygulamalı deneyimi olan ve içgörülerini paylaşacak kişiler bul."

Bu şu anlama gelebilir:

1. B2B: Uyku teknolojisi şirketlerindeki ürün yöneticileri, mühendisler veya araştırmacılar (LinkedIn üzerinden)
2. KOL: Bu tür cihazları incelemiş veya kullanmış sağlık/teknoloji etkileyicileri (sosyal medya üzerinden)

Sorun: "Bu, LinkedIn profesyonelleri (PM'ler, uyku teknolojisi şirketlerindeki mühendisler) veya uyku cihazlarını inceleyen sosyal medya içerik oluşturucuları olabilir. Hangi yönü tercih edersiniz — veya her ikisini de mi?"

Amaç net olduğunda, doğrudan devam edin:

• "Fintech girişimlerindeki CTO'ları bul" → B2B (belirgin)
• "Instagram'da 100k+ takipçili güzellik etkileyicilerini bul" → KOL (belirgin)

Varlık belirsizliğini giderme

Kullanıcı birden fazla varlığa atıfta bulunabilecek bir şirket adı söylediğinde (örn. "Manus", Manus AI, Manus Bio, Manus Plus vb. olabilir), aramadan önce netleştirin:

1. Kullanıcıya hangi şirketi kastettiğini sorun veya en iyi adayları sunup seçmelerine izin verin.
2. Bağlam bunu netleştiriyorsa (örn. kullanıcı daha önce AI ajanlarını tartıştı), varsayımınızı belirtin ve onaylayın: "Manus AI (manus.im), AI-ajan şirketi mi demek istediniz?"
3. Asla sessizce bir varlığı diğerine varsaymayın — yanlış alan adı = boşa harcanmış arama kredileri ve alakasız sonuçlar.

Araçlara Genel Bakış

Kişiler

İletişim Kilidini Açma

Karar kuralı: kişi kendi find_people sonucunuzdan geldiyse → unlock_emails kullanın (yeniden açmalar ücretsizdir). Handle'ı lessie dışından aldıysanız (kullanıcının yapıştırdığı bir LinkedIn URL'si, manuel bir bahsetme, vb.) → unlock_email_by_handle kullanın.

Şirketler

Web Araştırması

Ayrıntılı Referanslar

• CLI komut örnekleri ve MCP çağırma: references/cli-reference.md dosyasına bakın
• İş Akışı Desenleri (alan adı çözümleme, şirket araştırması, arama+nitelendirme): references/workflow-patterns.md dosyasına bakın
• Alan adı çözümleme karar ağacı: references/domain-resolution.md dosyasına bakın

Temel Kısıtlamalar

• enrich_people / enrich_organization: çağrı başına en fazla 10; daha büyük listeleri partilere bölün
• find_people: istek başına 3 araç çağrısı + 60sn duvar saati bütçesi sert sınırı. target_count 1-100 (varsayılan 30). Sayfalandırılmaz — daha fazlasına ihtiyacınız varsa farklı bir sorgu ile yeni bir çağrı çalıştırın
• find_organizations: sayfalandırılır — daha fazla sonuç için --page kullanın
• web_search sayfa içeriğini önbelleğe alır; bir sonuç has_content: true içeriyorsa, o URL'de web_fetch çağırmak anlıktır
• Bir find-people sorgusuna dahil edilecek yararlı anahtar kelimeler: kıdem terimleri (owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern) ve istihdam yeniliğini öne almak için current vs past. Ajan bunları doğrudan filtre olarak kullanır
• Kişi zenginleştirme için, isimle birlikte domain (şirket alan adı) sağlamak eşleşme doğruluğunu büyük ölçüde artırır
• CLI çıktısı stdout'ta JSON'dur, durum mesajları stderr'de — veri için stdout'u ayrıştırın