تخطى إلى المحتوى الرئيسي
Expert Sapiens · API المطور

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

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

كيف يعمل

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

1

البحث

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

2

التقييم

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

3

التواصل

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

البدء السريع مع 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 يعملان بدون مفتاح API. submit_inquiry يتطلب رمز Bearer. إنشاء مفتاح ←

أدوات MCP

ثلاث أدوات تعرضها خادم MCP على /api/mcp و/api/sse.

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)
submit_inquiryيتطلب مفتاح API

إرسال استفسار إلى خبير محدد نيابةً عن مستخدمك. يتلقى الخبير إشعاراً بالبريد الإلكتروني ويمكنه الرد مباشرةً. حد معدل: 5 لكل خبير كل 24 ساعة.

expert_slugstringslug الخبير المستهدف
requester_namestringاسم الشخص الذي تمثله
requester_emailstringالبريد الإلكتروني الذي يجب على الخبير الرد عليه
messagestringرسالة الاستفسار (الحد الأقصى 2000 حرف)
contextobject?بيانات وصفية اختيارية (المصدر، session_id، ...)

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 لكل خبير كل 24 ساعة).

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