본문으로 건너뛰기
Expert Sapiens · 개발자 API

전문가를 찾고 연락하는 AI 에이전트를 구축하세요.

Expert Sapiens는 네이티브 MCP 서버와 REST API를 제공합니다. AI 에이전트가 검증된 전문가를 검색하고, 전체 프로필을 확인하며, 문의를 보낼 수 있습니다 — 사용자 로그인 없이도 가능합니다.

작동 방식

세 단계. 최종 사용자 측 로그인이 필요 없습니다.

1

검색

카테고리, 위치, 언어, 키워드로 전문가를 검색합니다. 프로필 URL과 예약 링크가 포함된 순위 목록을 반환합니다.

2

평가

전체 프로필을 가져옵니다 — 소개, 서비스 및 가격, 주간 가용 일정, 모든 공개 연락 채널.

3

연락

사용자를 대신해 전문가에게 문의를 보냅니다. 전문가는 이메일로 알림을 받고 직접 답장합니다.

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 / Windsurf
// .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 도구

/api/mcp의 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검색 결과의 전문가 고유 슬러그
localestring?번역된 소개/직함 언어 (en · ko · ja · zh · fr · de)
search_properties인증 불필요

서울 및 수도권 SeoulHomes 매물을 거래 유형, 매물 유형, 구, 가격, 면적, 옵션으로 검색합니다. 매물 URL, 가격, 면적, 위치, 담당 중개사를 반환합니다.

qstring?제목, 건물명, 동네에서 찾을 키워드
listing_typestring?rent · jeonse · sale · short_term · lump_sum
typestring?officetel · apartment · villa · house · studio
districtstring?서울 구, 한글 또는 로마자 (강남구, gangnam)
neighborhoodstring?동네 이름 (부분 일치)
min_pricenumber?최소 금액(원) (매매가, 월세·전세는 보증금)
max_pricenumber?최대 금액(원) (매매가, 월세·전세는 보증금)
min_areanumber?최소 면적(m²)
max_areanumber?최대 면적(m²)
roomsnumber?최소 방 개수
petboolean?반려동물 가능 매물만
parkingboolean?주차 가능 매물만
localestring?번역된 텍스트의 로케일 (en · ko · zh · ja · ru · vi · uz)
sortstring?newest · price_asc · price_desc
limitnumber?최대 결과 수 (기본 10, 최대 20)
get_property인증 불필요

매물 하나의 상세 정보: 설명, 전체 가격, 사양, 옵션, 건물 정보, 사진, 담당 중개사.

slugstringsearch_properties 결과나 매물 URL의 매물 슬러그
localestring?번역된 텍스트의 로케일 (en · ko · zh · ja · ru · vi · uz)
submit_inquiryAPI 키 필요

사용자를 대신해 전문가에게 문의를 보내거나, property_slug를 전달해 SeoulHomes 매물의 중개사에게 보냅니다. 받는 사람은 이메일로 알림을 받고 직접 답장할 수 있습니다. 계정당 제한: 24시간 동안 전문가별 5건, 전체 20건.

expert_slugstring?대상 전문가의 슬러그 (property_slug를 쓰면 필요 없음)
property_slugstring?SeoulHomes 매물 슬러그. 해당 매물의 중개사에게 보냅니다
requester_namestring대리하는 사람의 이름
requester_emailstring전문가가 답장할 이메일
messagestring문의 내용 (최대 2000자)
contextobject?선택적 메타데이터 (source, session_id, …)
save_propertyAPI 키 필요

키 소유자의 SeoulHomes 계정에 매물을 저장하거나 저장을 해제합니다.

property_slugstringsearch_properties 결과나 매물 URL의 매물 슬러그
saveboolean?true면 저장(기본값), false면 저장 해제
set_property_price_alertAPI 키 필요

키 소유자의 매물 가격 변동 알림을 켜거나 끕니다.

property_slugstringsearch_properties 결과나 매물 URL의 매물 슬러그
enabledbooleantrue면 알림 켜기, false면 알림 끄기
list_my_saved_propertiesAPI 키 필요

키 소유자가 저장한 매물과 가격 알림 상태를 보여 줍니다.

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는 계정당 24시간에 전문가당 5회, 전체 20회로 제한되며, 요청은 분당 횟수가 제한됩니다.

  1. 1. expertsapiens.com에서 로그인하거나 계정을 만드세요
  2. 2. 대시보드 → 계정 → API 키로 이동하세요
  3. 3. '키 생성'을 클릭하고 앱 이름을 지정하세요
  4. 4. 키를 복사하세요 — 한 번만 표시됩니다