Перейти к основному содержимому
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, search_properties и get_property работают без API-ключа. submit_inquiry, save_property, set_property_price_alert и list_my_saved_properties требуют Bearer-токен. Создать ключ →

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

Восемь инструментов MCP-сервера на /api/mcp: три для экспертов и пять для объявлений недвижимости SeoulHomes.

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)
search_propertiesАутентификация не требуется

Ищет объявления SeoulHomes в Сеуле и столичном регионе по типу сделки, типу объекта, району, цене, площади и удобствам. Возвращает ссылки на объявления, цены, площадь, расположение и агента.

qstring?Ключевое слово в заголовке, названии здания, районе
listing_typestring?rent · jeonse · sale · short_term · lump_sum
typestring?officetel · apartment · villa · house · studio
districtstring?Район (гу) Сеула, по-корейски или латиницей (강남구, gangnam)
neighborhoodstring?Название района (частичное совпадение)
min_pricenumber?Минимум в KRW (цена продажи или депозит для аренды/чонсе)
max_pricenumber?Максимум в KRW (цена продажи или депозит для аренды/чонсе)
min_areanumber?Минимальная площадь, м²
max_areanumber?Максимальная площадь, м²
roomsnumber?Минимальное число спален
petboolean?Только объявления, где можно с животными
parkingboolean?Только объявления с парковкой
localestring?Язык переведённого текста (en · ko · zh · ja · ru · vi · uz)
sortstring?newest · price_asc · price_desc
limitnumber?Макс. результатов (по умолчанию 10, макс. 20)
get_propertyАутентификация не требуется

Полная информация об объявлении: описание, все цены, характеристики, удобства, данные о здании, фото и агент.

slugstringSlug объявления из search_properties или ссылки на объявление
localestring?Язык переведённого текста (en · ko · zh · ja · ru · vi · uz)
submit_inquiryТребуется API-ключ

Отправляет запрос эксперту от имени вашего пользователя или, с property_slug, агенту объявления SeoulHomes. Получатель получает уведомление по email и может ответить напрямую. Лимит на аккаунт: 5 на эксперта и 20 всего за 24 ч.

expert_slugstring?Slug эксперта (не нужен при указании property_slug)
property_slugstring?Slug объявления SeoulHomes; запрос уходит агенту этого объявления
requester_namestringИмя представляемого лица
requester_emailstringEmail для ответа эксперта
messagestringСообщение запроса (макс. 2000 символов)
contextobject?Необязательные метаданные (источник, session_id, …)
save_propertyТребуется API-ключ

Сохраняет объявление в аккаунте SeoulHomes владельца ключа или убирает его.

property_slugstringSlug объявления из search_properties или ссылки на объявление
saveboolean?true — сохранить (по умолчанию), false — убрать
set_property_price_alertТребуется API-ключ

Включает или выключает уведомления об изменении цены объявления для владельца ключа.

property_slugstringSlug объявления из search_properties или ссылки на объявление
enabledbooleantrue — включить уведомления, false — выключить
list_my_saved_propertiesТребуется API-ключ

Список сохранённых объявлений владельца ключа со статусом ценовых уведомлений.

localestring?Язык переведённого текста (en · ko · zh · ja · ru · vi · uz)

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 запросами на эксперта и 20 всего за 24 ч на аккаунт, а частота запросов ограничена в минуту.

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