النشر على Instagram وTikTok وFacebook من Node.js عبر واجهة برمجة تطبيقات (API) واحدة
مع easyCoexistence، ينشر الخادم الخلفي المبني على Node.js أو TypeScript على Instagram وFacebook وTikTok وYouTube وLinkedIn عبر API الرسمية لكل شبكة. يسجّل أصحاب الحسابات الدخول مرة واحدة عبر رابط مستضاف، ثم يُعيد طلب fetch واحد رمز الوصول (token) الجديد لكل مهمة على TikTok وYouTube وLinkedIn، وتنقل الأحداث الموقّعة التعليقات والرسائل المباشرة إلى مسارك. ويحصل الوكلاء المبنيون على TypeScript MCP SDK على الحسابات نفسها كأدوات.
الحد الذي تقبله نقطة النهاية (endpoint) للنشر في TikTok لمنشورات الفيديو لكل حساب، بما لا يزيد على ستة في الدقيقة.
المدة التي يمكن جدولة منشور صفحة Facebook قبلها باستخدام published false وscheduled_publish_time.
ترويسة الاستجابة التي تحمل URN منشور LinkedIn الجديد، وتُرسل مع الحالة 201.
المدة التي يُطلق فيها TikTok حدث comment.update بعد إنشاء تعليق أو حذفه أو تغيير ظهوره.
المدة التي يبقى فيها رابط الربط في Partner API مفتوحاً قبل انتهاء صلاحية الجلسة.
كيف يربط الخادم الخلفي المبني على Node.js الحسابات ويحصل على tokens الخاصة بها؟
يفتح الخادم الخلفي جلسة ربط، ويُكمل مالك الحساب العملية في المتصفح. يُرسل طلب POST إلى /connect-sessions، ومعه مفتاح ec_live_ بوصفه bearer token، وقناة مثل tiktok أو linkedin، وredirect_url، وexternal_ref لعميلك، فيُعيد عنواناً URL على easycoexistence.com. هناك يسجّل المالك الدخول عبر شاشة الموافقة الخاصة بالشبكة نفسها، ويعود إلى redirect_url الخاص بك مع status=connected وchannel_id. ويمكن إعادة محاولة العملية الملغاة من الرابط نفسه حتى انتهائه، أي بعد ساعة من إنشائه.
ثم تبدأ كل مهمة بالطلب GET /channels/{id}?credentials=1. تتضمن الاستجابة token صالحاً الآن (ليس على Instagram وFacebook، اللذين لا تُسلَّم رموزهما أبداً)، إلى جانب الحقول التي تحتاجها كل شبكة: graph_api_base وaccount_id_on_meta على Instagram وFacebook، وapi_base وbusiness_id على TikTok، وchannel_id على YouTube، وauthor_urn وrequired_headers على LinkedIn. تُرسل الأحداث الموقّعة channel.connected وchannel.disconnected وchannel.removed وchannel.suspended إلى عنوان الأحداث المحدَّد في لوحة التحكم، فتُخبر تطبيقك متى يتغيّر حساب ما.
const EC = "https://easycoexistence.com/api/v1";
const KEY = { Authorization: `Bearer ${process.env.EC_API_KEY}` }; // ec_live_...
type Network = "instagram" | "facebook" | "tiktok" | "youtube" | "linkedin";
// A hosted sign-in link for one of your customers on one network
export async function connectLink(customerId: string, channel: Network): Promise<string> {
const r = await fetch(`${EC}/connect-sessions`, {
method: "POST",
headers: { ...KEY, "Content-Type": "application/json" },
body: JSON.stringify({
channel,
redirect_url: "https://app.example.com/connected",
external_ref: customerId,
}),
});
const session = (await r.json()) as { url: string; error?: { message: string } };
if (!r.ok) throw new Error(session.error?.message);
return session.url; // they come back with ?session=...&status=connected&channel_id=...
}
// At the start of every job: the API base and a token that is valid now
export async function credentials(channelId: string) {
const r = await fetch(`${EC}/channels/${channelId}?credentials=1`, { headers: KEY });
const body: any = await r.json(); // the credential fields differ by network
if (!r.ok) throw new Error(body.error.message);
if (!body.credentials.access_token) throw new Error(body.credentials.note);
return body.credentials;
}كيف تنشر على Instagram وFacebook من Node.js؟
تنشر Instagram عبر حاوية. لإنشاء Reel، أنشئ الحاوية بـ media_type REELS وvideo_url والتعليق، واستعلم عن status_code حتى تظهر القيمة FINISHED، ثم استدعِ media_publish مع معرّف الحاوية بوصفه creation_id. توصي Meta بالاستعلام مرة كل دقيقة تقريباً، والتوقف بعد خمس دقائق؛ وتعني القيمة ERROR أو EXPIRED أن الحاوية لن تُنشر، والحاوية التي تبقى غير منشورة 24 ساعة تنتهي صلاحيتها تلقائياً.
تنشر صفحة Facebook صورة بطلب واحد إلى /{page-id}/photos، مع عنوان URL الخاص بالصورة والتعليق، بينما تُرسل النصوص والروابط إلى /{page-id}/feed. يقبل الطلبان published false مع scheduled_publish_time، وتنشر Meta المنشور بنفسها عند حلول الوقت، وذلك بين 10 دقائق و30 يوماً مسبقاً. يُرسل token بوصفه ترويسة bearer، وتتضمن graph_api_base إصدار Graph API أصلاً، ويجب أن تكون الوسائط على عنوان URL عام، تقوم Meta بتنزيله.
type Meta = { graph_api_base: string; access_token: string };
async function graph(c: Meta, path: string, body?: object) {
const r = await fetch(`${c.graph_api_base}/${path}`, {
method: body ? "POST" : "GET",
headers: { Authorization: `Bearer ${c.access_token}`, "Content-Type": "application/json" },
body: body && JSON.stringify(body),
});
const data: any = await r.json();
if (!r.ok) throw new Error(data.error?.message ?? `Graph API ${r.status}`);
return data;
}
export async function postReel(channelId: string, videoUrl: string, caption: string) {
const c = await credentials(channelId);
const ig = c.account_id_on_meta;
const { id } = await graph(c, `${ig}/media`, { media_type: "REELS", video_url: videoUrl, caption });
for (let check = 0; check < 5; check++) {
await new Promise((wake) => setTimeout(wake, 60_000)); // about once a minute, as Meta advises
const { status_code } = await graph(c, `${id}?fields=status_code`);
if (status_code === "FINISHED") return graph(c, `${ig}/media_publish`, { creation_id: id });
if (status_code === "ERROR" || status_code === "EXPIRED") throw new Error(`Reel container ${status_code}`);
}
throw new Error("The Reel is still processing after five minutes");
}
export async function schedulePagePhoto(channelId: string, url: string, caption: string, at: Date) {
const c = await credentials(channelId);
return graph(c, `${c.account_id_on_meta}/photos`, {
url,
caption,
published: false,
scheduled_publish_time: Math.floor(at.getTime() / 1000), // 10 minutes to 30 days ahead
});
}كيف تنشر على LinkedIn وترفع إلى YouTube من Node.js؟
تطلب LinkedIn ترويستين إضافيتين إلى جانب bearer token في كل طلب: LinkedIn-Version، بالقيمة YYYYMM التي تُعيدها easyCoexistence في required_headers، وX-Restli-Protocol-Version بقيمة 2.0.0. المنشور طلب POST إلى /rest/posts، مع URN الكاتب، والنص بوصفه commentary، وPUBLIC بوصفه visibility، والخلاصة الرئيسية في distribution، وlifecycleState بقيمة PUBLISHED. تُجيب LinkedIn بالحالة 201 وتضع URN المنشور الجديد في الترويسة x-restli-id، ويُرمَّز أي URN يُوضع في مسار URL ترميزاً صالحاً للعناوين.
يستغرق YouTube طلبين. يُرسل طلب POST إلى endpoint الرفع مع uploadType=resumable وpart=snippet,status البيانات الوصفية، ويُعيد عنوان الجلسة في ترويسته Location؛ ثم يُرسَل PUT ببايتات الملف إلى ذلك العنوان، فيُعيد مورد الفيديو مع معرّفه id. ورفع الفيديو بوصفه private مع تاريخ publishAt يترك النشر لمُجدول YouTube الخاص، فلا يحتاج أي شيء منك إلى العمل في تلك الساعة.
import { readFile } from "node:fs/promises";
export async function postOnLinkedIn(channelId: string, text: string) {
const c = await credentials(channelId);
const r = await fetch(`${c.api_base}/posts`, {
method: "POST",
headers: {
Authorization: `Bearer ${c.access_token}`,
"LinkedIn-Version": c.required_headers["LinkedIn-Version"],
"X-Restli-Protocol-Version": "2.0.0",
"Content-Type": "application/json",
},
body: JSON.stringify({
author: c.author_urn, // urn:li:organization:... or urn:li:person:...
commentary: text,
visibility: "PUBLIC",
distribution: { feedDistribution: "MAIN_FEED", targetEntities: [], thirdPartyDistributionChannels: [] },
lifecycleState: "PUBLISHED",
isReshareDisabledByAuthor: false,
}),
});
if (r.status !== 201) throw new Error(`LinkedIn ${r.status}: ${await r.text()}`);
return r.headers.get("x-restli-id"); // the new post's URN
}
export async function scheduleOnYouTube(channelId: string, file: string, title: string, publishAt: string) {
const c = await credentials(channelId);
const auth = { Authorization: `Bearer ${c.access_token}` };
const start = await fetch(
"https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status",
{
method: "POST",
headers: { ...auth, "Content-Type": "application/json; charset=UTF-8", "X-Upload-Content-Type": "video/mp4" },
body: JSON.stringify({
snippet: { title },
status: { privacyStatus: "private", publishAt, selfDeclaredMadeForKids: false },
}),
},
);
const session = start.headers.get("location");
if (!start.ok || !session) throw new Error(`YouTube ${start.status}: ${await start.text()}`);
const done = await fetch(session, {
method: "PUT",
headers: { ...auth, "Content-Type": "video/mp4" },
body: await readFile(file),
});
const video = (await done.json()) as { id: string };
return video.id;
}كيف تستقبل التعليقات والرسائل المباشرة في مسار Node.js؟
تُعيد كل قناة التوجيه إلى العنوان URL الذي تحدده عبر PUT /channels/{id}/webhook، ويُعيد هذا الطلب signing_secret الخاص بالقناة مرة واحدة فقط. كل تسليم هو طلب POST يحمل platform وaccount_id وexternal_id وentry، مع ترويسة X-EC-Signature بالصيغة t=<unix>,v1=<hex>، حيث v1 هو HMAC-SHA256 للقيمة t ونقطة ثم الجسم الخام. خذ الجسم نصاً قبل تحليله، وارفض أي t أقدم من خمس دقائق، وقارن باستخدام timingSafeEqual.
بالنسبة إلى Instagram وFacebook، يكون entry هو إدخال خطاف الويب (webhook) من Meta كما أرسلته Meta: changes للتعليقات والإشارات، وmessaging للرسائل المباشرة. أما TikTok فيحوي حدث comment.update، الذي يُطلقه TikTok خلال خمس دقائق من إنشاء التعليق، مع comment_id وvideo_id كنصوص، حتى لا تُقرّب JavaScript هذه الأرقام ذات 64 بت. هناك محاولة واحدة لكل حدث دون نسخة محفوظة، لذا أجب بالرمز 204 فوراً، وعالج الحدث من قائمة انتظار.
import { createHmac, timingSafeEqual } from "node:crypto";
const secrets = new Map<string, string>(); // channel id -> signing_secret, kept in your database
export async function forwardEvents(channelId: string, url: string) {
const r = await fetch(`${EC}/channels/${channelId}/webhook`, {
method: "PUT",
headers: { ...KEY, "Content-Type": "application/json" },
body: JSON.stringify({ url }),
});
const body = (await r.json()) as { signing_secret: string; error?: { message: string } };
if (!r.ok) throw new Error(body.error?.message);
secrets.set(channelId, body.signing_secret); // returned only this once
}
function verify(raw: string, header: string | null, secret: string): boolean {
const parts = Object.fromEntries((header ?? "").split(",").map((kv) => kv.split("=", 2)));
const t: string = parts.t ?? "";
const v1: string = parts.v1 ?? "";
if (!/^[0-9]+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const mac = createHmac("sha256", secret).update(`${t}.${raw}`).digest("hex");
return mac.length === v1.length && timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}
// POST /hooks/social as a web-standard handler (Next.js, Hono, Bun and others)
export async function POST(req: Request) {
const raw = await req.text(); // the signature covers these exact bytes
const event = JSON.parse(raw); // { platform, account_id, external_id, entry }
const secret = secrets.get(event.account_id);
if (!secret || !verify(raw, req.headers.get("x-ec-signature"), secret)) {
return new Response("invalid signature", { status: 401 });
}
await enqueue(event); // one attempt per event and no retries: acknowledge first
return new Response(null, { status: 204 });
}كيف ترد على التعليقات والرسائل المباشرة من Node.js؟
باستدعاء credentials جديد، واستخدام المعرّفات الواردة في الحدث. على Instagram وFacebook، يُرسل رد الرسالة المباشرة إلى /{account-id}/messages باستخدام account_id_on_meta، مع معرّف المُرسِل بوصفه recipient، وخلال 24 ساعة من آخر رسالة له. وتضيف الصفحة messaging_type بقيمة RESPONSE، ويسمح Instagram بحد أقصى 1,000 بايت من النص. ويُرد على التعليق بردّ عام، عبر /{comment-id}/replies على Instagram أو /{comment-id}/comments على Facebook، أو بردّ خاص واحد خلال 7 أيام.
تبقى محادثات TikTok عامة، لأنه لا توجد رسائل مباشرة على TikTok. يُرسل الطلب إلى business/comment/reply/create/ مع ترويسة Access-Token وbusiness_id وvideo_id وcomment_id، فينشر رداً يصل إلى 1,200 حرف. اقرأ حقل code في الاستجابة، حيث تعني القيمة 0 النجاح، بدلاً من حالة HTTP. تصرّف فقط عند comment_action بقيمة insert مع comment_type بقيمة comment، لأن ردودك أنت تصل كأحداث أيضاً.
export async function reply(event: any, text: string) {
const c = await credentials(event.account_id);
if (event.platform === "tiktok") {
const e = event.entry.content; // the comment.update event, ids as strings
if (e.comment_action !== "insert" || e.comment_type !== "comment") return; // your replies arrive as "reply"
const r = await fetch(`${c.api_base}/business/comment/reply/create/`, {
method: "POST",
headers: { "Access-Token": c.access_token, "Content-Type": "application/json" },
body: JSON.stringify({ business_id: c.business_id, video_id: e.video_id, comment_id: e.comment_id, text }),
});
const out = (await r.json()) as { code: number; message: string };
if (out.code !== 0) throw new Error(out.message); // 0 is success, whatever the HTTP status
} else if (event.platform === "facebook") {
for (const m of event.entry.messaging ?? []) {
if (!m.message || m.message.is_echo) continue; // only what people sent the Page
await graph(c, `${c.account_id_on_meta}/messages`, {
recipient: { id: m.sender.id },
messaging_type: "RESPONSE", // within 24 hours of their last message
message: { text },
});
}
}
}كيف تنشر على TikTok وتمنح وكيل TypeScript هذه الأدوات؟
يمر الاثنان عبر خادم MCP الخاص بـ easyCoexistence على https://easycoexistence.com/api/mcp، الذي يقبل OAuth 2.1 فقط: تسجيل العميل الديناميكي، ورمز التفويض مع PKCE، وtokens وصول تدوم ساعة، وtokens تحديث. مع @modelcontextprotocol/client، وهو TypeScript SDK الرسمي لـ Node 20 والإصدارات الأحدث، يحتفظ OAuthClientProvider بالعميل والـ tokens وverifier الخاص بـ PKCE؛ يُرسل الاتصال الأول المستخدم إلى تسجيل الدخول ويُطلق UnauthorizedError، ويُكمل finishAuth العملية باستخدام query الخاص بـ callback.
يوجد نشر TikTok هنا لأن TikTok ينزّل الوسائط فقط من بادئات عنوان URL مُتحقَّق منها لتطبيق المطوّر المرتبط بهذا token. يأخذ publish_tiktok_post رابط HTTPS الخاص بك، ويمنح TikTok عنواناً موقّعاً على مسار الوسائط المُتحقَّق الخاص بـ easyCoexistence، ويتابع get_tiktok_publish_status المنشور. ويمنح العميل نفسه الوكيل كل الأدوات الخاصة بشبكات الحساب؛ استدعِ list_social_accounts أولاً، فالقيمة account_id فيه هي معرّف القناة في Partner API الخاص بك.
import { createInterface } from "node:readline/promises";
import { Client, StreamableHTTPClientTransport, UnauthorizedError, type OAuthClientProvider } from "@modelcontextprotocol/client";
const MCP = new URL("https://easycoexistence.com/api/mcp");
const saved: Record<string, any> = {}; // persist this, so the browser sign-in happens once
const provider: OAuthClientProvider = {
redirectUrl: "http://localhost:8090/callback",
clientMetadata: { client_name: "My social agent", redirect_uris: ["http://localhost:8090/callback"] },
state: () => (saved.state = crypto.randomUUID()),
clientInformation: () => saved.client,
saveClientInformation: (info) => { saved.client = info; },
tokens: () => saved.tokens,
saveTokens: (tokens) => { saved.tokens = tokens; },
saveCodeVerifier: (verifier) => { saved.verifier = verifier; },
codeVerifier: () => saved.verifier,
redirectToAuthorization: (url) => console.log("Sign in to easyCoexistence:", url.href),
};
const client = new Client({ name: "my-social-agent", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(MCP, { authProvider: provider });
try {
await client.connect(transport);
} catch (error) {
if (!(error instanceof UnauthorizedError)) throw error;
const rl = createInterface({ input: process.stdin, output: process.stdout });
const back = new URL(await rl.question("Paste the address you were sent back to: ")).searchParams;
rl.close();
if (back.get("state") !== saved.state) throw new Error("state mismatch");
await transport.finishAuth(back);
await client.connect(new StreamableHTTPClientTransport(MCP, { authProvider: provider }));
}
const result = await client.callTool({
name: "publish_tiktok_post",
arguments: {
account_id: process.env.TIKTOK_CHANNEL_ID, // the Partner API channel id
video_url: "https://cdn.example.com/launch.mp4",
caption: "New drop #behindthescenes",
},
});
console.log(result.content); // a share_id to follow with get_tiktok_publish_statusالأخطاء الشائعة
- حساب HMAC على JSON بعد تحليله وإعادة تسلسله. يغطي التوقيع الجسم الخام بايتاً بايت، لذا استدعِ req.text() أولاً ثم حلّله بعد ذلك، وإلا فشل كل تسليم في التحقق.
- تحويل معرّفات TikTok إلى أرقام. معرّفات التعليقات والفيديوهات 64 بت، وNumber() يقرّبها، لذا احتفظ بالنصوص التي يحملها الحدث عند الرد على التعليق أو البحث عنه.
- الاكتفاء بـ channel_id من إعادة التوجيه. يمكن أن يضيف تسجيل الدخول عبر Facebook أو LinkedIn عدة صفحات دفعة واحدة، لذا اعرضها بالطلب GET /channels?external_ref= واحفظ كل واحدة منها.
- الرد على رسالة Messenger أو Instagram المباشرة من دفعة ليلية. خارج 24 ساعة من آخر رسالة للشخص يفشل الإرسال، لذا ردّ من معالج الحدث أثناء بقاء النافذة مفتوحة.
تمنح easyCoexistence الخوادم الخلفية المبنية على Node.js والوكلاء الذكيين وصولاً إلى العملاء على WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى، عبر API الرسمية لكل منها. اربط الحسابات عبر Partner API، واحصل على tokens جديدة وأحداث موقّعة، ودع وكلاء TypeScript يتصرفون عبر خادم MCP، مع مراقبة كل اتصال 24/7. من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية لأول 3 أيام.
الأسئلة الشائعة
هل أحتاج إلى SDK لاستدعاء هذه APIs من Node؟
لا. تعمل Partner API وواجهات الشبكات كطلبات HTTPS عادية، لذلك تكفي دالة fetch العامة في Node 18 وما بعده. يُضاف @modelcontextprotocol/client فقط عند استخدام أدوات MCP، ومنها ما ينشر عبر TikTok وغيرها.
لماذا يمر النشر على TikTok عبر خادم MCP الخاص بالمنصة؟
ينزّل TikTok الفيديوهات والصور فقط من نطاق أو بادئة عنوان URL مُتحقَّق منها لتطبيق المطوّر، وهذا التطبيق يخص easyCoexistence. يخدم publish_tiktok_post ملفك عبر HTTPS من ذلك العنوان المُتحقَّق، لذا لا يحتاج نطاقك الخاص إلى تحقق.
هل يمكن لتسجيل دخول واحد ربط عدة صفحات Facebook أو LinkedIn؟
نعم. تصبح كل صفحة، وعلى LinkedIn ملف العضو الشخصي نفسه، قناةً مستقلة واتصالاً مستقلاً. تحمل إعادة التوجيه أول channel_id، ويعرض GET /channels?external_ref= كل القنوات.
كم تكلفة easyCoexistence لمشروع Node.js لدي؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ينخفض كلما أضفت اتصالات، وبالتسعير نفسه على كل شبكة. تشمل الخطة Partner API وموصل MCP دون تسعير لكل مستخدم، وتتوفر فترة تجريبية مجانية لأول 3 أيام.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في