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, 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 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)
search_propertiesAucune auth requise

Recherche 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 quartier
listing_typestring?rent · jeonse · sale · short_term · lump_sum
typestring?officetel · apartment · villa · house · studio
districtstring?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 chambres
petboolean?Annonces acceptant les animaux uniquement
parkingboolean?Annonces avec parking uniquement
localestring?Langue du texte traduit (en · ko · zh · ja · ru · vi · uz)
sortstring?newest · price_asc · price_desc
limitnumber?Résultats max (défaut 10, max 20)
get_propertyAucune auth requise

Dé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’annonce
localestring?Langue du texte traduit (en · ko · zh · ja · ru · vi · uz)
submit_inquiryClé API requise

Envoie 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 annonce
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, …)
save_propertyClé API requise

Enregistre 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’annonce
saveboolean?true pour enregistrer (par défaut), false pour retirer
set_property_price_alertClé API requise

Active 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’annonce
enabledbooleantrue pour activer les alertes, false pour les désactiver
list_my_saved_propertiesClé API requise

Liste 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

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. 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. 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