התחברותהתחילו תקופת ניסיון
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

מנגנון התעבורה ש-AI SDK ממליץ עליו לייצור. תעבורת stdio שלו מיועדת לשרתים מקומיים בלבד.

1 hour

משך החיים של אסימון הגישה של שרת MCP של easyCoexistence. אסימון הרענון שלו תקף 60 ימים ומוחלף בכל רענון.

1,000 bytes

הטקסט המרבי שהודעת DM אחת של Instagram נושאת, במדידת UTF-8, כך שתווים עם סימנים ואמוג'י תופסים ממנה יותר.

כיצד ה-AI SDK מתחבר ל-easyCoexistence?

דרך OAuthClientProvider שאתם מממשים מעל האחסון שלכם, ופועלת בעזרת הפונקציה auth() של ה-AI SDK. הקריאה הראשונה רושמת את האפליקציה שלכם אצל easyCoexistence כלקוח ציבורי, שומרת את ה-PKCE verifier ומעבירה לכם את כתובת ההסכמה דרך redirectToAuthorization. היא מחזירה REDIRECT, והנתיב שלכם שולח אליה את המשתמש. לאחר מכן easyCoexistence מפנה אתכם חזרה לכתובת ה-callback עם 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, או ב-callback של streamText בשם onEnd, כדי שלא יישאר חיבור פתוח.

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();
  }
}

היכן צריכים האסימונים להישמר בשרת serverless?

בכל מקום שחי מעבר לקריאה אחת: שורה במסד נתונים, Redis או חנות מפתח-ערך, לפי המשתמש באפליקציה שלכם שהאסימונים שייכים לו. פונקציה ב-Vercel או בפלטפורמה serverless אחרת מתחילה בלי דבר בזיכרון, כך שספק ששומר אסימונים במשתנה מחזיר את המשתמש למסך ההסכמה לאחר הפעלה קרה. אסימוני גישה תקפים לשעה ואסימוני רענון ל-60 ימים, וכל שימוש באסימון רענון מייצר אסימון חדש. לכן אפליקציה שקוראת לכלים לפחות פעם ב-60 ימים נשארת מחוברת. שמרו את רישום הלקוח לצד האסימונים, כי הספק קורא את שניהם בכל חיבור.

כיצד תגובות ו-DM מגיעים לאפליקציה?

כ-POST חתומים לנתיב route handler, שאותו set_social_webhook_destination רושם לחשבון. הנתיב מקבל אחר כך תגובות, אזכורים והודעות DM של Instagram ו-Facebook, וכן תגובות TikTok. כל גוף מכיל platform, account_id, external_id ו-entry, האירוע של הרשת כפי שנשלח. קראו את הגוף כטקסט, בדקו את X-EC-Signature מולו עם סוד החתימה של החשבון, והגיבו מהר. easyCoexistence נותנת לנתיב 8 שניות ושולחת כל אירוע פעם אחת, בלי ניסיון חוזר. הכניסו את האירוע לתור ותנו לעובד לקרוא ל-replyToEvent עם האירוע, כך שזמן המודל לעולם לא נספר מתוך 8 השניות.

מה כל רשת מאפשרת למודל לעשות?

כל מה שה-API של החשבון מאפשר, ומה שההוראות צריכות לפרט:

  • Instagram: פוסטים, Reels ו-Stories עם תמונות JPEG. תשובות DM רק לאנשים שכתבו בתוך 24 השעות האחרונות, עד 1,000 בייט.
  • Facebook: פוסטים בדף, תשובות לתגובות ותשובות ב-Messenger באותן 24 שעות.
  • TikTok: סרטונים ופוסטים של תמונות. תשובות לתגובות תמיד ציבוריות, עם מזהה הסרטון כ-post_id, ואין DM.
  • WhatsApp: send_message עד 24 שעות מההודעה האחרונה של הלקוח, ו-send_template לכל מי שאינו בחלון הזה.
  • YouTube ו-LinkedIn: העלאות ופרסומים כשמשתמש מבקש, תשובות לתגובות וניתוחים. אף אחת מהן אינה מעבירה אירועים, ולכן האפליקציה קוראת תגובות חדשות לפי לוח זמנים.

טעויות נפוצות

  • השארת stopWhen בברירת המחדל. generateText עוצר אחרי השלב הראשון, כך שהמודל קורא ל-reply_to_comment ואינו יודע אם התגובה יצאה. אפשרו מספר שלבים עם isStepCount.
  • שמירת אסימונים במשתנה ברמת המודול בשרת serverless. ההפעלה הקרה הבאה לא תשאיר שום דבר, והמשתמש חוזר למסך ההסכמה. שמרו אותם במקום שאליו tokens() ו-saveTokens() מגיעים, כמו מסד נתונים.
  • רישום כתובת הפניה אחת ושליחת אחרת. easyCoexistence בודקת את redirect_uri מול הרישום במדויק, כך שלוכסן בסוף או נתיב שונה מסיים את ההתחברות בדף שגיאה.
  • מענה לפעילות של החשבון עצמו. Instagram שולח בחזרה את ההודעות של החשבון כהדים (echo), והתשובות הציבוריות שלו חוזרות כתגובות. דלגו על שניהם לפני שההנחיה מגיעה למודל.
עושים את זה עם EasyCoexistence

easyCoexistence נותנת לסוכנים שאתם בונים עם ה-Vercel AI SDK גישה ללקוחות ב-WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn וערוצים נוספים, כל אחד דרך ה-API הרשמי שלו: כלי MCP מאחורי התחברות OAuth, אירועים חתומים לתגובות ול-DM, ותור פרסום עד 90 ימים קדימה, כשכל חיבור נמצא במעקב 24/7. US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם זה דורש Next.js או אירוח ב-Vercel?

לא. ה-AI SDK רץ ב-Node.js, כך שכל אירוח שמגיש נתיב HTTPS עובד. לקוח ה-MCP צריך רק חיבור HTTPS יוצא לכתובת easycoexistence.com בלבד.

האם ממשק צ'אט יכול להזרים את קריאות הכלים?

כן. מעבירים את אותם כלים ל-streamText וסוגרים את לקוח ה-MCP ב-callback בשם 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 כלולים בתשלום, והשלושה הימים הראשונים בחינם.

המשיכו לקרוא

תנו לסוכן LangChain גישה לכלי Instagram, TikTok ו-WhatsAppתנו לסוכן LangChain גישה ל-MCP של easyCoexistence מעל OAuth כדי לפרסם ולתזמן ב-Instagram וב-TikTok, להשיב לתגובות שלהן ולענות ב-Instagram וב-WhatsApp להודעות ישירות.כלים ל-Instagram, ל-TikTok ול-WhatsApp עבור סוכן OpenAI Agents SDKחברו סוכן OpenAI Agents SDK אל שרת MCP של easyCoexistence דרך OAuth, כדי לפרסם, לתזמן ולהשיב ב-Instagram, TikTok, WhatsApp ועוד.בניית סוכן WhatsApp עם Vercel AI SDKמקבלים הודעות WhatsApp ב-route handler, עונים עליהן עם Vercel AI SDK ומחברים כלי MCP של EasyCoexistence עם OAuth מעל Cloud API הרשמיפרסום ל-Instagram, TikTok ו-Facebook מ-Node.js באמצעות ממשק API אחדפרסום, תזמון ומענה ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Node.js וגם TypeScript עם fetch, וכלי MCP לסוכן שלכם.וובהוקים לרשתות חברתיות (Webhooks): תגובות, אזכורים והודעות לנקודת קצה אחתתגובות, אזכורים והודעות ישירות מ-Instagram ומ-Facebook, וכן תגובות מ-TikTok, נשלחות לנקודת הקצה שלכם מיד, בעטיפה אחת חתומה לכל חשבון.שרת MCP לרשתות חברתיות עבור Claude ו-ChatGPTמחבר MCP אחד לכל רשת: Claude או ChatGPT מפרסמים, מתזמנים, מגיבים לתגובות ולהודעות DM וקוראים אנליטיקה, דרך ממשקי API רשמיים.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-