Saltar al contenido principal
Expert Sapiens · API para desarrolladores

Construya agentes IA que encuentren y contacten expertos humanos.

Expert Sapiens expone un servidor MCP nativo y API REST para que su agente IA pueda buscar profesionales verificados, leer perfiles completos y enviar consultas — todo sin ningún inicio de sesión de usuario.

Cómo funciona

Tres pasos. No se requiere inicio de sesión del usuario final.

1

Buscar

Consulte expertos por categoría, ubicación, idioma o palabra clave. Obtenga una lista clasificada con URLs de perfil y reserva.

2

Evaluar

Obtenga el perfil completo — biografía, servicios con precios, disponibilidad semanal y todos los canales de contacto públicos.

3

Contactar

Envíe una consulta en nombre de su usuario. El experto recibe una notificación por correo y responde directamente — sin fricción de plataforma.

Inicio rápido MCP

Añada Expert Sapiens como herramienta nativa a Claude, Cursor, Windsurf o cualquier host compatible con MCP. El servidor MCP está activo en https://expertsapiens.com/api/mcp.

Claude Desktop — solo lectura
// claude_desktop_config.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp"
    }
  }
}
Claude Desktop — con clave 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_..."
      }
    }
  }
}
Cursor / Windsurf
// .cursor/mcp.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
Puente 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 y get_expert funcionan sin clave API. submit_inquiry requiere un token Bearer. Generar una clave →

Herramientas MCP

Tres herramientas expuestas por el servidor MCP en /api/mcp y /api/sse.

search_expertsNo se requiere autenticación

Busque y filtre expertos verificados por categoría, ubicación, idioma o palabra clave. Devuelve una lista clasificada con URLs de perfil y enlaces de reserva.

qstring?Palabra clave en nombre, título, eslogan
categorystring?legal · contabilidad · inmigración · finanzas · ...
countrystring?ISO 3166-1 alpha-2 (ej. US, KR)
languagestring?Código BCP 47 que habla el experto
accepting_onlyboolean?Solo expertos que aceptan nuevos clientes
limitnumber?Máximo de resultados (predeterminado 10, máximo 20)
get_expertNo se requiere autenticación

Perfil completo de un único experto: biografía, servicios con precios, horario de disponibilidad semanal y todos los métodos de contacto públicos.

slugstringSlug único del experto de los resultados de búsqueda
localestring?Localización para biografía/título traducidos (en · ko · ja · zh · fr · de)
submit_inquirySe requiere clave API

Envíe una consulta a un experto específico en nombre de su usuario. El experto recibe una notificación por correo y puede responder directamente. Límite: 5 por experto cada 24 h.

expert_slugstringSlug del experto objetivo
requester_namestringNombre de la persona que representa
requester_emailstringCorreo al que el experto debe responder
messagestringEl mensaje de consulta (máx. 2000 caracteres)
contextobject?Metadatos opcionales (source, session_id, …)

API REST

Las mismas capacidades que el servidor MCP, disponibles como HTTP simple.

Especificación completa: https://expertsapiens.com/api/openapi.json

GET/api/agents/expertsSin auth

Buscar expertos

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

Perfil completo del experto

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

Enviar consulta al experto

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."
  }'

Obtener una clave API

Inicie sesión en Expert Sapiens, luego vaya a su panel para generar una clave API. Las claves son gratuitas y no tienen límite de velocidad excepto en submit_inquiry (5 por experto cada 24 h).

  1. 1. Inicie sesión o cree una cuenta en expertsapiens.com
  2. 2. Vaya a Panel → Cuenta → Claves API
  3. 3. Haga clic en "Generar clave" y nómbrela según su aplicación
  4. 4. Copie la clave — se muestra solo una vez