للمطورين ومساعدين الذكاء الاصطناعي
دليل المطورين لـ 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)
- افتح Settings ← Connectors ← Add custom connector.
- الصق رابط سيرفر MCP ودوس Add، وبعدين Connect.
- Brainy Social هيفتح: سجّل دخول لو طلب، واختار مساحة العمل والصلاحية (قراءة، أو قراءة ونشر)، ودوس سماح.
- هترجع لـ Claude وأدوات Brainy شغالة.
في ChatGPT
- افتح Settings ← Apps & Connectors ← Create (وضع المطوّر).
- الصق رابط سيرفر MCP واختار OAuth كطريقة المصادقة.
- دوس 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/accounts | list_social_accounts | حسابات السوشيال المتوصلة. |
POST /api/v1/media | upload_media_from_url | جيب صورة أو فيديو من رابط https عام. |
POST /api/v1/posts | create_post | اعمل بوست أو جدوله أو انشره على منصة أو أكتر. |
GET /api/v1/posts | list_posts | آخر البوستات (?status=&limit=)، أو المسودات بـ status=draft. |
GET /api/v1/posts/{id} | get_post | بوست أو مسودة واحدة. |
POST /api/v1/posts/{id}/cancel | cancel_post | إلغاء بوست لسه ما اتنشرش (DELETE على البوست بيشتغل برضه). |
GET /api/v1/posts/{id}/metrics | get_post_metrics | أرقام بوست اتنشر. |
GET /api/v1/accounts/{id}/metrics | get_account_metrics | المتابعين والإجماليات لحساب (?from=&to=، والافتراضي آخر 30 يوم). |
GET /api/v1/webhooks | list_webhooks | الـ Webhooks الخارجة (للمالك والأدمن). |
POST /api/v1/webhooks | create_webhook | اشترك بلينك في أحداث (REST hooks لـ Zapier وMake وn8n). المفتاح السري في الرد، مرة واحدة. |
DELETE /api/v1/webhooks/{id} | delete_webhook | إلغاء اشتراك Webhook. |
GET /api/v1/events | list_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. والنشر من خلالهم ماشي على نفس حدود الباقة وقواعد الموافقة اللي في التطبيق.
شوف الأسعار