انشر من شيفرتك. المسار نفسه، برمجيًا.
كل إجراء في لوحة التحكم هو نقطة نهاية REST. النشر، والجدولة، والحسابات، والتحليلات، وwebhooks. حزمة TypeScript SDK رسمية. خادم MCP لـ Claude Desktop وCursor وChatGPT. مفاتيح API محددة النطاق لكل مساحة عمل حتى لا يتسرب شيء.
ثلاثة أسطر من الكود. ثلاث منصات مجدولة.
الشكل الحقيقي لاستدعاء النشر: اختر مساحة عمل، ومرّر تعليقًا ومنصات، واحصل على معرّف المنشور وحالة التسليم لكل منصة. الاستدعاء نفسه من TypeScript أو PHP أو curl.
/v1/postsimport { FoPost } from '@fopost/sdk';
const client = new FoPost({ apiKey: process.env.FOPOST_API_KEY });
const accounts = await client.accounts.list({ workspaceId });
const post = await client.posts.create({
workspaceId,
status: 'scheduled',
scheduleAt: '2026-09-01T09:00:00Z',
content: [{ text: 'Stop launching on Tuesday.', position: 0 }],
accounts: accounts.map((a) => ({ id: a.id })),
});pst_01H7K3MRGB8YZ4QVWكتبت التكامل مع Twitter. ثم غيّرت LinkedIn كل شيء.
أطلقت النشر على Twitter في عطلة نهاية أسبوع. ثم استغرقت LinkedIn ثلاثة أيام، واستغرق مسار OAuth أسبوعًا، ولدى Instagram أسوأ API في العالم، ولم تبدأ بعد مع TikTok.
كل منصة تتعطل بطريقة مختلفة في اليوم نفسه. يتغير حد المعدل في Bluesky. تضيف Threads قيدًا على نوع الوسائط. يبدّل Hashnode إصدارات GraphQL. تكاملك يحترق وأنت مشغول بإطلاق المنتج.
بنيت OAuth يدويًا لـ 5 منصات. تخزّن رموز التحديث في قاعدة بياناتك. والآن أنت مسؤول عن تحديث الرموز، والتخزين المشفّر، والتعامل مع المفاتيح بمعايير شبيهة بـ SOC 2. ليس هذا العمل الذي أردت أن تكون فيه.
هل الـ API مناسبة لك؟
مناسب لك إذا
- تبني منتجًا يحتاج إلى النشر على وسائل التواصل نيابةً عن مستخدميك
- تدير مسار عمليات محتوى ينطلق من CI أو نظام CRM أو الخادم الخاص بك
- تريد ربط FoPost بـ Claude Desktop أو Cursor أو ChatGPT عبر MCP وترك الوكيل ينشر عنك
- تبني أدوات للوكالات وتريد إتاحة النشر على وسائل التواصل لعملائك دون إدارة تكاملات 33 منصة
غير مناسب لك إذا
- تنشر يدويًا فقط من لوحة التحكم. الـ API أكثر مما تحتاج، والمحرر هو المكان المناسب.
- تحتاج إلى استضافة API كاملة بعلامة بيضاء (your-brand.api.com). تحدث إلينا بشأن اتفاقية للمؤسسات.
API واحدة. 32 منصة. ونحن نتحمل الأعطال.
تكتب وفق مخطط واحد. ونحن نوزعه على 32 منصة، ونحدّث الرموز، ونتعامل مع حدود المعدل، ونسلّم المنشور، ونُظهر الأخطاء. وأنت تطلق الميزة.
REST نظيفة ومتوقعة
موارد متوقعة (المنشورات، الحسابات، مساحات العمل، عمليات التسليم، webhooks). شكل واحد ثابت للطلب والاستجابة في كل نقاط النهاية، بإصدار تحت /v1.
حزمة TypeScript SDK، ومكتبة PHP مستقلة
تغلّف TypeScript (npm install @fopost/sdk) هذه الـ REST API. أما PHP (composer require fopost/social-core، برخصة MIT) فمستقلة: تنشر مباشرة على 11 منصة باستخدام بيانات اعتمادك، دون حساب FoPost.
خادم MCP لمساعدي الذكاء الاصطناعي
يربط npx -y @fopost/mcp مساحة عملك في FoPost بـ Claude Desktop وCursor وChatGPT وأي وكيل متوافق مع MCP. 14 أداة متاحة: النشر، والجدولة، والتحليلات، وإدارة الحسابات. المصادقة عبر مفتاح API.
مفاتيح محددة الصلاحيات لكل مساحة عمل
مفاتيح لكل مساحة عمل مع نطاقات للإجراءات: posts وaccounts وworkspaces وlabels وpublish وdeliveries وwebhooks وanalytics وautomations. JWT للواجهة، ومفاتيح API للشيفرة. لا مفتاح شامل على مستوى الوكالة.
webhooks صادرة لكل حدث
اشترك في publish.success وpublish.failed وaccount.disconnected وaccount.reconnected وautomation.triggered وغيرها. كل حمولة موقّعة لتتحقق من أنها جاءت منا، وتُعاد محاولة عمليات التسليم الفاشلة مع تراجع أُسّي.
حدود معدل مصممة للعمل الحقيقي
يقع الحد أعلى بكثير مما يحتاجه تكامل النشر، ويرتفع السقف تلقائيًا كلما ربطت حسابات أكثر. إذا تجاوزته تحصل على استجابة 429 واضحة مع Retry-After لتتراجع بناءً عليها، لا إسقاطًا صامتًا ولا تعليقًا للمفتاح.
أنشئ. ثبّت. انشر.
أنشئ مفتاح API
في مساحة العمل التي تريد النشر منها، أنشئ مفتاح API بالنطاقات التي تحتاجها (posts وaccounts تكفي للبدء). انسخه مرة واحدة. وتعامل معه كسرّ.
ثبّت حزمة SDK
npm install @fopost/sdk. أو تخطَّ حزمة SDK واستدعِ نقاط نهاية REST مباشرة. أو تخطَّ الاثنين واستخدم خادم MCP من Claude.
نفّذ الاستدعاء
ثلاثة أسطر: استيراد، وإنشاء نسخة، وإنشاء منشور. يعيد استدعاء النشر معرّف المنشور وحالة التسليم لكل منصة. يصل المنشور إلى قائمة الانتظار في لوحة التحكم، ويُنشر في الوقت المجدول.
اشترك في webhooks (اختياري)
أضف رابط webhook في إعدادات مساحة العمل. اشترك في publish.success وpublish.failed. تتلقى نقطة النهاية لديك طلب POST موقّعًا عند نجاح كل تسليم أو فشله. والآن يبقى نظامك متزامنًا.
لماذا يتفوق هذا على بناء تكاملات 33 منصة يدويًا.
ثلاث طرق يتعامل بها المطورون مع النشر متعدد المنصات اليوم. واحدة فقط منها API حقيقية مع حزم SDK وخادم MCP، ومع جهة أخرى تتحمل الأعطال.
بنفسك: واجهات API لـ 33 منصة
ما يحاوله المؤسسون التقنيون
- مسار OAuth لكل منصة. تخزين الرموز. تحديث الرموز. التعامل المشفّر مع الأسرار.
- حد معدل مختلف، وشكل أخطاء مختلف، وقيود وسائط مختلفة لكل منصة.
- عندما تغيّر LinkedIn الـ API الخاصة بها، تغيّر أنت شيفرتك. والأمر نفسه مع Bluesky وThreads وHashnode.
- تتوقف عن إضافة المنصات بعد Twitter وLinkedIn. وتبقى الـ 29 الأخرى على قائمة الأمنيات.
API الخاصة بـ Buffer أو Hootsuite
ما تقدمه الأدوات الراسخة
- توجد API عامة لكنها تبدو كفكرة لاحقة. حزم SDK يصونها المجتمع، أحيانًا.
- لا خادم MCP. ربطها بـ Claude أو Cursor يتطلب تكاملًا مخصصًا.
- التسعير لكل مقعد يجعل الـ API مركز تكلفة للوكالات.
API وحزم SDK وMCP من FoPost
ما تريده فعلًا
- مخطط REST واحد يغطي 32 منصة، وإضافة المتصفح تغطي Substack التي لا تملك API للكتابة.
- حزمة TypeScript SDK نتولى صيانتها، ومكتبة PHP برخصة MIT.
- خادم MCP متاح اليوم: npx -y @fopost/mcp في Claude Desktop وCursor وChatGPT.
- مفاتيح محددة النطاق لكل مساحة عمل، وwebhooks موقّعة، وإعادة محاولة مدمجة. ونحن نتحمل الأعطال.
ينشر على كل الشبكات الكبرى