仕組み
3ステップ。エンドユーザー側のログインは不要です。
検索
カテゴリ、場所、言語、キーワードで専門家を検索します。プロフィールURLと予約リンク付きのランキングリストを返します。
評価
完全なプロフィールを取得します — 経歴、価格付きサービス、週間対応スケジュール、すべての公開連絡先。
連絡
ユーザーに代わって専門家に問い合わせを送信します。専門家はメールで通知を受け、直接返信します。
MCPクイックスタート
Expert SapiensをClaude、Cursor、WindsurfまたはMCP対応ホストにネイティブツールとして追加してください。MCPサーバーのURL: 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、get_propertyはAPIキーなしで動作します。submit_inquiry, save_property, set_property_price_alert、list_my_saved_propertiesにはBearerトークンが必要です。 キーを生成する →
MCPツール
/api/mcpのMCPサーバーが提供する8つのツール:専門家向け3つ、SeoulHomes物件向け5つ。
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_sumtypestring?officetel · apartment · villa · house · studiodistrictstring?ソウルの区。韓国語またはローマ字(강남구, 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_desclimitnumber?最大件数 (デフォルト10、最大20)get_property認証不要1件の物件の詳細:説明、価格の内訳、仕様、設備、建物情報、写真、担当の仲介業者。
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
/api/agents/experts認証なし専門家を検索
curl "https://expertsapiens.com/api/agents/experts?category=legal&language=ko&limit=5"/api/agents/experts/{slug}認証なし専門家の完全なプロフィール
curl "https://expertsapiens.com/api/agents/experts/james-chae?locale=en"/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."
}'