Brainy SocialBY IS&S

للمطورين ومساعدين الذكاء الاصطناعي

دليل المطورين لـ Brainy Social

خلّي Claude وChatGPT والكود بتاعك يقروا عقل البراند، ويعملوا بوستات ويجدولوها ويتابعوها على إنستجرام وفيسبوك وتيك توك ويوتيوب ولينكد إن وX.

آخر تحديث: 19 نوفمبر 2026

اربط Claude أو ChatGPT (MCP)

Brainy Social سيرفر MCP وليه تسجيل دخول OAuth 2.1 خاص بيه. Claude وChatGPT محتاجين رابط السيرفر بس: بتسجّل دخول بحساب Brainy بتاعك، وتختار مساحة عمل واحدة والصلاحية، ومن غير ما تنسخ أي توكن.

رابط سيرفر MCP

https://brainy-social.com/api/mcp

في Claude (claude.ai أو Claude Desktop)

  1. افتح Settings ← Connectors ← Add custom connector.
  2. الصق رابط سيرفر MCP ودوس Add، وبعدين Connect.
  3. Brainy Social هيفتح: سجّل دخول لو طلب، واختار مساحة العمل والصلاحية (قراءة، أو قراءة ونشر)، ودوس سماح.
  4. هترجع لـ Claude وأدوات Brainy شغالة.

في ChatGPT

  1. افتح Settings ← Apps & Connectors ← Create (وضع المطوّر).
  2. الصق رابط سيرفر MCP واختار OAuth كطريقة المصادقة.
  3. دوس Connect، وسجّل دخول في Brainy Social، واختار مساحة العمل والصلاحية، ودوس سماح.

الربط يقدر يعمل إيه

  • قراءة: أدوات عقل البراند. أي عضو في مساحة العمل يقدر يربط بصلاحية القراءة.
  • قراءة ونشر: وكمان أدوات النشر. المالك والأدمن والمحرر بس يقدروا يختاروها.
  • كل ربط بيستخدم مساحة عمل واحدة، وبيشتغل باسم الشخص اللي سمح بيه وبدوره الحالي. لو ساب مساحة العمل أو حسابه اتوقف، الربط بيقف.
  • بوستات المحرر بتفضل مستنية موافقة لو مساحة العمل طالبة موافقة.
  • كل ربط بيظهر في الذكاء الاصطناعي و MCP ← التطبيقات المربوطة، وتقدر تفصله في أي وقت.
  • الوصول لـ MCP موجود من باقة Growth.

Claude Code وCursor وأي عميل MCP تاني

العملاء اللي مفيهمش تسجيل دخول بضغطة واحدة، والوكلاء اللي بتشتغل لوحدها، بيستخدموا مفتاح API للوكلاء: في التطبيق افتح قائمة الترس ← الذكاء الاصطناعي و MCP ← سيرفر MCP ← مفاتيح API للوكلاء، واختار قراءة أو قراءة ونشر ومدة الصلاحية، واعمل المفتاح (بيظهر مرة واحدة بس). وبعدين ضيف السيرفر بالمفتاح ده، مثلًا في Claude Code:

claude mcp add --transport http brainy https://brainy-social.com/api/mcp \
  --header "Authorization: Bearer bsk_EXAMPLE_not_a_real_token"

الإعداد لكل أداة

إعدادات جاهزة للنسخ لـ Claude وChatGPT وClaude Code وCursor وVS Code وCodex وWindsurf وجسر mcp-remote، بتسجيل الدخول أو بمفتاح API. الذكاء الاصطناعي في الأدوات دي بيتحاسب على حسابها هي، مش على Brainy.

افتح دليل الربط

أدوات MCP

المدخلات هي نفس حقول الـ REST اللي تحت. المساعد بيشتغل على حسابه هو (Claude أو ChatGPT…): مش بيستخدم مفتاح الذكاء الاصطناعي بتاع مساحة العمل.

عقل البراند (كل ربط)

get_brand_prompt
دليل البراند كامل كبرومبت جاهز: الصوت والأسلوب، والمنتجات، والجمهور، والمنافسين، والأهداف، والمواسم.
get_brand_brain
عقل البراند كـ JSON منظّم، مع مصدر كل حقل وهل هو متأكد منه.
search_brand_brain
بيدوّر في عقل البراند (منتجات، جمهور، منافسين…) على الكلام اللي بتكتبه، بالعربي أو الإنجليزي.
list_products
المنتجات والخدمات بالسعر والعملة والعروض، واللي منها مميز.

النشر (قراءة ونشر بس)

list_social_accounts
حسابات السوشيال المتوصلة بمساحة العمل، بالـ id والمنصة واليوزر والحالة والمتابعين.
upload_media_from_url
بيجيب صورة (JPEG وPNG وWebP لحد 10 ميجا) أو فيديو (MP4 وMOV لحد 50 ميجا) من رابط https عام، ويرجّع id للميديا.
create_post
بيعمل بوست لمنصة أو أكتر: انشر دلوقتي، أو جدوله، أو احفظه كمسودة. الكاروسيل بياخد من 2 لـ 10 ملفات.
list_posts
آخر البوستات، أو المسودات، حسب الحالة.
get_post
بوست واحد بحالته وميعاده ورابطه وآخر خطأ.
cancel_post
بيلغي بوست مستني موافقة أو متجدول أو فشل.
get_post_metrics
المشاهدات والوصول واللايكات والتعليقات والمشاركات والحفظ ونسبة التفاعل لبوست اتنشر، مع التاريخ.
get_account_metrics
متابعين الحساب على مدار الوقت وإجمالي البوستات لفترة معينة.
list_webhooks
الـ Webhooks الخارجة بتاعة مساحة العمل (للمالك والأدمن).
create_webhook
بيشترك بلينك https في أحداث (بوست اتنشر، رسالة جديدة، تعليق جديد، عميل محتمل جديد). بيرجع المفتاح السري مرة واحدة.
delete_webhook
بيشيل Webhook.
list_events
آخر الأحداث بنفس البيانات اللي الـ Webhooks بتستقبلها، الأحدث الأول، للسحب الدوري.

واجهة النشر REST API

نفس عمليات أدوات النشر في MCP، للكود بتاعك وللأتمتة. JSON داخل وJSON خارج.

المصادقة

  • ابعت مفتاح API للوكلاء مع كل طلب: Authorization: Bearer bsk_…
  • اعمله من التطبيق: قائمة الترس ← الذكاء الاصطناعي و MCP ← سيرفر MCP ← مفاتيح API للوكلاء ← قراءة ونشر ← اعمل مفتاح. بيظهر مرة واحدة، وممكن تحدد له مدة، وتقدر تلغيه من نفس الصفحة.
  • توكن النشر بيشتغل باسم الشخص اللي عمله وبدوره الحالي. توكنات القراءة بترجع 403 في الواجهة دي.
  • ربط OAuth (Claude وChatGPT) بيشتغل على سيرفر MCP بس، مش على REST API.
  • اطلب الواجهة من سيرفر: الطلبات من المتصفح بتترفض.

القواعد

  • النجاح: { "data": … }. الأخطاء: { "error": { "code", "message" } } بأكواد زي invalid وunauthorized وplan_limit وforbidden وnot_found وconflict وmedia وrate_limited.
  • حقول الطلب بصيغة snake_case، والردود بصيغة camelCase.
  • المواعيد بصيغة ISO 8601، ولازم scheduled_at يكون فيه فرق التوقيت (مثلًا +02:00 أو Z). تقدر تجدول لحد سنة قدام.
  • حجم الطلب لحد 64 كيلوبايت: الميديا بتيجي من رابط، مش جوه الطلب.
  • الكابشن اللي بتبعته بيتنشر زي ما هو: مفيش ذكاء اصطناعي بيعيد كتابته، والبوستات اللي بتتعمل من الـ API عمرها ما بتتحسب من بوستات الذكاء الاصطناعي في باقتك.
  • النشر مش فوري: تابع البوست لحد ما يبقى اتنشر. لو فشل، بيتعاد أوتوماتيك قبل ما يتعلّم إنه فشل.

نقاط الوصول

نقطة الوصولأداة MCPبتعمل إيه
GET /api/v1/accountslist_social_accountsحسابات السوشيال المتوصلة.
POST /api/v1/mediaupload_media_from_urlجيب صورة أو فيديو من رابط https عام.
POST /api/v1/postscreate_postاعمل بوست أو جدوله أو انشره على منصة أو أكتر.
GET /api/v1/postslist_postsآخر البوستات (?status=&limit=)، أو المسودات بـ status=draft.
GET /api/v1/posts/{id}get_postبوست أو مسودة واحدة.
POST /api/v1/posts/{id}/cancelcancel_postإلغاء بوست لسه ما اتنشرش (DELETE على البوست بيشتغل برضه).
GET /api/v1/posts/{id}/metricsget_post_metricsأرقام بوست اتنشر.
GET /api/v1/accounts/{id}/metricsget_account_metricsالمتابعين والإجماليات لحساب (?from=&to=، والافتراضي آخر 30 يوم).
GET /api/v1/webhookslist_webhooksالـ Webhooks الخارجة (للمالك والأدمن).
POST /api/v1/webhookscreate_webhookاشترك بلينك في أحداث (REST hooks لـ Zapier وMake وn8n). المفتاح السري في الرد، مرة واحدة.
DELETE /api/v1/webhooks/{id}delete_webhookإلغاء اشتراك Webhook.
GET /api/v1/eventslist_eventsآخر الأحداث (?type=&since=&limit=)، للـ polling triggers.

مثال

التوكن اللي تحت مثال بس، مش توكن حقيقي.

TOKEN=bsk_EXAMPLE_not_a_real_token
API=https://brainy-social.com/api/v1

curl -s "$API/accounts" -H "Authorization: Bearer $TOKEN"

curl -s -X POST "$API/posts" -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{
  "platforms": ["instagram", "facebook"],
  "caption": "Our new roast is here",
  "hashtags": ["coffee", "cairo"],
  "mode": "schedule",
  "scheduled_at": "2026-12-20T18:30:00+02:00"
}'

حدود الطلبات (لكل توكن)

  • القراءة: 120 طلب في الدقيقة.
  • الكتابة (إنشاء وإلغاء): 20 في الدقيقة، و300 في اليوم.
  • استيراد الميديا: 10 في الدقيقة، و100 في اليوم.

Zapier وMake وn8n

استقبل Webhooks موقّعة لما بوست يتنشر، أو رسالة أو تعليق يوصل، أو عميل محتمل يجي من اللينك في البايو — مع خطوات الإعداد لكل أداة والتأكد من التوقيع.

افتح دليل الأتمتة

مفتاح الذكاء الاصطناعي بتاعك (BYOK)

مميزات الذكاء الاصطناعي في Brainy Social بتشتغل على مفتاح API بتاع مساحة العمل بتاعتك، وأدوات MCP بتشتغل على حسابها هي. استخدامك للذكاء الاصطناعي عمره ما بيتحسب على مفتاحنا.

  • ضيف مفتاح من Anthropic (Claude) أو OpenAI (ChatGPT) أو Google (Gemini) في الذكاء الاصطناعي و MCP. المفاتيح بتتأكد، وبتتخزن متشفرة، وآخر 4 حروف بس هي اللي بتظهر.
  • مزوّد الخدمة بيحاسبك مباشرة على اللي بتستخدمه، وإنت بتختار الموديل لكل مهمة.
  • اشتراك ChatGPT Plus أو Claude Pro مش مفتاح API: دول لتطبيقات الشات وليهم فاتورة لوحدهم.
  • من غير مفتاح، Brainy بيستخدم قوالب بسيطة من غير إنترنت. البوستات اللي بتكتبها بنفسك، واللي بتتعمل من الـ API، عمرها ما بتحتاج ذكاء اصطناعي.
  • المساعدين المتوصلين بـ MCP بيستخدموا حسابهم هما، فمش بيصرفوا من مفتاحك: Brainy مش بيشغّل أي موديل لطلبات MCP.
  • استثناء واحد، لو متفعّل: وإنت بتجهز مساحة عمل جديدة ملهاش مفتاح، مساعد البداية واستيراد الموقع أو الملفات ممكن يستخدموا كمية صغيرة ومحدودة من ذكاء Brainy نفسه ببلاش. وده بيخلص لما الإعداد يكمل.

الباقات

الوصول لـ MCP والـ API موجود من باقة Growth. والنشر من خلالهم ماشي على نفس حدود الباقة وقواعد الموافقة اللي في التطبيق.

شوف الأسعار