Pearch

Pearch.ai MCP

Máy chủ MCP cho Pearch.AI: tìm kiếm bằng ngôn ngữ tự nhiên trên người và công ty/khách hàng tiềm năng (B2B). Sử dụng từ Claude, Cursor, VS Code hoặc bất kỳ ứng dụng khách tương thích MCP nào.

Đánh giá các công cụ tìm nguồn tuyển dụng AI theo sở thích của con người

Công cụ

Công cụ	Mô tả
search_people	Tìm kiếm người với query bằng ngôn ngữ tự nhiên hoặc search_requirements có cấu trúc. Hỗ trợ các loại tìm kiếm fast/pro/superfast, hiển thị thông tin liên hệ & bộ lọc liên hệ, làm mới hồ sơ theo thời gian thực, thông tin chuyên sâu, và phân trang/theo dõi dựa trên luồng.
search_company_leads	Tìm công ty và khách hàng tiềm năng/liên hệ trong đó (B2B). Ví dụ: công ty "các startup AI ở SF, 50–200 nhân viên" + khách hàng tiềm năng "CTO và quản lý kỹ thuật", với tin nhắn tiếp cận được cá nhân hóa tùy chọn.
get_profile	Tra cứu và làm phong phú hồ sơ của một người bằng slug LinkedIn hoặc email (hiển thị thông tin liên hệ, làm mới theo thời gian thực, làm phong phú từ GitHub).
get_user_info	Thông tin người dùng đã xác thực: email, số tín dụng còn lại, gói giá. Miễn phí.

Tìm kiếm người có cấu trúc

Truyền search_requirements cho search_people khi bạn đã có danh sách tiêu chí:

{
  "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: bắt buộc, văn bản không được rỗng. Giữ mỗi tiêu chí ngắn gọn và độc lập.
• must_have: true cho các tiêu chí bắt buộc, false cho các tùy chọn mong muốn (mặc định).

Danh sách phải chứa ít nhất một yêu cầu. query là tùy chọn khi sử dụng search_requirements; nếu cả hai được cung cấp, API sẽ ưu tiên search_requirements. Xem hợp đồng API tìm kiếm Pearch.

Cả hai đầu vào đều hỗ trợ cùng các tùy chọn tìm kiếm: loại tìm kiếm, thông tin chuyên sâu và chấm điểm, làm mới hồ sơ, hiển thị thông tin liên hệ và bộ lọc, lọc nghiêm ngặt, kết quả có độ tin cậy thấp, giới hạn thời gian, phân trang, trường phản hồi, loại trừ hồ sơ, và kết quả ẩn miễn phí. Các hạn chế về loại tìm kiếm là giống nhau cho cả hai đầu vào; ví dụ: superfast không hỗ trợ thông tin chuyên sâu, chấm điểm hồ sơ hoặc độ mới cao.

Để phân trang, gửi thread_id được trả về cùng với limit và tùy chọn offset, bỏ qua query và search_requirements. Để thay đổi tiêu chí, hãy bắt đầu tìm kiếm mới mà không có thread_id. Các lệnh gọi query hiện có và theo dõi luồng vẫn được chuyển tiếp như trước; API quyết định các tham số theo dõi nào nó chấp nhận.

custom_filters không được máy chủ MCP này hiển thị. Thay vào đó, hãy diễn đạt tiêu chí trong query hoặc search_requirements.

Máy chủ từ xa (khuyến nghị)

Máy chủ được lưu trữ tại https://mcp.pearch.ai/mcp và hỗ trợ hai phương thức xác thực cùng lúc:

OAuth (không cần xử lý khóa)

Thêm máy chủ mà không cần bất kỳ tiêu đề nào — các ứng dụng khách hỗ trợ OAuth (Claude, Cursor, VS Code) sẽ tự động khám phá luồng và mở đăng nhập Google. Đăng nhập bằng tài khoản Google có email khớp với tài khoản Pearch của bạn:

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

Các tìm kiếm của bạn sẽ tính tín dụng vào tài khoản Pearch của chính bạn. Nếu tài khoản Pearch của bạn chưa có khóa API, hãy tạo một khóa trước trong Bảng điều khiển Pearch.ai.

Khóa API

Truyền cùng khóa API Pearch dưới dạng api.pearch.ai:

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

Sử dụng test_mcp_key cho kết quả ẩn (mẫu) — không cần đăng ký.

Cài đặt cục bộ (stdio)

Yêu cầu Python 3.10+ và pip install -r requirements.txt (hoặc pip install fastmcp).

Claude Desktop / Claude Code

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

Hoặc thủ công trong 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

Thay thế test_mcp_key bằng khóa bảng điều khiển của bạn để có kết quả đầy đủ.

Chạy máy chủ HTTP của riêng bạn

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

Kiểm tra tình trạng: GET /health hoặc /healthcheck (báo cáo chế độ xác thực).

Biến môi trường

Biến	Mặc định	Mục đích
PEARCH_MCP_AUTH	api_key	oauth | api_key | none. Ở chế độ oauth, các bearer khóa API thô vẫn được chấp nhận (xác thực kép).
PEARCH_MCP_BASE_URL	http://localhost:8000	URL công khai của máy chủ này. Siêu dữ liệu OAuth, đối tượng token và URI chuyển hướng /auth/callback đều được suy ra từ nó.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Ứng dụng khách Google OAuth 2.0 Web (đăng ký <base_url>/auth/callback làm URI chuyển hướng). Bắt buộc ở chế độ oauth.
PEARCH_MCP_INTERNAL_TOKEN	—	Bí mật chia sẻ cho ánh xạ email→khóa API nội bộ và ký nguồn yêu cầu. Bắt buộc ở chế độ oauth và để có thuộc tính MCP đã xác minh với khóa API. Phải khớp với MCP_INTERNAL_TOKEN của backend; không bao giờ phân phối cho người dùng cuối.
PEARCH_MCP_OAUTH_STORE	disk	redis giữ trạng thái OAuth (đăng ký ứng dụng khách, token — được mã hóa) trong Redis để nó tồn tại qua các lần khởi động lại và cho phép >1 bản sao.
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	Kết nối Redis cho kho lưu trữ OAuth.
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	danh sách tích hợp	Các mẫu fnmatch được phân tách bằng dấu phẩy cho URI chuyển hướng của ứng dụng khách MCP (* = bất kỳ).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL bộ nhớ đệm danh tính đã xác minh; cũng là độ trễ thu hồi.
PEARCH_API_URL	https://api.pearch.ai	Cơ sở API Pearch (ghi đè base_url theo từng lệnh gọi).
PEARCH_API_KEY	test_mcp_key	Khóa dự phòng cho sử dụng stdio/cục bộ.
MCP_DISABLE_AUTH	—	1 tương đương với PEARCH_MCP_AUTH=none (chỉ dành cho phát triển cục bộ).

Các yêu cầu công cụ đến API Pearch bao gồm X-Pearch-Source: mcp trên cả lệnh gọi POST và GET, bao gồm tìm kiếm người, tìm kiếm khách hàng tiềm năng công ty, phân trang và làm phong phú hồ sơ. Máy chủ được lưu trữ cũng gửi X-Pearch-Source-Signature khi bí mật nội bộ được cấu hình và nguồn đích khớp với PEARCH_API_URL. HMAC ràng buộc thông tin xác thực bearer, phương thức, đường dẫn đã giải mã cùng với truy vấn thô, nội dung và dấu thời gian. Backend chấp nhận chữ ký trong vòng 300 giây, vì vậy đồng hồ máy chủ phải được đồng bộ hóa. Các giá trị base_url do người gọi cung cấp trên các nguồn gốc khác không nhận được chữ ký.

Backend ghi lại lưu lượng MCP đã xác minh dưới dạng api_calls.request_source cho phân tích và lịch sử DevAdmin. Chỉ có tiêu đề nguồn thô là không đủ. Lưu lượng MCP tự lưu trữ không được ký sử dụng khóa API vẫn là api; các ứng dụng khách OAuth trong danh sách cho phép đã xác thực được nhận diện mà không cần tiêu đề. Triển khai ký trước khi bật ghi nhật ký nguồn backend, sau khi áp dụng di chuyển cơ sở dữ liệu của nó. Các backend cũ hơn bỏ qua các tiêu đề. Xác thực, thuộc tính tài khoản và thanh toán không thay đổi.

Ở chế độ oauth, ingress/proxy ngược phải định tuyến toàn bộ máy chủ đến máy chủ, không chỉ /mcp: luồng này thêm /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent và /auth/callback.

Phát triển

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

Chính sách quyền riêng tư

Chính sách quyền riêng tư của Pearch.AI: https://pearch.ai/privacy-policy — bao gồm thu thập dữ liệu, sử dụng, lưu trữ, chia sẻ với bên thứ ba, lưu giữ và thông tin liên hệ. Xóa dữ liệu / từ chối: https://pearch.ai/opt-out. Điều khoản dịch vụ: https://pearch.ai/tos.

Hỗ trợ

• Mở một vấn đề
• f@pearch.ai

Giấy phép

MIT — xem LICENSE.