Que fait herohunt-mcp ?
Serveur MCP pour l'API HeroHunt People Search. Recherchez des talents sur LinkedIn, GitHub et StackOverflow depuis n'importe quel agent IA compatible MCP.
Démarrage rapide
Option 1 : URL distante (recommandée)
Claude Desktop, Cursor et la plupart des clients MCP modernes prennent en charge les points de terminaison HTTP distants directement. Aucune installation de package nécessaire.
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) :
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Cursor (~/.cursor/mcp.json) :
{
"mcpServers": {
"herohunt-people-search": {
"url": "https://api.herohunt.ai/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Option 2 : stdio (via npx)
Pour les clients MCP qui ne prennent en charge que le transport stdio :
{
"mcpServers": {
"herohunt-people-search": {
"command": "npx",
"args": ["-y", "herohunt-mcp"],
"env": {
"HEROHUNT_API_KEY": "YOUR_API_KEY"
}
}
}
}
Obtenir votre clé API
Inscrivez-vous sur herohunt.ai/app/api/sign-up pour obtenir votre clé API.
Outils
| Outil | Type | Description |
|---|---|---|
people_search | Écriture | Rechercher des profils de personnes en langage naturel. 1 crédit par emplacement réservé. |
people_search_paginate | Lecture | Obtenir plus de résultats pour une recherche existante. Gratuit sauf si l'enrichissement est activé. |
account_usage_get | Lecture | Obtenir les informations sur le forfait, les crédits, les limites de débit. Gratuit. |
account_searches_list | Lecture | Lister les recherches passées. Gratuit. |
account_upgrade_link | Lecture | Obtenir l'URL de mise à niveau du forfait. Gratuit. |
account_billing_portal_link | Lecture | Obtenir l'URL du portail de facturation Stripe. Gratuit. |
api_keys_list | Lecture | Lister les préfixes et les périmètres des clés API. Gratuit. |
api_keys_create | Écriture | Créer une nouvelle clé API. |
api_keys_rotate | Écriture | Pivoter une clé API existante. |
api_keys_revoke | Écriture | Révoquer définitivement une clé API. |
Exemple
Après connexion, demandez à votre agent IA :
"Utilise HeroHunt pour me trouver 5 ingénieurs Go seniors à Berlin et résume les 3 meilleurs."
L'agent appellera people_search avec une requête en langage naturel, recevra des données de profil structurées (nom, titre, entreprise, localisation, compétences, liens vers les plateformes) et résumera les résultats.
Pour obtenir des informations de contact, demandez :
"Enrichis les résultats avec les emails et les numéros de téléphone."
L'agent appellera people_search_paginate avec enrich: true.
Variables d'environnement
| Variable | Requise | Défaut | Description |
|---|---|---|---|
HEROHUNT_API_KEY | Oui | - | Votre clé API People Search |
HEROHUNT_MCP_URL | Non | https://api.herohunt.ai/api/v1/mcp | Remplacer l'URL du point de terminaison MCP |
Liens
Licence
MIT