Pearch

resmi

Mesin pencari orang terbaik yang mengurangi waktu yang dihabiskan untuk penemuan bakat.

GitHub

Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Pearch MCP?

Cari orang berdasarkan bahasa alami — Minta kandidat seperti "senior React developers in Berlin" dan search_people mengembalikan profil yang cocok beserta detail kontak dan wawasan.
Temukan perusahaan dan prospek — Gunakan search_company_leads untuk menemukan prospek B2B, misalnya, "AI startups in SF with 50-200 employees," beserta kontak seperti CTO, dengan draf pesan penjangkauan opsional.
Perkaya satu profil — Berikan slug LinkedIn atau email ke get_profile untuk mengungkap kontak, penyegaran waktu nyata, dan pengayaan GitHub.
Periksa status akun — Panggil get_user_info untuk melihat email Anda, sisa kredit, dan paket harga saat ini.

Dokumentasi

MCP Pearch.ai

Server MCP untuk Pearch.AI: pencarian bahasa alami atas orang dan perusahaan/prospek (B2B). Gunakan dari Claude, Cursor, VS Code, atau klien apa pun yang kompatibel dengan MCP.

Mengevaluasi Alat Sumber Rekrutmen AI berdasarkan Preferensi Manusia

Alat

Alat	Deskripsi
search_people	Pencarian orang dengan bahasa alami (mis. "insinyur perangkat lunak di California dengan pengalaman Python 5+ tahun"). Mendukung tipe pencarian cepat/pro/supercepat, pengungkapan kontak & filter kontak, penyegaran profil waktu nyata, wawasan, serta paginasi/tindak lanjut berbasis utas.
search_company_leads	Temukan perusahaan dan prospek/kontak di dalamnya (B2B). Contoh: perusahaan "startup AI di SF, 50–200 karyawan" + prospek "CTO dan manajer teknik", dengan pesan penjangkauan personal opsional.
get_profile	Cari dan perkaya satu orang berdasarkan slug LinkedIn atau email (pengungkapan kontak, penyegaran waktu nyata, pengayaan GitHub).
get_user_info	Info pengguna terautentikasi: email, kredit tersisa, paket harga. Gratis.

Filter terstruktur kustom (custom_filters / search_requirements) sengaja tidak diekspos — jelaskan semuanya dalam kueri bahasa alami.

Server jarak jauh (disarankan)

Server yang dihosting berada di https://mcp.pearch.ai/mcp dan mendukung dua skema autentikasi sekaligus:

OAuth (tanpa penanganan kunci)

Tambahkan server tanpa header apa pun — klien yang mendukung OAuth (Claude, Cursor, VS Code) menemukan alur secara otomatis dan membuka masuk Google. Masuk dengan akun Google yang emailnya cocok dengan akun Pearch Anda:

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

Pencarian Anda membebankan kredit ke akun Pearch Anda sendiri. Jika akun Pearch Anda belum memiliki kunci API, buat dulu di Dasbor Pearch.ai.

Kunci API

Berikan kunci API Pearch yang sama sebagai api.pearch.ai:

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

Gunakan test_mcp_key untuk hasil (contoh) yang disamarkan — tanpa perlu mendaftar.

Instalasi lokal (stdio)

Membutuhkan Python 3.10+ dan pip install -r requirements.txt (atau pip install fastmcp).

Claude Desktop / Claude Code

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

Atau secara manual di bawah mcpServers:

"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

Ganti test_mcp_key dengan kunci dasbor Anda untuk hasil lengkap.

Menjalankan server HTTP Anda sendiri

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

Kesehatan: GET /health atau /healthcheck (melaporkan mode autentikasi).

Variabel lingkungan

Variabel	Default	Tujuan
`PEARCH_MCP_AUTH`	`api_key`	`oauth` \| `api_key` \| `none`. Dalam mode `oauth`, pembawa kunci API mentah masih diterima (autentikasi ganda).
`PEARCH_MCP_BASE_URL`	`http://localhost:8000`	URL publik server ini. Metadata OAuth, audiens token, dan URI pengalihan `/auth/callback` semuanya berasal dari sini.
`PEARCH_MCP_GOOGLE_CLIENT_ID` / `PEARCH_MCP_GOOGLE_CLIENT_SECRET`	—	Klien aplikasi Web Google OAuth 2.0 (daftarkan `<base_url>/auth/callback` sebagai URI pengalihan). Diperlukan dalam mode `oauth`.
`PEARCH_MCP_INTERNAL_TOKEN`	—	Rahasia bersama untuk titik akhir pemetaan email→kunci API internal Pearch API. Diperlukan dalam mode `oauth`.
`PEARCH_MCP_OAUTH_STORE`	`disk`	`redis` menyimpan status OAuth (registrasi klien, token — terenkripsi) di Redis sehingga bertahan dari mulai ulang dan memungkinkan >1 replika.
`PEARCH_MCP_OAUTH_REDIS_HOST` / `REDIS_ENDPOINT`, `REDIS_PORT`, `PEARCH_MCP_OAUTH_REDIS_DB`, `REDIS_PASSWORD`	—, `6379`, `4`, —	Koneksi Redis untuk penyimpanan OAuth.
`PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS`	daftar bawaan	Pola fnmatch yang dipisahkan koma untuk URI pengalihan klien MCP (`*` = apa pun).
`PEARCH_MCP_TOKEN_CACHE_TTL_S`	`300`	TTL cache identitas terverifikasi; juga jeda pencabutan.
`PEARCH_API_URL`	`https://api.pearch.ai`	Basis API Pearch (`base_url` per panggilan menimpanya).
`PEARCH_API_KEY`	`test_mcp_key`	Kunci cadangan untuk penggunaan stdio/lokal.
`MCP_DISABLE_AUTH`	—	`1` setara dengan `PEARCH_MCP_AUTH=none` (khusus pengembangan lokal).

Dalam mode oauth, ingress/proxy terbalik harus merutekan seluruh host ke server, bukan hanya /mcp: alur menambahkan /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent, dan /auth/callback.

Pengembangan

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

Kebijakan Privasi

Kebijakan privasi Pearch.AI: https://pearch.ai/privacy-policy — mencakup pengumpulan data, penggunaan, penyimpanan, berbagi pihak ketiga, retensi, dan informasi kontak. Penghapusan data / opt-out: https://pearch.ai/opt-out. Ketentuan layanan: https://pearch.ai/tos.

Dukungan

Lisensi

MIT — lihat LISENSI.