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.
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.
Évaluer
Récupérez le profil complet — biographie, services avec tarifs, disponibilités hebdomadaires et tous les canaux de contact publics.
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_config.json
{
"mcpServers": {
"expert-sapiens": {
"url": "https://expertsapiens.com/api/mcp"
}
}
}// claude_desktop_config.json — with API key (enables submit_inquiry)
{
"mcpServers": {
"expert-sapiens": {
"url": "https://expertsapiens.com/api/mcp",
"headers": {
"Authorization": "Bearer es_live_..."
}
}
}
}// .cursor/mcp.json
{
"mcpServers": {
"expert-sapiens": {
"url": "https://expertsapiens.com/api/mcp",
"headers": {
"Authorization": "Bearer es_live_..."
}
}
}
}// 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, get_expert, search_properties et get_property fonctionnent sans clé API. submit_inquiry, save_property, set_property_price_alert et list_my_saved_properties nécessitent un jeton Bearer. Générer une clé →
Outils MCP
Huit outils exposés par le serveur MCP sur /api/mcp : trois pour les experts et cinq pour les annonces immobilières SeoulHomes.
search_expertsAucune auth requiseRecherchez 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 taglinecategorystring?juridique · comptabilité · immigration · finance · ...countrystring?ISO 3166-1 alpha-2 (ex. US, KR)languagestring?Code BCP 47 de la langue parlée par l'expertaccepting_onlyboolean?Uniquement les experts acceptant de nouveaux clientslimitnumber?Résultats max (défaut 10, max 20)get_expertAucune auth requiseProfil 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 recherchelocalestring?Langue de la bio/titre traduit (en · ko · ja · zh · fr · de)search_propertiesAucune auth requiseRecherche des annonces SeoulHomes à Séoul et dans sa région par type de transaction, type de bien, arrondissement, prix, surface et équipements. Renvoie les URL des annonces, les prix, la surface, l’emplacement et l’agent de l’annonce.
qstring?Mot-clé dans le titre, le nom de l’immeuble, le quartierlisting_typestring?rent · jeonse · sale · short_term · lump_sumtypestring?officetel · apartment · villa · house · studiodistrictstring?Arrondissement (gu) de Séoul, en coréen ou romanisé (강남구, gangnam)neighborhoodstring?Nom du quartier (correspondance partielle)min_pricenumber?Minimum en KRW (prix de vente, ou dépôt pour location/jeonse)max_pricenumber?Maximum en KRW (prix de vente, ou dépôt pour location/jeonse)min_areanumber?Surface minimale en m²max_areanumber?Surface maximale en m²roomsnumber?Nombre minimal de chambrespetboolean?Annonces acceptant les animaux uniquementparkingboolean?Annonces avec parking uniquementlocalestring?Langue du texte traduit (en · ko · zh · ja · ru · vi · uz)sortstring?newest · price_asc · price_desclimitnumber?Résultats max (défaut 10, max 20)get_propertyAucune auth requiseDétail complet d’une annonce : description, prix détaillés, caractéristiques, équipements, fiche de l’immeuble, photos et agent de l’annonce.
slugstringSlug de l’annonce issu de search_properties ou de l’URL de l’annoncelocalestring?Langue du texte traduit (en · ko · zh · ja · ru · vi · uz)submit_inquiryClé API requiseEnvoie une demande à un expert au nom de votre utilisateur, ou à l’agent d’une annonce SeoulHomes en passant property_slug. Le destinataire est prévenu par e-mail et peut répondre directement. Limite par compte : 5 par expert et 20 au total par 24 h.
expert_slugstring?Slug de l’expert visé (inutile avec property_slug)property_slugstring?Slug d’une annonce SeoulHomes ; envoie à l’agent de cette annoncerequester_namestringNom de la personne représentéerequester_emailstringEmail auquel l'expert doit répondremessagestringLe message de demande (max 2000 caractères)contextobject?Métadonnées optionnelles (source, session_id, …)save_propertyClé API requiseEnregistre une annonce sur le compte SeoulHomes du titulaire de la clé, ou la retire.
property_slugstringSlug de l’annonce issu de search_properties ou de l’URL de l’annoncesaveboolean?true pour enregistrer (par défaut), false pour retirerset_property_price_alertClé API requiseActive ou désactive les alertes de changement de prix d’une annonce pour le titulaire de la clé.
property_slugstringSlug de l’annonce issu de search_properties ou de l’URL de l’annonceenabledbooleantrue pour activer les alertes, false pour les désactiverlist_my_saved_propertiesClé API requiseListe les annonces enregistrées du titulaire de la clé avec l’état de leurs alertes de prix.
localestring?Langue du texte traduit (en · ko · zh · ja · ru · vi · uz)API REST
Les mêmes fonctionnalités que le serveur MCP, disponibles en HTTP standard.
Spec complète : https://expertsapiens.com/api/openapi.json
/api/agents/expertsSans authRechercher des experts
curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"/api/agents/experts/{slug}Sans authProfil complet d'un expert
curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"/api/agents/inquiriesJeton BearerSoumettre 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. submit_inquiry est limité à 5 demandes par expert et 20 au total par 24 h et par compte, et les requêtes sont limitées par minute.
- 1. Connectez-vous ou créez un compte sur expertsapiens.com
- 2. Allez dans Tableau de bord → Compte → Clés API
- 3. Cliquez sur « Générer une clé » et nommez-la
- 4. Copiez la clé — elle n'est affichée qu'une seule fois