跳到主要内容
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 服务器提供八个工具:三个用于专家,五个用于首尔之家房源。

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无需认证

按交易类型、房产类型、区、价格、面积和配套搜索首尔及首都圈的首尔之家房源。返回房源链接、价格、面积、位置和负责经纪人。

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无需认证

单个房源的完整详情:描述、完整价格、规格、配套、楼盘信息、照片和负责经纪人。

slugstring来自 search_properties 结果或房源链接的房源 slug
localestring?翻译文本的语言区域(en · ko · zh · ja · ru · vi · uz)
submit_inquiry需要 API 密钥

代表你的用户向专家发送咨询,或传入 property_slug 发送给首尔之家房源的经纪人。收件人会收到邮件通知并可直接回复。每个账户的限制:24 小时内每位专家 5 条,总计 20 条。

expert_slugstring?目标专家的 slug(使用 property_slug 时无需填写)
property_slugstring?首尔之家房源 slug;发送给该房源的经纪人
requester_namestring您代表的人的姓名
requester_emailstring专家回复的邮箱地址
messagestring咨询内容(最多 2000 字)
contextobject?可选元数据(source、session_id 等)
save_property需要 API 密钥

在密钥所有者的首尔之家账户中收藏或取消收藏房源。

property_slugstring来自 search_properties 结果或房源链接的房源 slug
saveboolean?true 为收藏(默认),false 为取消收藏
set_property_price_alert需要 API 密钥

为密钥所有者开启或关闭某个房源的价格变动通知。

property_slugstring来自 search_properties 结果或房源链接的房源 slug
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 每个账户每 24 小时限每位专家 5 次、总计 20 次,请求另有每分钟次数限制。

  1. 1. 在 expertsapiens.com 登录或创建账户
  2. 2. 前往仪表板 → 账户 → API 密钥
  3. 3. 点击「生成密钥」并为应用命名
  4. 4. 复制密钥 — 仅显示一次