Bỏ qua đến nội dung chính
Dành cho nhà phát triển

Xây dựng agent AI có thể tìm và liên hệ với chuyên gia con người.

Expert Sapiens cung cấp máy chủ MCP gốc và REST API để agent AI của bạn có thể tìm chuyên gia đã xác minh, đọc đầy đủ hồ sơ và gửi yêu cầu liên hệ mà không cần người dùng phải đăng nhập.

Cách hoạt động

Ba bước. Không cần người dùng cuối đăng nhập.

1

Tìm kiếm

Truy vấn chuyên gia theo danh mục, địa điểm, ngôn ngữ hoặc từ khóa. Nhận về danh sách xếp hạng kèm URL hồ sơ và đặt lịch.

2

Đánh giá

Lấy hồ sơ đầy đủ, gồm giới thiệu, dịch vụ có giá, lịch sẵn sàng theo tuần và tất cả kênh liên hệ công khai.

3

Liên hệ

Gửi yêu cầu thay mặt người dùng của bạn. Chuyên gia được thông báo qua email và trả lời trực tiếp, không có ma sát từ nền tảng.

Bắt đầu nhanh với MCP

Thêm Expert Sapiens làm công cụ gốc cho Claude, Cursor, Windsurf hoặc bất kỳ host tương thích MCP nào. Máy chủ MCP đang chạy tại https://expertsapiens.com/api/mcp.

Claude Desktop — chỉ đọc
// claude_desktop_config.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp"
    }
  }
}
Claude Desktop — có API key
// claude_desktop_config.json — with API key (enables submit_inquiry)
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
Con trỏ / Lướt ván buồm
// .cursor/mcp.json
{
  "mcpServers": {
    "expert-sapiens": {
      "url": "https://expertsapiens.com/api/mcp",
      "headers": {
        "Authorization": "Bearer es_live_..."
      }
    }
  }
}
cầu nối 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 và get_property hoạt động mà không cần API key. submit_inquiry, save_property, set_property_price_alert và list_my_saved_properties cần Bearer token. Tạo key →

Công cụ MCP

Tám công cụ được cung cấp bởi máy chủ MCP tại /api/mcp: ba cho chuyên gia và năm cho tin đăng bất động sản SeoulHomes.

search_expertsKhông cần xác thực

Tìm và lọc chuyên gia đã xác minh theo danh mục, địa điểm, ngôn ngữ hoặc từ khóa. Trả về danh sách xếp hạng kèm URL hồ sơ và đặt lịch.

qstring?Từ khóa tìm theo tên, chức danh, tagline
categorystring?pháp lý · kế toán · di trú · tài chính · ...
countrystring?Mã ISO 3166-1 alpha-2 (ví dụ US, KR)
languagestring?Mã BCP 47 mà chuyên gia sử dụng
accepting_onlyboolean?Chỉ lấy chuyên gia đang nhận khách mới
limitnumber?Số kết quả tối đa (mặc định 10, tối đa 20)
get_expertKhông cần xác thực

Hồ sơ đầy đủ của một chuyên gia: giới thiệu, dịch vụ kèm giá, lịch sẵn sàng hàng tuần và tất cả phương thức liên hệ công khai.

slugstringSlug duy nhất của chuyên gia từ kết quả tìm kiếm
localestring?Locale cho phần giới thiệu/chức danh đã dịch (en · ko · ja · zh · fr · de)
search_propertiesKhông cần xác thực

Tìm tin đăng SeoulHomes ở Seoul và vùng thủ đô theo loại giao dịch, loại nhà, quận, giá, diện tích và tiện ích. Trả về đường dẫn tin đăng, giá, diện tích, vị trí và môi giới phụ trách.

qstring?Từ khóa trong tiêu đề, tên tòa nhà, khu phố
listing_typestring?rent · jeonse · sale · short_term · lump_sum
typestring?officetel · apartment · villa · house · studio
districtstring?Quận (gu) ở Seoul, tiếng Hàn hoặc Latin (강남구, gangnam)
neighborhoodstring?Tên khu phố (khớp một phần)
min_pricenumber?Mức tối thiểu (KRW) (giá bán, hoặc tiền cọc với thuê/jeonse)
max_pricenumber?Mức tối đa (KRW) (giá bán, hoặc tiền cọc với thuê/jeonse)
min_areanumber?Diện tích tối thiểu (m²)
max_areanumber?Diện tích tối đa (m²)
roomsnumber?Số phòng ngủ tối thiểu
petboolean?Chỉ tin đăng cho phép thú cưng
parkingboolean?Chỉ tin đăng có chỗ đậu xe
localestring?Ngôn ngữ cho văn bản đã dịch (en · ko · zh · ja · ru · vi · uz)
sortstring?newest · price_asc · price_desc
limitnumber?Số kết quả tối đa (mặc định 10, tối đa 20)
get_propertyKhông cần xác thực

Toàn bộ chi tiết của một tin đăng: mô tả, giá đầy đủ, thông số, tiện ích, thông tin tòa nhà, ảnh và môi giới phụ trách.

slugstringSlug tin đăng từ kết quả search_properties hoặc đường dẫn tin đăng
localestring?Ngôn ngữ cho văn bản đã dịch (en · ko · zh · ja · ru · vi · uz)
submit_inquiryYêu cầu API key

Gửi yêu cầu đến chuyên gia thay cho người dùng của bạn, hoặc đến môi giới của một tin đăng SeoulHomes bằng cách truyền property_slug. Người nhận được thông báo qua email và có thể trả lời trực tiếp. Giới hạn mỗi tài khoản: 5 cho mỗi chuyên gia và tổng 20 trong 24 giờ.

expert_slugstring?Slug của chuyên gia nhận (không cần khi có property_slug)
property_slugstring?Slug tin đăng SeoulHomes; gửi đến môi giới của tin đăng đó
requester_namestringTên người mà bạn đại diện
requester_emailstringEmail mà chuyên gia sẽ dùng để phản hồi
messagestringNội dung yêu cầu (tối đa 2000 ký tự)
contextobject?Siêu dữ liệu tùy chọn (source, session_id, …)
save_propertyYêu cầu API key

Lưu hoặc bỏ lưu tin đăng trong tài khoản SeoulHomes của chủ khóa.

property_slugstringSlug tin đăng từ kết quả search_properties hoặc đường dẫn tin đăng
saveboolean?true để lưu (mặc định), false để bỏ lưu
set_property_price_alertYêu cầu API key

Bật hoặc tắt thông báo thay đổi giá của một tin đăng cho chủ khóa.

property_slugstringSlug tin đăng từ kết quả search_properties hoặc đường dẫn tin đăng
enabledbooleantrue để bật cảnh báo, false để tắt
list_my_saved_propertiesYêu cầu API key

Liệt kê các tin đăng chủ khóa đã lưu kèm trạng thái cảnh báo giá.

localestring?Ngôn ngữ cho văn bản đã dịch (en · ko · zh · ja · ru · vi · uz)

REST API

Cùng năng lực như máy chủ MCP, nhưng có sẵn dưới dạng HTTP thuần.

Đặc tả đầy đủ: https://expertsapiens.com/api/openapi.json

GET/api/agents/expertsKhông cần xác thực

Tìm chuyên gia

curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"
GET/api/agents/experts/{slug}Không cần xác thực

Hồ sơ chuyên gia đầy đủ

curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"
POST/api/agents/inquiriesMã định danh Bearer

Gửi yêu cầu đến chuyên gia

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

Lấy API key

Đăng nhập vào Expert Sapiens, sau đó vào bảng điều khiển để tạo API key. Key được cấp miễn phí. submit_inquiry giới hạn 5 yêu cầu mỗi chuyên gia và tổng cộng 20 yêu cầu trong 24 giờ cho mỗi tài khoản, và số yêu cầu mỗi phút cũng bị giới hạn.

  1. 1. Đăng nhập hoặc tạo tài khoản tại expertsapiens.com
  2. 2. Vào Bảng điều khiển → Tài khoản → API Keys
  3. 3. Nhấn "Generate Key" và đặt tên theo ứng dụng của bạn
  4. 4. Sao chép key, key chỉ hiển thị một lần