Expert Sapiens · API المطور

ابنِ وكلاء ذكاء اصطناعي تجد الخبراء البشريين وتتواصل معهم.

تعرض Expert Sapiens خادم MCP أصلياً وREST API حتى يتمكن وكيل الذكاء الاصطناعي الخاص بك من البحث عن المهنيين الموثقين وقراءة الملفات الشخصية الكاملة وإرسال الاستفسارات — كل ذلك دون أي تسجيل دخول للمستخدم.

احصل على مفتاح API مواصفات OpenAPI

كيف يعمل

ثلاث خطوات. لا يلزم تسجيل دخول من جانب المستخدم النهائي.

البحث

استعلم عن الخبراء حسب الفئة والموقع واللغة أو الكلمة المفتاحية. احصل على قائمة مرتبة مع روابط الملف الشخصي والحجز.

التقييم

اجلب الملف الشخصي الكامل — السيرة الذاتية والخدمات بالأسعار والتوفر الأسبوعي وجميع قنوات الاتصال العامة.

التواصل

قدّم استفساراً نيابةً عن مستخدمك. يتلقى الخبير إشعاراً بالبريد الإلكتروني ويرد مباشرةً — لا احتكاك بالمنصة.

البدء السريع مع 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/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

ثماني أدوات يعرضها خادم MCP على /api/mcp: ثلاث للخبراء وخمس لإعلانات عقارات SeoulHomes.

search_expertsلا يتطلب مصادقة

البحث وتصفية الخبراء الموثقين حسب الفئة والموقع واللغة أو الكلمة المفتاحية. يعيد قائمة مرتبة مع روابط الملف الشخصي والحجز.

qstring?كلمة مفتاحية عبر الاسم والمسمى الوظيفي والشعار

categorystring?قانوني · محاسبة · هجرة · مالية · ...

countrystring?ISO 3166-1 alpha-2 (مثال: US، KR)

languagestring?رمز BCP 47 للغة التي يتحدثها الخبير

accepting_onlyboolean?الخبراء المقبلون على عملاء جدد فقط

limitnumber?الحد الأقصى للنتائج (افتراضي 10، حد أقصى 20)

get_expertلا يتطلب مصادقة

الملف الشخصي الكامل لخبير واحد: السيرة الذاتية والخدمات بالأسعار وجدول التوفر الأسبوعي وجميع طرق الاتصال العامة.

slugstringslug الفريد للخبير من نتائج البحث

localestring?اللغة للسيرة الذاتية/العنوان المترجم (en · ko · ja · zh · fr · de)

search_propertiesلا يتطلب مصادقة

يبحث في إعلانات SeoulHomes في سيول ومنطقة العاصمة حسب نوع الصفقة ونوع العقار والحي والسعر والمساحة والمزايا. يعيد روابط الإعلانات والأسعار والمساحة والموقع ووسيط الإعلان.

qstring?كلمة مفتاحية في العنوان واسم المبنى والحي

listing_typestring?rent · jeonse · sale · short_term · lump_sum

typestring?officetel · apartment · villa · house · studio

districtstring?حي (gu) في سيول، بالكورية أو بالحروف اللاتينية (강남구, gangnam)

neighborhoodstring?اسم الحي (تطابق جزئي)

min_pricenumber?الحد الأدنى بالوون (سعر البيع، أو العربون للإيجار/جونسي)

max_pricenumber?الحد الأقصى بالوون (سعر البيع، أو العربون للإيجار/جونسي)

min_areanumber?أدنى مساحة بالمتر المربع

max_areanumber?أقصى مساحة بالمتر المربع

roomsnumber?أدنى عدد لغرف النوم

petboolean?الإعلانات التي تسمح بالحيوانات الأليفة فقط

parkingboolean?الإعلانات التي بها موقف سيارات فقط

localestring?لغة النص المترجم (en · ko · zh · ja · ru · vi · uz)

sortstring?newest · price_asc · price_desc

limitnumber?الحد الأقصى للنتائج (افتراضي 10، حد أقصى 20)

get_propertyلا يتطلب مصادقة

التفاصيل الكاملة لإعلان واحد: الوصف والأسعار الكاملة والمواصفات والمزايا وملف المبنى والصور ووسيط الإعلان.

slugstringمعرّف slug للإعلان من search_properties أو من رابط الإعلان

localestring?لغة النص المترجم (en · ko · zh · ja · ru · vi · uz)

submit_inquiryيتطلب مفتاح API

يرسل استفسارًا إلى خبير نيابةً عن مستخدمك، أو إلى وسيط إعلان SeoulHomes بتمرير property_slug. يتلقى المستلم إشعارًا بالبريد الإلكتروني ويمكنه الرد مباشرة. الحد لكل حساب: 5 لكل خبير و20 إجمالًا كل 24 ساعة.

expert_slugstring?معرّف slug للخبير المستهدف (غير مطلوب مع property_slug)

property_slugstring?معرّف slug لإعلان SeoulHomes؛ يرسل إلى وسيط ذلك الإعلان

requester_namestringاسم الشخص الذي تمثله

requester_emailstringالبريد الإلكتروني الذي يجب على الخبير الرد عليه

messagestringرسالة الاستفسار (الحد الأقصى 2000 حرف)

contextobject?بيانات وصفية اختيارية (المصدر، session_id، ...)

save_propertyيتطلب مفتاح API

يحفظ إعلانًا في حساب SeoulHomes لمالك المفتاح أو يلغي حفظه.

property_slugstringمعرّف slug للإعلان من search_properties أو من رابط الإعلان

saveboolean?true للحفظ (افتراضي)، false لإلغاء الحفظ

set_property_price_alertيتطلب مفتاح API

يشغّل أو يوقف إشعارات تغيّر السعر لإعلان لمالك المفتاح.

property_slugstringمعرّف slug للإعلان من search_properties أو من رابط الإعلان

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/inquiriesرمز Bearer

إرسال استفسار إلى خبير

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 على 5 استفسارات لكل خبير و20 إجمالاً كل 24 ساعة لكل حساب، ويوجد حد لعدد الطلبات في الدقيقة.

1. سجّل الدخول أو أنشئ حساباً على expertsapiens.com
2. انتقل إلى لوحة التحكم ← الحساب ← مفاتيح API
3. انقر على "إنشاء مفتاح" وسمّه باسم تطبيقك
4. انسخ المفتاح — يُعرض مرة واحدة فقط

الانتقال إلى مفاتيح API إنشاء حساب