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ừ Cursor, Claude Desktop, VS Code, hoặc bất kỳ ứng dụng khách tương thích MCP nào.

Đánh giá Công cụ Tìm kiếm Tuyển dụng AI theo Sở thích của Con người

Tính năng

• search_people — tìm kiếm người bằng ngôn ngữ tự nhiên (ví dụ: “kỹ sư phần mềm ở California với hơn 5 năm kinh nghiệm Python”); trả về ứng viên kèm thông tin chi tiết tùy chọn và chấm điểm hồ sơ.
• search_company_leads — tìm công ty và khách hàng tiềm năng/liên hệ trong đó (B2B); ví dụ: “startup AI ở SF, 50–200 nhân viên” + “CTO và quản lý kỹ thuật”.
• Khóa kiểm tra mặc định — hoạt động ngay với test_mcp_key (kết quả bị che/mẫu); đặt khóa của riêng bạn để có kết quả đầy đủ.

Điều kiện tiên quyết

• Python 3.10+
• uv (khuyến nghị; Linux/macOS: curl -LsSf https://astral.sh/uv/install.sh | sh) hoặc pip
• FastMCP — cài đặt với pip install fastmcp hoặc uv add fastmcp

Khóa API

Sử dụng test_mcp_key để có kết quả bị che (mẫu) — không cần đăng ký.

Để có kết quả đầy đủ, không bị che, lấy khóa API từ Bảng điều khiển Pearch.ai và đặt thành PEARCH_API_KEY trong cấu hình MCP của bạn (xem phần Cài đặt bên dưới).

Cài đặt

Sao chép kho lưu trữ, sau đó làm theo các bước cho ứng dụng khách của bạn:

git clone https://github.com/Pearch-ai/mcp_pearch
cd mcp_pearch

Claude Desktop

Tự động:

fastmcp install claude-desktop 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 đủ.

Nếu bạn thấy bad interpreter: No such file or directory (ví dụ: với conda), chạy:

pip install --force-reinstall fastmcp

hoặc:

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

Thủ công: chỉnh sửa ~/.claude/claude_desktop_config.json và thêm vào mục mcpServers. Thay thế /path/to/mcp_pearch bằng đường dẫn thực tế của bạn.

Với uv:

"Pearch.ai": {
  "command": "uv",
  "args": ["run", "--with", "fastmcp", "fastmcp", "run", "/path/to/mcp_pearch/pearch_mcp.py"],
  "env": { "PEARCH_API_KEY": "test_mcp_key" }
}

Với pip/conda (không có uv):

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

Đảm bảo fastmcp đã được cài đặt: pip install fastmcp.

Cursor

Khuyến nghị (tự động):

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 đủ.

Thủ công: thêm vào ~/.cursor/mcp.json (hoặc dự án .cursor/mcp.json):

{
  "mcpServers": {
    "Pearch.ai": {
      "command": "uv",
      "args": ["run", "--with", "fastmcp", "fastmcp", "run", "/absolute/path/to/pearch_mcp.py"],
      "env": { "PEARCH_API_KEY": "test_mcp_key" }
    }
  }
}

Thay thế /absolute/path/to/pearch_mcp.py bằng đường dẫn thực tế. Sử dụng test_mcp_key cho kết quả bị che, hoặc khóa bảng điều khiển của bạn cho kết quả đầy đủ.

Để tạo đoạn mã sẵn sàng:

fastmcp install mcp-json pearch_mcp.py --name "Pearch.ai"

Sau đó dán đầu ra vào mcpServers trong ~/.cursor/mcp.json.

VS Code và các ứng dụng khách khác

• VS Code: thêm cùng khối mcpServers vào .vscode/mcp.json trong không gian làm việc của bạn.
• Các ứng dụng khách MCP khác: sử dụng cùng định dạng command / args / env trong cấu hình MCP của ứng dụng khách.

Tạo đoạn mã cấu hình (mặc định là test_mcp_key; thêm --env PEARCH_API_KEY=your-key để có kết quả đầy đủ):

fastmcp install mcp-json pearch_mcp.py --name "Pearch.ai"

Dán đối tượng đã tạo vào mcpServers của ứng dụng khách.

Công cụ

Công cụ	Mô tả
search_people	Tìm kiếm người bằng ngôn ngữ tự nhiên hoặc theo dõi một chuỗi hội thoại. Ví dụ: "kỹ sư phần mềm ở California với hơn 5 năm Python", "nhà nghiên cứu ML cấp cao ở Berlin".
search_company_leads	Tìm công ty và khách hàng tiềm năng/liên hệ (B2B). Ví dụ: công ty "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".

URL cơ sở: PEARCH_API_URL hoặc mỗi lần gọi base_url (mặc định https://api.pearch.ai).

HTTP từ xa (Kubernetes / URL Cursor)

Máy chủ hiển thị HTTP có thể truyền trực tuyến tại /mcp khi chạy với Uvicorn:

export PEARCH_API_URL='https://api.pearch.ai'   # optional
uvicorn pearch_mcp:app --host 0.0.0.0 --port 8000

Kiểm tra tình trạng: GET /health hoặc /healthcheck.

Truy cập từ xa sử dụng cùng khóa API Pearch như api.pearch.ai (Authorization: Bearer). Máy chủ xác thực khóa qua GET /v1/user. Khóa demo test_mcp_key cũng được chấp nhận (kết quả bị che).

Cursor ~/.cursor/mcp.json:

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

Phát triển

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

Hỗ trợ

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

Giấy phép

MIT — xem LICENSE.