Перейти к основному содержимому
Expert Sapiens · API для разработчиков

Создавайте ИИ-агентов, которые находят экспертов-людей и связываются с ними.

Expert Sapiens предоставляет нативный MCP-сервер и REST API, чтобы ваш ИИ-агент мог искать верифицированных специалистов, читать полные профили и отправлять запросы — без входа пользователя.

Как это работает

Три шага. Вход пользователя не требуется.

1

Поиск

Запрашивайте экспертов по категории, местоположению, языку или ключевому слову. Получайте ранжированный список с URL профилей и бронирований.

2

Оценка

Загружайте полный профиль — биографию, услуги с ценами, еженедельную доступность и все публичные каналы связи.

3

Связь

Отправляйте запрос от имени пользователя. Эксперт получает уведомление по email и отвечает напрямую — без платформенного трения.

Быстрый старт MCP

Добавьте Expert Sapiens как нативный инструмент в Claude, Cursor, Windsurf или любой MCP-совместимый хост. MCP-сервер работает по адресу https://expertsapiens.com/api/mcp.

Claude Desktop — только чтение
// claude_desktop_config.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp"
    }
  }
}
Claude Desktop — с 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/mcp.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
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 работают без API-ключа. submit_inquiry требует Bearer-токена. Создать ключ →

Инструменты MCP

Три инструмента, предоставляемых MCP-сервером на /api/mcp и /api/sse.

search_expertsАутентификация не требуется

Поиск и фильтрация верифицированных экспертов по категории, местоположению, языку или ключевому слову. Возвращает ранжированный список с URL профилей и бронирований.

qstring?Ключевое слово по имени, должности, слогану
categorystring?правовые · бухгалтерские · иммиграционные · финансовые · ...
countrystring?ISO 3166-1 alpha-2 (напр. US, KR)
languagestring?BCP 47 код языка эксперта
accepting_onlyboolean?Только эксперты, принимающие новых клиентов
limitnumber?Макс. результатов (по умолчанию 10, макс. 20)
get_expertАутентификация не требуется

Полный профиль одного эксперта: биография, услуги с ценами, расписание еженедельной доступности и все публичные способы связи.

slugstringУникальный slug эксперта из результатов поиска
localestring?Локаль для переведённой биографии/заголовка (en · ko · ja · zh · fr · de)
submit_inquiryТребуется API-ключ

Отправка запроса конкретному эксперту от имени пользователя. Эксперт получает уведомление по email и может ответить напрямую. Лимит: 5 на эксперта за 24 ч.

expert_slugstringSlug целевого эксперта
requester_namestringИмя представляемого лица
requester_emailstringEmail для ответа эксперта
messagestringСообщение запроса (макс. 2000 символов)
contextobject?Необязательные метаданные (источник, session_id, …)

REST API

Те же возможности, что и у MCP-сервера, доступные как обычный HTTP.

Полная спецификация: https://expertsapiens.com/api/openapi.json

GET/api/agents/expertsБез аутентификации

Поиск экспертов

curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"
GET/api/agents/experts/{slug}Без аутентификации

Полный профиль эксперта

curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"
POST/api/agents/inquiriesBearer-токен

Отправить запрос эксперту

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

Получить API-ключ

Войдите в Expert Sapiens, затем перейдите в панель управления для создания API-ключа. Ключи бесплатны и не имеют ограничения по частоте запросов, кроме submit_inquiry (5 на эксперта за 24 ч.).

  1. 1. Войдите или создайте аккаунт на expertsapiens.com
  2. 2. Перейдите в Панель управления → Аккаунт → API-ключи
  3. 3. Нажмите «Создать ключ» и назовите его по имени приложения
  4. 4. Скопируйте ключ — он показывается только один раз