Pearch

Pearch.ai MCP

Servidor MCP para Pearch.AI: búsqueda en lenguaje natural sobre personas y empresas/contactos (B2B). Úsalo desde Claude, Cursor, VS Code o cualquier cliente compatible con MCP.

Evaluación de herramientas de sourcing de reclutamiento con IA mediante preferencia humana

Herramientas

Herramienta	Descripción
search_people	Búsqueda de personas en lenguaje natural (p. ej. "ingenieros de software en California con más de 5 años de Python"). Admite tipos de búsqueda rápida/pro/súper rápida, revelación de contactos y filtros de contacto, actualización de perfiles en tiempo real, información y paginación/seguimientos basados en hilos.
search_company_leads	Encuentra empresas y contactos dentro de ellas (B2B). Ejemplo: empresa "startups de IA en San Francisco, 50–200 empleados" + contactos "CTOs y gerentes de ingeniería", con mensajes de divulgación personalizados opcionales.
get_profile	Busca y enriquece a una sola persona mediante el slug de LinkedIn o el correo electrónico (revelación de contacto, actualización en tiempo real, enriquecimiento de GitHub).
get_user_info	Información del usuario autenticado: correo electrónico, créditos restantes, plan de precios. Gratis.

Los filtros estructurados personalizados (custom_filters / search_requirements) no se exponen intencionalmente: describe todo en la consulta en lenguaje natural.

Servidor remoto (recomendado)

El servidor alojado está en https://mcp.pearch.ai/mcp y admite dos esquemas de autenticación a la vez:

OAuth (sin gestión de claves)

Agrega el servidor sin encabezados: los clientes compatibles con OAuth (Claude, Cursor, VS Code) descubren el flujo automáticamente y abren un inicio de sesión de Google. Inicia sesión con la cuenta de Google cuyo correo coincida con tu cuenta de Pearch:

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

Tus búsquedas se facturan con créditos de tu propia cuenta de Pearch. Si tu cuenta de Pearch aún no tiene clave API, créala primero en el Panel de Pearch.ai.

Clave API

Pasa la misma clave API de Pearch como api.pearch.ai:

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

Usa test_mcp_key para resultados enmascarados (de muestra) — sin necesidad de registro.

Instalación local (stdio)

Requiere Python 3.10+ y pip install -r requirements.txt (o pip install fastmcp).

Claude Desktop / Claude Code

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

O manualmente en 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

Reemplaza test_mcp_key con tu clave del panel para obtener resultados completos.

Ejecutar tu propio servidor HTTP

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

Salud: GET /health o /healthcheck (informa el modo de autenticación).

Variables de entorno

Variable	Predeterminado	Propósito
PEARCH_MCP_AUTH	api_key	oauth | api_key | none. En modo oauth, los portadores de clave API sin procesar también se aceptan (autenticación dual).
PEARCH_MCP_BASE_URL	http://localhost:8000	URL pública de este servidor. Los metadatos de OAuth, la audiencia del token y el URI de redirección /auth/callback se derivan de ella.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Cliente de aplicación web de Google OAuth 2.0 (registra <base_url>/auth/callback como URI de redirección). Requerido en modo oauth.
PEARCH_MCP_INTERNAL_TOKEN	—	Secreto compartido para el endpoint interno de mapeo correo→clave API de la API de Pearch. Requerido en modo oauth.
PEARCH_MCP_OAUTH_STORE	disk	redis mantiene el estado de OAuth (registros de clientes, tokens — cifrados) en Redis para que sobreviva a reinicios y permita más de 1 réplica.
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	Conexión Redis para el almacén de OAuth.
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	lista integrada	Patrones fnmatch separados por comas para los URI de redirección de clientes MCP (* = cualquiera).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL de caché de identidad verificada; también el retraso de revocación.
PEARCH_API_URL	https://api.pearch.ai	Base de la API de Pearch (los base_url por llamada la anulan).
PEARCH_API_KEY	test_mcp_key	Clave de respaldo para uso local/stdio.
MCP_DISABLE_AUTH	—	1 es equivalente a PEARCH_MCP_AUTH=none (solo desarrollo local).

En modo oauth, el ingreso/proxy inverso debe enrutar el host completo al servidor, no solo /mcp: el flujo agrega /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent y /auth/callback.

Desarrollo

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

Política de privacidad

La política de privacidad de Pearch.AI: https://pearch.ai/privacy-policy — cubre la recopilación de datos, el uso, el almacenamiento, el intercambio con terceros, la retención y la información de contacto. Eliminación de datos / exclusión: https://pearch.ai/opt-out. Términos de servicio: https://pearch.ai/tos.

Soporte

• Abrir un problema
• f@pearch.ai

Licencia

MIT — consulta LICENCIA.