تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

استخدام أدوات وسائل التواصل الاجتماعي في Vercel AI SDK: Instagram وTikTok وغيرهما

تحصل Vercel AI SDK على أدوات للتواصل الاجتماعي لـ Instagram وTikTok وFacebook وWhatsApp وقنوات أخرى من خادم MCP التابع لـ easyCoexistence. تفتح createMCPClient، من الحزمة @ai-sdk/mcp، اتصال HTTP بالعنوان https://easycoexistence.com/api/mcp، ويتولى OAuthClientProvider الذي تكتبه بنفسك تسجيل الدخول، وتُمرَّر الأدوات التي تعيدها tools() الخاصة بالعميل إلى generateText أو streamText للنشر والجدولة والرد على التعليقات والرسائل المباشرة (DM) وقراءة التحليلات عبر واجهة برمجة التطبيقات الرسمية (API) لكل شبكة.

auth()

الدالة في @ai-sdk/mcp التي تُكمل رد النداء لـ OAuth من serverUrl وauthorizationCode، مع callbackState وcallbackIssuer عند وجودهما.

isStepCount(1)

القيمة الافتراضية لـ stopWhen في generateText، فلا يقرأ النموذج نتيجة الأداة إلا إذا سمح stopWhen بخطوات إضافية.

HTTP

نقل MCP الذي توصي به AI SDK للإنتاج، أما نقل stdio فمخصص للخوادم المحلية فقط.

1 hour

مدة صلاحية رمز الوصول لخادم MCP في easyCoexistence، ويدوم رمز التحديث 60 يومًا ويُستبدل في كل تحديث.

1,000 bytes

أقصى حجم نص في رسالة Instagram المباشرة، مقاسًا بترميز UTF-8، فتأخذ الحروف المشكَّلة والرموز التعبيرية حيزًا أكبر منه.

كيف تسجل AI SDK الدخول إلى easyCoexistence؟

عبر OAuthClientProvider تنفّذه فوق تخزينك الخاص، ويقوده دالة auth() في AI SDK. ينشئ الاستدعاء الأول تسجيل التطبيق لدى easyCoexistence كعميل عام، ويحفظ مُحقِّق PKCE، ويعطيك رابط الموافقة عبر redirectToAuthorization؛ فتعيد الدالة القيمة REDIRECT، ويعيد مسارُك المستخدم إلى هذا الرابط. ثم يعيد easyCoexistence توجيهه إلى رد النداء مع المعامل code، ويستبدله استدعاء ثانٍ لـ auth() مع authorizationCode برموز الوصول. وبعد حفظ الرموز تستخدم auth() رمز التحديث للحصول على زوج جديد، دون إعادة المستخدم إلى الموافقة. أبقِ redirectUrl وredirect_uris المسجّلة متطابقتين، لأن easyCoexistence يطابقهما تطابقًا تامًا.

An OAuthClientProvider over your database, with the two routes it needs
import { auth, type OAuthClientProvider } from "@ai-sdk/mcp";

export const MCP_URL = "https://easycoexistence.com/api/mcp";
const CALLBACK = "https://app.example.com/api/easycoexistence/callback";

// db is your own key-value store (Postgres, Redis, Vercel KV); one set of keys per user
export function easyAuth(userId: string): OAuthClientProvider {
  const k = (name: string) => "easycoexistence:" + userId + ":" + name;
  return {
    get redirectUrl() { return CALLBACK; },
    get clientMetadata() {
      return {
        client_name: "Acme app", // shown on easyCoexistence's consent screen
        redirect_uris: [CALLBACK],
        grant_types: ["authorization_code", "refresh_token"],
        response_types: ["code"],
        token_endpoint_auth_method: "none", // easyCoexistence registers public clients
      };
    },
    clientInformation: () => db.get(k("client")),
    saveClientInformation: (info) => db.set(k("client"), info),
    isClientInformationDynamicallyRegistered: async () => Boolean(await db.get(k("client"))),
    tokens: () => db.get(k("tokens")),
    saveTokens: (tokens) => db.set(k("tokens"), tokens),
    saveCodeVerifier: (verifier) => db.set(k("verifier"), verifier),
    codeVerifier: () => db.get(k("verifier")),
    redirectToAuthorization: (url) => db.set(k("sign-in"), url.href),
  };
}

// GET /api/easycoexistence/connect: send the user to the consent screen
export async function connect(userId: string) {
  const result = await auth(easyAuth(userId), { serverUrl: MCP_URL });
  if (result === "AUTHORIZED") return new Response("Already connected");
  return Response.redirect(await db.get("easycoexistence:" + userId + ":sign-in"));
}

// GET /api/easycoexistence/callback: trade the code for tokens
export async function callback(req: Request, userId: string) {
  const code = new URL(req.url).searchParams.get("code");
  if (!code) return new Response("Sign-in was cancelled", { status: 400 });
  await auth(easyAuth(userId), { serverUrl: MCP_URL, authorizationCode: code });
  return Response.redirect("https://app.example.com/settings");
}

كيف تصل الأدوات إلى generateText؟

من createMCPClient مع نقل HTTP، وعنوان easyCoexistence، والمزوّد. تُعيد tools() أدوات الخادم كأدوات AI SDK؛ احتفظ بما تحتاجه المهمة بالاسم ومرّره إلى generateText أو streamText. اضبط stopWhen باستخدام isStepCount، لأن الاستدعاء يتوقف افتراضيًا بعد خطوة واحدة فلا يقرأ النموذج نتيجة reply_to_comment أبدًا. ضع قواعد كل شبكة في instructions، وهو المعامل الذي يستخدمه المرجع الحالي لسلوك النموذج. أغلِق العميل في كتلة finally، أو في رد النداء onEnd الخاص بـ streamText، حتى لا يبقى اتصال مفتوح.

Reply to one forwarded comment or DM with a filtered set of tools
import { createMCPClient } from "@ai-sdk/mcp";
import { generateText, isStepCount, type LanguageModel } from "ai";
import { easyAuth, MCP_URL } from "./easycoexistence-auth";

const REPLY_TOOLS = new Set(["list_social_comments", "reply_to_comment", "hide_comment", "send_social_dm"]);

export async function replyToEvent(userId: string, model: LanguageModel, event: unknown) {
  const mcp = await createMCPClient({
    transport: { type: "http", url: MCP_URL, authProvider: easyAuth(userId) },
  });
  try {
    const tools = Object.fromEntries(
      Object.entries(await mcp.tools()).filter(([name]) => REPLY_TOOLS.has(name)),
    );
    const { text } = await generateText({
      model,
      tools,
      stopWhen: isStepCount(4),
      instructions:
        "Reply to comments and DMs for Acme on the event's account_id. TikTok replies are public " +
        "and need the video ID as post_id. Instagram DMs only go to people who wrote in the last 24 hours.",
      prompt: JSON.stringify(event),
    });
    return text;
  } finally {
    await mcp.close();
  }
}

أين تُحفظ الرموز على مضيف بلا خادم؟

في أي مكان يبقى بعد انتهاء الاستدعاء الواحد: صف في قاعدة بيانات، أو Redis، أو مخزن مفتاح-قيمة، مفتاحه هو المستخدم في تطبيقك الذي تنتمي إليه الرموز. تبدأ الدالة على Vercel أو أي منصة بلا خادم بذاكرة فارغة، فالمزوّد الذي يحفظ الرموز في متغير يعيد المستخدم إلى شاشة الموافقة بعد البدء البارد. تنتهي صلاحية رموز الوصول بعد ساعة، وتدوم رموز التحديث 60 يومًا مع رمز تحديث جديد في كل استخدام، فالتطبيق الذي يستدعي الأدوات مرة واحدة على الأقل خلال 60 يومًا يبقى مسجّل الدخول. احتفظ بتسجيل العميل بجانب الرموز، لأن المزوّد يقرأ الاثنين عند كل اتصال.

كيف تصل التعليقات والرسائل المباشرة إلى التطبيق؟

كطلبات POST موقعة إلى معالج مسار، تسجّله set_social_webhook_destination لحساب، فيستقبل منه تعليقات Instagram وFacebook والإشارات والرسائل المباشرة، وتعليقات TikTok. يحتوي كل جسم على platform وaccount_id وexternal_id وentry، وهو حدث الشبكة كما أُرسل. اقرأ الجسم كنص، وتحقق من X-EC-Signature مقابله بسر التوقيع الخاص بالحساب، واستجب بسرعة: يمنح easyCoexistence المسار مهلة 8 ثوانٍ ويرسل كل حدث مرة واحدة دون إعادة محاولة. ضع الحدث في طابور واترك عاملًا يستدعي replyToEvent به، حتى لا يُحتسب وقت النموذج من مهلة 8 ثوانٍ.

ماذا تتيح كل شبكة للنموذج؟

بقدر ما تسمح به API الخاصة بالحساب، وينبغي أن تُوضحه التعليمات:

  • Instagram: المنشورات والريلز والقصص بصور JPEG؛ والرد على الرسائل المباشرة (DM) للأشخاص الذين كتبوا خلال آخر 24 ساعة فقط، بحد أقصى 1,000 بايت.
  • Facebook: منشورات الصفحة، والرد على التعليقات، والرد على رسائل Messenger خلال 24 ساعة نفسها.
  • TikTok: مقاطع الفيديو ومنشورات الصور؛ الرد على التعليقات علني دائمًا، مع استخدام معرّف الفيديو كـ post_id، ولا رسائل مباشرة.
  • WhatsApp: send_message خلال 24 ساعة من آخر رسالة للعميل، وsend_template لأي شخص آخر.
  • YouTube وLinkedIn: رفع المحتوى ونشره عندما يطلب المستخدم، والرد على التعليقات والتحليلات؛ ولا يرسل أي منهما الأحداث، لذا يقرأ التطبيق التعليقات الجديدة وفق جدول زمني.

الأخطاء الشائعة

  • ترك stopWhen على قيمته الافتراضية. يتوقف generateText بعد الخطوة الأولى، فيستدعي النموذج reply_to_comment ولا يعرف أبدًا هل خرج الرد؛ فاسمح بعدة خطوات عبر الدالة isStepCount المخصصة لذلك.
  • حفظ الرموز في متغير على مستوى الوحدة على مضيف بلا خادم. تبدأ البدايات الباردة التالية بلا شيء، فيعود المستخدم إلى شاشة الموافقة من جديد؛ احفظها حيث تصل tokens() وsaveTokens() إلى قاعدة بيانات.
  • تسجيل عنوان إعادة توجيه واحد وإرسال عنوان آخر. يطابق easyCoexistence redirect_uri مع التسجيل تمامًا، فشرطة مائلة زائدة في النهاية أو مسار مختلف ينهي تسجيل الدخول بصفحة خطأ.
  • الرد على نشاط الحساب نفسه. يعيد Instagram رسائل الحساب المباشرة كأصداء، وتعود ردوده العلنية كتعليقات، لذا تجاهل الاثنين قبل أن تصل الرسالة إلى النموذج.
إنجاز ذلك باستخدام EasyCoexistence

تمنح easyCoexistence الوكلاء الذين تبنيهم بـ Vercel AI SDK وصولًا إلى العملاء عبر WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى، كلٌّ منها عبر واجهة API الرسمية الخاصة به: أدوات MCP خلف تسجيل دخول OAuth، وأحداث موقعة للتعليقات والرسائل المباشرة، وجدولة منشورات حتى 90 يومًا مقدمًا، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل يحتاج هذا إلى Next.js أو استضافة Vercel؟

لا. يعمل AI SDK على Node.js، لذا تنفع أي منصة تخدم مسار HTTPS، ويحتاج عميل MCP فقط إلى اتصال HTTPS صادر نحو النطاق easycoexistence.com فقط.

هل تستطيع واجهة الدردشة بث استدعاءات الأدوات؟

نعم. مرّر الأدوات نفسها إلى streamText وأغلِق عميل MCP في رد النداء onEnd الخاص بها، كما توثق AI SDK للردود المبثوثة.

هل يستطيع التطبيق نفسه الرد على رسائل WhatsApp؟

نعم. تأتي أدوات الرقم عبر العميل نفسه: list_numbers للحصول على connection_id، ثم send_message خلال 24 ساعة من آخر رسالة للعميل. ويغطي دليل AI SDK لـ WhatsApp استقبال الرسائل.

كم تكلّف easyCoexistence لتطبيق AI SDK؟

من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض مع إضافة الاتصالات، وبالقيمة نفسها على كل شبكة. يشمل ذلك خادم MCP وPartner API، والأيام الثلاثة الأولى مجانًا.

تابع القراءة

أدوات Instagram وTikTok وWhatsApp لوكيل LangChainامنح وكيل LangChain أدوات MCP من easyCoexistence عبر OAuth للنشر والجدولة على Instagram وTikTok، والرد على تعليقاتهما، والإجابة عن الرسائل في Instagram وWhatsApp.امنح وكيل OpenAI Agents SDK أدوات Instagram وTikTok وWhatsAppاربط وكيل OpenAI Agents SDK بخادم MCP الخاص بـ easyCoexistence عبر OAuth لنشر المحتوى وجدولته والرد على Instagram وTikTok وWhatsApp وغيرها.بناء وكيل على WhatsApp باستخدام Vercel AI SDKاستقبل رسائل WhatsApp في route handler، وأجب عنها عبر Vercel AI SDK، واستخدم أدوات EasyCoexistence MCP عبر OAuth على Cloud API الرسمية.النشر على Instagram وTikTok وFacebook من Node.js عبر واجهة برمجة تطبيقات (API) واحدةانشر وجدول وترد على Instagram وFacebook وTikTok وYouTube وLinkedIn من Node.js وTypeScript باستخدام fetch، مع أدوات MCP لوكيلك.خطافات الويب (webhook) لوسائل التواصل الاجتماعي: التعليقات والإشارات والرسائل إلى نقطة النهاية (endpoint) واحدةتصلك تعليقات Instagram و Facebook وإشاراتهما ورسائلهما المباشرة، وتعليقات TikTok، إلى نقطة نهايتك لحظة حدوثها، في مظروف واحد موقّع لكل حساب.خادم MCP للتواصل الاجتماعي لـ Claude وChatGPTموصل MCP واحد لكل الشبكات: يتيح لـ Claude وChatGPT النشر والجدولة والرد على التعليقات والرسائل الخاصة وقراءة التحليلات عبر واجهات رسمية.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في