Pearch

Pearch.ai MCP

MCP sunucusu Pearch.AI için: kişiler ve şirketler/potansiyel müşteriler (B2B) üzerinde doğal dilde arama. Claude, Cursor, VS Code veya MCP uyumlu herhangi bir istemciden kullanın.

Yapay Zeka İşe Alım Kaynak Bulma Araçlarının İnsan Tercihine Göre Değerlendirilmesi

Araçlar

Araç	Açıklama
search_people	Doğal dilde kişi arama (örn. "Kaliforniya'da 5+ yıl Python deneyimine sahip yazılım mühendisleri"). Hızlı/pro/süper hızlı arama türlerini, iletişim bilgisi gösterme ve filtrelerini, gerçek zamanlı profil yenilemeyi, içgörüleri ve konu tabanlı sayfalama/takip sorularını destekler.
search_company_leads	Şirketleri ve içlerindeki potansiyel müşterileri/kişileri bulun (B2B). Örnek: şirket "SF'deki yapay zeka girişimleri, 50–200 çalışan" + potansiyel müşteriler "CTO'lar ve mühendislik yöneticileri", isteğe bağlı kişiselleştirilmiş tanıtım mesajlarıyla.
get_profile	LinkedIn kısa adı veya e-posta ile tek bir kişiyi arayın ve zenginleştirin (iletişim bilgisi gösterme, gerçek zamanlı yenileme, GitHub zenginleştirme).
get_user_info	Kimliği doğrulanmış kullanıcı bilgileri: e-posta, kalan kredi, fiyatlandırma planı. Ücretsiz.

Özel yapılandırılmış filtreler (custom_filters / search_requirements) bilinçli olarak açığa çıkarılmamıştır — her şeyi doğal dil sorgusunda tanımlayın.

Uzak sunucu (önerilir)

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 destekleyen istemciler (Claude, Cursor, VS Code) akışı otomatik olarak keşfeder ve Google oturum açma sayfasını 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 kendi Pearch hesabınızdan kredi harcar. Pearch hesabınızda henüz API anahtarı yoksa, önce Pearch.ai Panosu üzerinden bir tane oluşturun.

API anahtarı

Aynı Pearch API anahtarını api.pearch.ai olarak iletin:

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

test_mcp_key değerini maskeli (örnek) sonuçlar için kullanın — kayıt gerektirmez.

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 değerini pano anahtarınızla değiştirin.

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ı taşıyıcı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 hedef kitlesi 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 gereklidir.
PEARCH_MCP_INTERNAL_TOKEN	—	Pearch API'sinin dahili e-posta→API anahtarı eşleme uç noktası için paylaşılan gizli anahtar. oauth modunda gereklidir.
PEARCH_MCP_OAUTH_STORE	disk	redis OAuth durumunu (istemci kayıtları, token'lar — şifreli) Redis'te tutar, böylece yeniden başlatmalarda korunur ve >1 kopya çalıştırmaya 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 önbellek TTL'si; ayrıca iptal gecikmesi.
PEARCH_API_URL	https://api.pearch.ai	Pearch API tabanı (ç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).

oauth modunda giriş/ters proxy, sunucuya yalnızca /mcp değil tüm ana bilgisayarı 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'nin 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. LISANS.