שימוש בכלי רשתות חברתיות ב-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 הרשמי של כל רשת.
הפונקציה מחבילת @ai-sdk/mcp שמסיימת את הקריאה החוזרת של OAuth מתוך serverUrl וה-authorizationCode, ועם callbackState ו-callbackIssuer כשקיימים.
ברירת המחדל של stopWhen ב-generateText, כך שהמודל קורא את תוצאת הכלי רק כש-stopWhen מתיר שלבים נוספים.
מנגנון התעבורה ש-AI SDK ממליץ עליו לייצור. תעבורת stdio שלו מיועדת לשרתים מקומיים בלבד.
משך החיים של אסימון הגישה של שרת MCP של easyCoexistence. אסימון הרענון שלו תקף 60 ימים ומוחלף בכל רענון.
הטקסט המרבי שהודעת 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 בודק אותם בדיוק.
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, כדי שלא יישאר חיבור פתוח.
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 נותנת לסוכנים שאתם בונים עם ה-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 כלולים בתשלום, והשלושה הימים הראשונים בחינם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-