メインコンテンツへスキップ
Expert Sapiens · 開発者 API

専門家を見つけて連絡するAIエージェントを構築しましょう。

Expert SapiensはネイティブMCPサーバーとREST APIを提供します。AIエージェントが認証済み専門家を検索し、プロフィールを確認し、問い合わせを送信できます — ユーザーログイン不要。

仕組み

3ステップ。エンドユーザー側のログインは不要です。

1

検索

カテゴリ、場所、言語、キーワードで専門家を検索します。プロフィールURLと予約リンク付きのランキングリストを返します。

2

評価

完全なプロフィールを取得します — 経歴、価格付きサービス、週間対応スケジュール、すべての公開連絡先。

3

連絡

ユーザーに代わって専門家に問い合わせを送信します。専門家はメールで通知を受け、直接返信します。

MCPクイックスタート

Expert SapiensをClaude、Cursor、WindsurfまたはMCP対応ホストにネイティブツールとして追加してください。MCPサーバーのURL: 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/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サーバーが提供する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_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認証不要

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

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. 1. expertsapiens.comでサインインまたはアカウント作成
  2. 2. ダッシュボード → アカウント → APIキーに移動
  3. 3. 「キーを生成」をクリックしてアプリ名を付ける
  4. 4. キーをコピー — 一度しか表示されません