Pearch

Pearch.ai MCP

Serveur MCP pour Pearch.AI : recherche en langage naturel sur les personnes et les entreprises/pistes (B2B). Utilisez-le depuis Claude, Cursor, VS Code ou tout client compatible MCP.

Évaluation des outils de sourcing de recrutement IA par préférence humaine

Outils

Outil	Description
search_people	Recherche de personnes en langage naturel (par ex. "ingénieurs logiciels en Californie avec 5+ ans d'expérience Python"). Prend en charge les types de recherche rapide/pro/superrapide, la révélation de contacts et les filtres de contacts, l'actualisation de profil en temps réel, les informations et la pagination/relances basées sur les fils de discussion.
search_company_leads	Trouvez des entreprises et des pistes/contacts au sein de celles-ci (B2B). Exemple : entreprise "startups IA à SF, 50–200 employés" + pistes "CTO et responsables ingénierie", avec des messages de sensibilisation personnalisés facultatifs.
get_profile	Recherchez et enrichissez une seule personne par slug LinkedIn ou e-mail (révélation de contacts, actualisation en temps réel, enrichissement GitHub).
get_user_info	Informations sur l'utilisateur authentifié : e-mail, crédits restants, plan tarifaire. Gratuit.

Les filtres structurés personnalisés (custom_filters / search_requirements) ne sont volontairement pas exposés — décrivez tout dans la requête en langage naturel.

Serveur distant (recommandé)

Le serveur hébergé se trouve à https://mcp.pearch.ai/mcp et prend en charge deux schémas d'authentification à la fois :

OAuth (aucune gestion de clé)

Ajoutez le serveur sans aucun en-tête — les clients compatibles OAuth (Claude, Cursor, VS Code) découvrent le flux automatiquement et ouvrent une connexion Google. Connectez-vous avec le compte Google dont l'e-mail correspond à votre compte Pearch :

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

Vos recherches débitent des crédits sur votre propre compte Pearch. Si votre compte Pearch n'a pas encore de clé API, créez-en une d'abord dans le Tableau de bord Pearch.ai.

Clé API

Passez la même clé API Pearch comme api.pearch.ai :

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

Utilisez test_mcp_key pour des résultats masqués (échantillon) — aucune inscription requise.

Installation locale (stdio)

Nécessite Python 3.10+ et pip install -r requirements.txt (ou pip install fastmcp).

Claude Desktop / Claude Code

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

Ou manuellement sous 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

Remplacez test_mcp_key par votre clé du tableau de bord pour des résultats complets.

Exécution de votre propre serveur HTTP

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

Santé : GET /health ou /healthcheck (signale le mode d'authentification).

Variables d'environnement

Variable	Défaut	Objectif
PEARCH_MCP_AUTH	api_key	oauth | api_key | none. En mode oauth, les porteurs de clé API bruts sont toujours acceptés (double authentification).
PEARCH_MCP_BASE_URL	http://localhost:8000	URL publique de ce serveur. Les métadonnées OAuth, l'audience du jeton et l'URI de redirection /auth/callback en dérivent tous.
PEARCH_MCP_GOOGLE_CLIENT_ID / PEARCH_MCP_GOOGLE_CLIENT_SECRET	—	Client d'application Web Google OAuth 2.0 (enregistrez <base_url>/auth/callback comme URI de redirection). Requis en mode oauth.
PEARCH_MCP_INTERNAL_TOKEN	—	Secret partagé pour le point de terminaison interne de mappage e-mail→clé API de l'API Pearch. Requis en mode oauth.
PEARCH_MCP_OAUTH_STORE	disk	redis conserve l'état OAuth (enregistrements de clients, jetons — chiffrés) dans Redis afin qu'il survive aux redémarrages et permette >1 réplica.
PEARCH_MCP_OAUTH_REDIS_HOST / REDIS_ENDPOINT, REDIS_PORT, PEARCH_MCP_OAUTH_REDIS_DB, REDIS_PASSWORD	—, 6379, 4, —	Connexion Redis pour le stockage OAuth.
PEARCH_MCP_ALLOWED_CLIENT_REDIRECT_URIS	liste intégrée	Modèles fnmatch séparés par des virgules pour les URI de redirection des clients MCP (* = n'importe lequel).
PEARCH_MCP_TOKEN_CACHE_TTL_S	300	TTL du cache d'identité vérifiée ; également le délai de révocation.
PEARCH_API_URL	https://api.pearch.ai	Base de l'API Pearch (les base_url par appel sont prioritaires).
PEARCH_API_KEY	test_mcp_key	Clé de secours pour une utilisation stdio/locale.
MCP_DISABLE_AUTH	—	1 équivaut à PEARCH_MCP_AUTH=none (développement local uniquement).

En mode oauth, l'ingress/proxy inverse doit router tout l'hôte vers le serveur, pas seulement /mcp : le flux ajoute /.well-known/oauth-*, /authorize, /token, /register, /revoke, /consent et /auth/callback.

Développement

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

Politique de confidentialité

Politique de confidentialité de Pearch.AI : https://pearch.ai/privacy-policy — couvre la collecte de données, l'utilisation, le stockage, le partage avec des tiers, la conservation et les coordonnées. Suppression de données / désinscription : https://pearch.ai/opt-out. Conditions d'utilisation : https://pearch.ai/tos.

Support

• Ouvrir un problème
• f@pearch.ai

Licence

MIT — voir LICENCE.