واجهة درب العامّة: بيانات الجامعات والاختبارات والتقويم والأسئلة الشائعة — JSON بلا مصادقة، مع OpenAPI وخادم MCP.

المصادقة

واجهاتُ القراءة أدناه عامّة بلا مصادقة. أمّا ما يخصّ حساب طالبٍ بعينه فمحميٌّ بدخول Google (OAuth 2.0 عبر Firebase) ويُرسَل رمزُه في Authorization: Bearer <ID token>. لا يوجد طريقٌ يُخرِج بيانات طالبٍ إلى وكيلٍ بلا إذنه.

`GET /api/agent/universities`

قائمة الجامعات السعودية ومعلوماتها؛ ومع `id` تُعاد كلياتها وتخصّصاتها الدقيقة.

المعاملات: id region

جرّبها ←

`GET /api/agent/exams`

الاختبارات الوطنية ونوافذ تسجيلها الرسمية وحالتها (مفتوح/قادم/بانتظار الإعلان).

جرّبها ←

`GET /api/agent/calendar`

التقويم الدراسي السعودي المعتمد: الفصول والإجازات ونهاية العام.

جرّبها ←

`GET /api/agent/faq`

الأسئلة الشائعة عن القبول الجامعي ومنصّة قبول، مع بحثٍ نصّي عبر `q`.

المعاملات: q

جرّبها ←

خادم MCP

عنوانُه https://usedarb.com/mcp ويتكلّم JSON-RPC 2.0. أدواتُه: list_universities · get_university · list_exams · get_academic_calendar · search_faq.

curl -X POST https://usedarb.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

قواعد الاستعمال

حدُّ الطلبات ستّون في الدقيقة لكل عنوان.
الحقلُ الفارغ يعني «لم تُعلنه الجهة الرسمية» — لا يُملأ تخميناً.
انسب المصدر عند نقل تقويمٍ أو نافذة تسجيل.