Pearch

Pearch.ai MCP

Pearch.AI için MCP sunucusu: kişiler ve şirketler/lead'ler (B2B) üzerinde doğal dil araması. Claude, Cursor, VS Code veya MCP uyumlu herhangi bir istemciden kullanın.

Evaluating AI Recruitment Sourcing Tools by Human Preference

Araçlar

Araç	Açıklama
search_people	Doğal dil query veya yapılandırılmış search_requirements ile kişi araması. fast/pro/superfast arama türlerini, iletişim bilgisi açma ve iletişim filtrelerini, gerçek zamanlı profil yenilemeyi, içgörüleri ve thread tabanlı sayfalama/takip sorgularını destekler.
search_company_leads	Şirketleri ve bunların içindeki lead'leri/kişileri bulun (B2B). Örnek: şirket "SF'deki AI girişimleri, 50–200 çalışan" + lead'ler "CTO'lar ve mühendislik yöneticileri", isteğe bağlı kişiselleştirilmiş erişim mesajlarıyla.
get_profile	LinkedIn slug veya e-posta ile tek bir kişiyi arayın ve zenginleştirin (iletişim bilgisi açma, gerçek zamanlı yenileme, GitHub zenginleştirme).
get_user_info	Kimliği doğrulanmış kullanıcı bilgileri: e-posta, kalan krediler, fiyatlandırma planı. Ücretsiz.

Yapılandırılmış kişi araması

Elinizde zaten bir kriter listesi varsa search_people parametresine search_requirements geçirin:

{
  "search_requirements": [
    {
      "search_requirement": "Software engineer with 5+ years of Python experience",
      "must_have": true
    },
    {
      "search_requirement": "Experience at a fintech company",
      "must_have": false
    }
  ],
  "search_type": "fast",
  "limit": 10,
  "insights": true,
  "reveal_emails": true
}

• search_requirement: zorunlu, boş olmayan metin. Her kriteri kısa ve kendi başına anlaşılır tutun.
• must_have: zorunlu kriterler için true, tercihe bağlı özellikler için false (varsayılan).

Liste en az bir gereksinim içermelidir. search_requirements kullanırken query isteğe bağlıdır; her ikisi de sağlanırsa API search_requirements önceliğini verir. Pearch arama API sözleşmesine bakın.

Her iki girdi de aynı arama seçeneklerini destekler: arama türü, içgörüler ve puanlama, profil yenileme, iletişim bilgisi açma ve filtreler, katı filtreleme, düşük güvenilirlikli sonuçlar, zaman bütçesi, sayfalama, yanıt alanları, profil hariç tutmaları ve ücretsiz maskelenmiş sonuçlar. Arama türü kısıtlamaları her iki girdi için de aynıdır; örneğin, superfast içgörüleri, profil puanlamayı veya yüksek tazeliği desteklemez.

Sayfalama için, döndürülen thread_id değerini limit ile ve isteğe bağlı olarak offset ile gönderin, query ve search_requirements parametrelerini atlayın. Kriterleri değiştirmek için thread_id olmadan yeni bir arama başlatın. Mevcut query çağrıları ve thread takip sorguları eskisi gibi iletilmeye devam eder; hangi takip parametrelerini kabul edeceğine API karar verir.

custom_filters bu MCP sunucusu tarafından sunulmaz. Kriterleri bunun yerine query veya search_requirements içinde ifade edin.

Uzak sunucu (önerilen)

Barındırılan sunucu https://mcp.pearch.ai/mcp adresinde bulunur ve aynı anda iki kimlik doğrulama şemasını destekler:

OAuth (anahtar yönetimi yok)

Sunucuyu herhangi bir başlık olmadan ekleyin — OAuth destekli istemciler (Claude, Cursor, VS Code) akışı otomatik olarak keşfeder ve bir Google oturum açma penceresi açar. E-postası Pearch hesabınızla eşleşen Google hesabıyla oturum açın:

claude mcp add --transport http pearch https://mcp.pearch.ai/mcp

Aramalarınız kredileri kendi Pearch hesabınızdan düşer. Pearch hesabınızda henüz bir API anahtarı yoksa, önce Pearch.ai Dashboard üzerinden bir tane oluşturun.

API anahtarı

Aynı Pearch API anahtarını api.pearch.ai olarak geçirin:

{
  "mcpServers": {
    "Pearch.ai": {
      "url": "https://mcp.pearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PEARCH_API_KEY}"
      }
    }
  }
}

Maskelenmiş (örnek) sonuçlar için test_mcp_key kullanın — kayıt gerekmez.

Yerel (stdio) kurulum

Python 3.10+ ve pip install -r requirements.txt (veya pip install fastmcp) gerektirir.

Claude Desktop / Claude Code

fastmcp install claude-desktop pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Veya mcpServers altında manuel olarak:

"Pearch.ai": {
  "command": "python",
  "args": ["/path/to/mcp_pearch/pearch_mcp.py"],
  "env": { "PEARCH_API_KEY": "test_mcp_key" }
}

Cursor

fastmcp install cursor pearch_mcp.py --env PEARCH_API_KEY=test_mcp_key

Tam sonuçlar için test_mcp_key yerine dashboard anahtarınızı koyun.

Kendi HTTP sunucunuzu çalıştırma

uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000

Sağlık kontrolü: GET /health veya /healthcheck (kimlik doğrulama modunu bildirir).

Ortam değişkenleri

Değişken	Varsayılan	Amaç
PEARCH_MCP_AUTH	api_key	oauth | api_key | none. oauth modunda ham API anahtarı bearer'ları hâlâ kabul edilir (çift kimlik doğrulama).
PEARCH_MCP_BASE_URL	http://localhost:8000	Bu sunucunun genel URL'si. OAuth meta verileri, token audience ve /auth/callback yönlendirme URI'si bundan türetilir.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Google OAuth 2.0 Web uygulaması istemcisi (<base_url>/auth/callback değerini yönlendirme URI'si olarak kaydedin). oauth modunda zorunludur.
PEARCH_MCP_INTERNAL_TOKEN	—	Dahili e-posta→API anahtarı eşlemesi ve istek kaynağı imzalama için paylaşılan gizli anahtar. oauth modunda ve API anahtarlarıyla doğrulanmış MCP atfı için zorunludur. Arka ucun MCP_INTERNAL_TOKEN değeriyle eşleşmelidir; son kullanıcılara asla dağıtmayın.
PEARCH_MCP_OAUTH_STORE	disk	redis OAuth durumunu (istemci kayıtları, token'lar — şifrelenmiş) Redis'te tutar; böylece yeniden başlatmalara dayanır ve >1 replikaya izin verir.
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	OAuth deposu için Redis bağlantısı.
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	yerleşik liste	MCP istemci yönlendirme URI'leri için virgülle ayrılmış fnmatch desenleri (* = herhangi biri).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	Doğrulanmış kimlik önbelleği TTL'i; aynı zamanda iptal gecikmesi.
PEARCH_API_URL	https://api.pearch.ai	Pearch API temel adresi (çağrı başına base_url geçersiz kılar).
PEARCH_API_KEY	test_mcp_key	stdio/yerel kullanım için yedek anahtar.
MCP_DISABLE_AUTH	—	1, PEARCH_MCP_AUTH=none ile eşdeğerdir (yalnızca yerel geliştirme).

Pearch API'sine yapılan araç istekleri, kişi araması, şirket-lead araması, sayfalama ve profil zenginleştirme dahil olmak üzere hem POST hem de GET çağrılarında X-Pearch-Source: mcp içerir. Barındırılan sunucu ayrıca dahili gizli anahtar yapılandırıldığında ve hedef origin PEARCH_API_URL ile eşleştiğinde X-Pearch-Source-Signature gönderir. HMAC, bearer kimlik bilgisini, yöntemi, çözümlenmiş yolu artı ham sorguyu, gövdeyi ve zaman damgasını bağlar. Arka uç, 300 saniye içindeki imzaları kabul eder, bu nedenle sunucu saatleri senkronize olmalıdır. Diğer origin'lerde çağıran tarafından sağlanan base_url değerleri imza almaz.

Arka uç, doğrulanmış MCP trafiğini analitik ve DevAdmin geçmişi için api_calls.request_source olarak kaydeder. Yalnızca bir kaynak başlığı yeterli değildir. API anahtarları kullanan imzasız kendi kendine barındırılan MCP trafiği api olarak kalır; kimliği doğrulanmış izin listesindeki OAuth istemcileri başlık olmadan tanınır. Arka uç kaynak günlüklemesini etkinleştirmeden önce, veritabanı geçişini uyguladıktan sonra imzalamayı dağıtın. Eski arka uçlar başlıkları yok sayar. Kimlik doğrulama, hesap atfı ve faturalandırma değişmez.

oauth modunda ingress/reverse proxy, yalnızca /mcp değil, tüm ana bilgisayarı sunucuya yönlendirmelidir: akış /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent ve /auth/callback ekler.

Geliştirme

export PEARCH_API_KEY='test_mcp_key'   # or your key for full results
fastmcp dev inspector pearch_mcp.py

Gizlilik Politikası

Pearch.AI'ın gizlilik politikası: https://pearch.ai/privacy-policy — veri toplama, kullanım, depolama, üçüncü taraflarla paylaşım, saklama ve iletişim bilgilerini kapsar. Veri silme / vazgeçme: https://pearch.ai/opt-out. Hizmet şartları: https://pearch.ai/tos.

Destek

• Bir sorun açın
• f@pearch.ai

Lisans

MIT — bkz. LICENSE.