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.
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.
Đá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.
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_config.json
{
"mcpServers": {
"expert-sapiens": {
"url": "https://expertsapiens.com/api/mcp"
}
}
}// 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_..."
}
}
}
}// 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ựcTì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, taglinecategorystring?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ụngaccepting_onlyboolean?Chỉ lấy chuyên gia đang nhận khách mớilimitnumber?Số kết quả tối đa (mặc định 10, tối đa 20)get_expertKhông cần xác thựcHồ 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ếmlocalestring?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ựcTì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_sumtypestring?officetel · apartment · villa · house · studiodistrictstring?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ểupetboolean?Chỉ tin đăng cho phép thú cưngparkingboolean?Chỉ tin đăng có chỗ đậu xelocalestring?Ngôn ngữ cho văn bản đã dịch (en · ko · zh · ja · ru · vi · uz)sortstring?newest · price_asc · price_desclimitnumber?Số kết quả tối đa (mặc định 10, tối đa 20)get_propertyKhông cần xác thựcToà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 đănglocalestring?Ngôn ngữ cho văn bản đã dịch (en · ko · zh · ja · ru · vi · uz)submit_inquiryYêu cầu API keyGử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ệnrequester_emailstringEmail mà chuyên gia sẽ dùng để phản hồimessagestringNộ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 keyLư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 đăngsaveboolean?true để lưu (mặc định), false để bỏ lưuset_property_price_alertYêu cầu API keyBậ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 đăngenabledbooleantrue để bật cảnh báo, false để tắtlist_my_saved_propertiesYêu cầu API keyLiệ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
/api/agents/expertsKhông cần xác thựcTìm chuyên gia
curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"/api/agents/experts/{slug}Không cần xác thựcHồ sơ chuyên gia đầy đủ
curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"/api/agents/inquiriesMã định danh BearerGử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. Đăng nhập hoặc tạo tài khoản tại expertsapiens.com
- 2. Vào Bảng điều khiển → Tài khoản → API Keys
- 3. Nhấn "Generate Key" và đặt tên theo ứng dụng của bạn
- 4. Sao chép key, key chỉ hiển thị một lần