Passer au contenu principal
Expert Sapiens · API Développeur

Créez des agents IA qui trouvent et contactent des experts humains.

Expert Sapiens expose un serveur MCP natif et une API REST pour que votre agent IA puisse rechercher des professionnels vérifiés, lire des profils complets et envoyer des demandes — sans connexion utilisateur.

Comment ça marche

Trois étapes. Aucune connexion requise côté utilisateur final.

1

Rechercher

Interrogez des experts par catégorie, lieu, langue ou mot-clé. Obtenez une liste classée avec URLs de profil et liens de réservation.

2

Évaluer

Récupérez le profil complet — biographie, services avec tarifs, disponibilités hebdomadaires et tous les canaux de contact publics.

3

Contacter

Soumettez une demande au nom de votre utilisateur. L'expert est notifié par email et répond directement — sans friction de plateforme.

Démarrage rapide MCP

Ajoutez Expert Sapiens comme outil natif à Claude, Cursor, Windsurf ou tout hôte compatible MCP. Le serveur MCP est disponible à https://expertsapiens.com/api/mcp.

Claude Desktop — lecture seule
// claude_desktop_config.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp"
    }
  }
}
Claude Desktop — avec clé API
// claude_desktop_config.json — with API key (enables submit_inquiry)
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
Curseur / Planche à voile
// .cursor/mcp.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
Pont stdio (mcp-remote)
// For stdio-only clients — bridges remote MCP via npx
{
  "mcpServers": {
    "expert-sapiens": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://expertsapiens.com/api/mcp"]
    }
  }
}

search_experts et get_expert fonctionnent sans clé API. submit_inquiry nécessite un Bearer token. Générer une clé →

Outils MCP

Trois outils exposés par le serveur MCP sur /api/mcp et /api/sse.

search_expertsAucune auth requise

Recherchez et filtrez des experts vérifiés par catégorie, lieu, langue ou mot-clé. Retourne une liste classée avec URLs de profil et liens de réservation.

qstring?Mot-clé sur le nom, le titre, le tagline
categorystring?juridique · comptabilité · immigration · finance · ...
countrystring?ISO 3166-1 alpha-2 (ex. US, KR)
languagestring?Code BCP 47 de la langue parlée par l'expert
accepting_onlyboolean?Uniquement les experts acceptant de nouveaux clients
limitnumber?Résultats max (défaut 10, max 20)
get_expertAucune auth requise

Profil complet d'un expert : biographie, services avec tarifs, planning hebdomadaire et tous les moyens de contact publics.

slugstringSlug unique de l'expert dans les résultats de recherche
localestring?Langue de la bio/titre traduit (en · ko · ja · zh · fr · de)
submit_inquiryClé API requise

Envoyez une demande à un expert spécifique au nom de votre utilisateur. L'expert est notifié par email et peut répondre directement. Limite : 5 par expert par 24 h.

expert_slugstringSlug de l'expert cible
requester_namestringNom de la personne représentée
requester_emailstringEmail auquel l'expert doit répondre
messagestringLe message de demande (max 2000 caractères)
contextobject?Métadonnées optionnelles (source, session_id, …)

API REST

Les mêmes fonctionnalités que le serveur MCP, disponibles en HTTP standard.

Spec complète : https://expertsapiens.com/api/openapi.json

GET/api/agents/expertsSans auth

Rechercher des experts

curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"
GET/api/agents/experts/{slug}Sans auth

Profil complet d'un expert

curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"
POST/api/agents/inquiriesJeton Bearer

Soumettre une demande à un expert

curl -X POST "https://expertsapiens.com/api/agents/inquiries" \
  -H "Authorization: Bearer es_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "expert_slug": "james-chae",
    "requester_name": "Sarah Kim",
    "requester_email": "[email protected]",
    "message": "I need advice on a US-Korea cross-border acquisition."
  }'

Obtenir une clé API

Connectez-vous à Expert Sapiens, puis accédez à votre tableau de bord pour générer une clé API. Les clés sont gratuites et sans limite de débit sauf pour submit_inquiry (5 par expert par 24 h).

  1. 1. Connectez-vous ou créez un compte sur expertsapiens.com
  2. 2. Allez dans Tableau de bord → Compte → Clés API
  3. 3. Cliquez sur « Générer une clé » et nommez-la
  4. 4. Copiez la clé — elle n'est affichée qu'une seule fois