Pearch

Pearch.ai MCP

MCP server cho Pearch.AI: tìm kiếm ngôn ngữ tự nhiên trên con 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ỳ client tương thích MCP nào.

Đánh giá Công cụ Tuyển dụng AI Sourcing theo Sở thích Con người

Công cụ

Công cụ	Mô tả
search_people	Tìm kiếm con người bằng ngôn ngữ tự nhiên (ví dụ "kỹ sư phần mềm ở California với 5+ năm kinh nghiệm Python"). Hỗ trợ các loại tìm kiếm nhanh/pro/siêu nhanh, tiết lộ liên hệ và bộ lọc liên hệ, làm mới hồ sơ theo thời gian thực, thông tin chi tiết, 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ông ty khởi nghiệp 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á nhân hóa tùy chọn.
get_profile	Tra cứu và làm phong phú một người duy nhất bằng slug LinkedIn hoặc email (tiết lộ liên hệ, làm mới theo thời gian thực, làm phong phú GitHub).
get_user_info	Thông tin người dùng đã xác thực: email, tín dụng còn lại, gói giá. Miễn phí.

Các bộ lọc có cấu trúc tùy chỉnh (custom_filters / search_requirements) cố ý không được hiển thị — hãy mô tả mọi thứ trong truy vấn ngôn ngữ tự nhiên.

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 sơ đồ 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ỳ header nào — các client hỗ trợ OAuth (Claude, Cursor, VS Code) 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 tính phí tín dụng vào tài khoản Pearch của riêng 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 làm 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ả mẫu (được che) — 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 dưới 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 sức khỏe: 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. Trong 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 bắt nguồn từ đó.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Client ứng dụng Web Google OAuth 2.0 (đăng ký <base_url>/auth/callback làm URI chuyển hướng). Bắt buộc trong chế độ oauth.
PEARCH_MCP_INTERNAL_TOKEN	—	Bí mật dùng chung cho điểm cuối ánh xạ email→khóa API nội bộ của Pearch API. Bắt buộc trong chế độ oauth.
PEARCH_MCP_OAUTH_STORE	disk	redis giữ trạng thái OAuth (đăng ký client, token — được mã hóa) trong Redis để 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 phân tách bằng dấu phẩy cho URI chuyển hướng của client MCP (* = bất kỳ).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL bộ nhớ cache danh tính đã xác minh; cũng là độ trễ thu hồi.
PEARCH_API_URL	https://api.pearch.ai	Cơ sở Pearch API (base_url trên mỗi lần gọi ghi đè).
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ỉ phát triển cục bộ).

Trong chế độ oauth, cổng vào/proxy ngược phải định tuyến toàn bộ máy chủ đến máy chủ, không chỉ /mcp: luồng 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.