Vercel AI SDK میں سوشل میڈیا ٹولز استعمال کریں: Instagram، TikTok اور مزید
Vercel AI SDK کو easyCoexistence کے MCP سرور سے Instagram، TikTok، Facebook، WhatsApp اور مزید چینلز کے سوشل میڈیا ٹولز ملتے ہیں۔ @ai-sdk/mcp پیکیج کا createMCPClient https://easycoexistence.com/api/mcp سے HTTP کنکشن کھولتا ہے، آپ کا لکھا ہوا OAuthClientProvider سائن اِن سنبھالتا ہے، اور کلائنٹ کے tools() کو generateText یا streamText میں دیا جاتا ہے تاکہ ہر نیٹ ورک کے سرکاری API کے ذریعے پوسٹ شائع کرنا، شیڈول کرنا، کمنٹس اور DMs کا جواب دینا اور انسائٹس پڑھنا ممکن ہو۔
@ai-sdk/mcp کا وہ فنکشن جو serverUrl اور authorizationCode سے OAuth کال بیک مکمل کرتا ہے، ساتھ callbackState اور callbackIssuer جب موجود ہوں۔
generateText کا ڈیفالٹ stopWhen، یعنی ماڈل ٹول کا نتیجہ تبھی پڑھتا ہے جب stopWhen مزید مراحل کی اجازت دے۔
وہ MCP ٹرانسپورٹ جسے AI SDK پروڈکشن کے لیے تجویز کرتا ہے؛ اس کا stdio ٹرانسپورٹ صرف مقامی سرورز کے لیے ہے۔
easyCoexistence MCP ایکسیس ٹوکن کی مدت؛ اس کا ریفریش ٹوکن 60 دن تک چلتا ہے اور ہر ریفریش پر بدل جاتا ہے۔
ایک Instagram DM میں زیادہ سے زیادہ جتنا متن آ سکتا ہے، UTF-8 میں ناپا گیا، اس لیے لہجے والے حروف اور ایموجی زیادہ جگہ لیتے ہیں۔
AI SDK easyCoexistence میں کیسے سائن اِن کرتا ہے؟
ایک OAuthClientProvider کے ذریعے، جسے آپ اپنے اسٹوریج پر نافذ کرتے ہیں اور جسے AI SDK کا auth() فنکشن چلاتا ہے۔ پہلی کال آپ کی ایپ کو easyCoexistence کے ساتھ پبلک کلائنٹ کے طور پر رجسٹر کرتی ہے، PKCE verifier محفوظ کرتی ہے اور redirectToAuthorization کے ذریعے رضامندی کا URL دیتی ہے؛ یہ REDIRECT لوٹاتی ہے اور آپ کا روٹ صارف کو وہاں بھیجتا ہے۔ اس کے بعد easyCoexistence code کے ساتھ آپ کے کال بیک پر ری ڈائریکٹ کرتا ہے، اور authorizationCode کے ساتھ دوسری auth() کال اسے ٹوکنز میں بدل دیتی ہے۔ ٹوکنز محفوظ ہونے کے بعد 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 URL اور provider کے ساتھ۔ tools() سرور کے ٹولز کو AI SDK ٹولز کے طور پر لوٹاتا ہے؛ کام کے مطابق ٹولز ان کے نام سے منتخب کریں اور generateText یا streamText کو دیں۔ stopWhen کو isStepCount سے سیٹ کریں، کیونکہ ڈیفالٹ کے تحت کال ایک مرحلے پر رک جاتی ہے اور ماڈل کبھی نہیں پڑھتا کہ reply_to_comment نے کیا لوٹایا۔ نیٹ ورک کے قواعد instructions میں لکھیں، وہ پیرامیٹر جسے موجودہ ریفرنس ماڈل کے رویے کے لیے استعمال کرتا ہے۔ کلائنٹ کو finally بلاک میں بند کریں، یا 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();
}
}سرورلیس ہوسٹ پر ٹوکن کہاں رہنے چاہئیں؟
ایسی جگہ جو ایک کال سے زیادہ دیر قائم رہے: ڈیٹا بیس کی قطار، Redis یا key-value اسٹور، جس کی کلید آپ کی ایپ کا وہ صارف ہو جس کے ٹوکنز ہیں۔ Vercel یا کسی اور سرورلیس پلیٹ فارم کا فنکشن میموری میں کچھ لیے بغیر شروع ہوتا ہے، اس لیے وہ provider جو ٹوکن کسی ویری ایبل میں رکھتا ہے، کولڈ اسٹارٹ کے بعد صارف کو دوبارہ رضامندی کی اسکرین پر بھیج دیتا ہے۔ ایکسیس ٹوکن ایک گھنٹہ اور ریفریش ٹوکن 60 دن چلتے ہیں، اور ہر استعمال پر نیا ریفریش ٹوکن ملتا ہے، اس لیے وہ ایپ جو 60 دن میں کم از کم ایک بار ٹولز کال کرے سائن اِن رہتی ہے۔ کلائنٹ رجسٹریشن کو ٹوکنز کے ساتھ رکھیں، کیونکہ provider ہر کنکشن پر دونوں پڑھتا ہے۔
کمنٹس اور DMs ایپ تک کیسے پہنچتے ہیں؟
دستخط شدہ POST درخواستوں کے ذریعے روٹ ہینڈلر تک، جسے set_social_webhook_destination کسی اکاؤنٹ کے لیے رجسٹر کرتا ہے، اور پھر Instagram اور Facebook کے کمنٹس، مینشنز اور DMs، اور TikTok کمنٹس اسی تک آتے ہیں۔ ہر باڈی میں platform، account_id، external_id اور entry ہوتے ہیں، یعنی نیٹ ورک کا ایونٹ جیسا بھیجا گیا۔ باڈی کو متن کے طور پر پڑھیں، اکاؤنٹ کے سائننگ سیکرٹ سے X-EC-Signature کی جانچ کریں، اور جلد جواب دیں: easyCoexistence روٹ کو 8 سیکنڈ دیتا ہے اور ہر ایونٹ ایک بار بھیجتا ہے، بغیر ری ٹرائی کے۔ ایونٹ کو قطار میں ڈالیں اور ایک ورکر کو اس کے ساتھ replyToEvent کال کرنے دیں، تاکہ ماڈل کا وقت 8 سیکنڈ میں شمار نہ ہو۔
ہر نیٹ ورک ماڈل کو کیا کرنے دیتا ہے؟
جتنا اکاؤنٹ کا API اجازت دے، جسے instructions میں واضح ہونا چاہیے:
- Instagram: JPEG تصاویر کے ساتھ پوسٹس، Reels اور Stories؛ DM کے جواب صرف ان لوگوں کو جنہوں نے پچھلے 24 گھنٹوں میں لکھا، زیادہ سے زیادہ 1,000 بائٹس میں۔
- Facebook: پیج پوسٹس، کمنٹس کے جواب اور اسی 24 گھنٹے کی مدت میں Messenger کے جواب۔
- TikTok: ویڈیوز اور تصویری پوسٹس؛ کمنٹ کے جواب ہمیشہ عوامی، ویڈیو کی ID بطور
post_id، اور کوئی DM نہیں۔ - WhatsApp: گاہک کے آخری میسج کے 24 گھنٹوں میں
send_message، اور باقی سب کے لیے ٹیمپلیٹ (send_template) کے ذریعے۔ - YouTube اور LinkedIn: صارف کی درخواست پر اپ لوڈز اور پوسٹس، کمنٹ کے جواب اور analytics؛ دونوں ایونٹ آگے نہیں بھیجتے، اس لیے ایپ نئے کمنٹس شیڈول پر پڑھتی ہے۔
عام غلطیاں
- stopWhen کو ڈیفالٹ پر چھوڑنا۔ generateText پہلے مرحلے کے بعد رک جاتا ہے، اس لیے ماڈل reply_to_comment کال کرتا ہے اور کبھی نہیں جانتا کہ جواب گیا یا نہیں؛ isStepCount کے ساتھ چند مرحلوں کی اجازت دیں۔
- سرورلیس ہوسٹ پر ٹوکن ماڈیول کی سطح کے ویری ایبل میں رکھنا۔ اگلے کولڈ اسٹارٹ پر وہ موجود نہیں ہوتے، اور صارف دوبارہ رضامندی کی اسکرین پر پہنچ جاتا ہے؛ انہیں وہاں محفوظ کریں جہاں tokens() اور saveTokens() ڈیٹا بیس تک پہنچیں۔
- easyCoexistence کے redirect URL کو رجسٹر کرنا اور کوئی اور بھیجنا۔ easyCoexistence redirect_uri کو رجسٹریشن سے ہو بہو ملاتا ہے، اس لیے آخر میں سلیش یا مختلف راستہ سائن اِن کو خرابی کے صفحے پر ختم کر دیتا ہے۔
- اکاؤنٹ کی اپنی سرگرمی کا جواب دینا۔ Instagram اکاؤنٹ کے DMs کو ایکوز کے طور پر واپس بھیجتا ہے اور اس کے عوامی جوابات کمنٹس کے طور پر لوٹتے ہیں، اس لیے پرامپٹ ماڈل تک پہنچنے سے پہلے دونوں کو چھوڑ دیں۔
easyCoexistence آپ کے Vercel AI SDK سے بنائے ایجنٹس کو WhatsApp، Instagram، Facebook، TikTok، YouTube، LinkedIn اور مزید چینلز پر گاہکوں تک رسائی دیتا ہے، ہر ایک اس کے سرکاری API کے ذریعے: OAuth سائن اِن کے پیچھے MCP ٹولز، کمنٹس اور DMs کے دستخط شدہ ایونٹس، اور 90 دن تک آگے کی پوسٹنگ قطار، جس کے ہر کنکشن پر 24/7 نگرانی ہوتی ہے۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جوں جوں آپ کنکشن بڑھاتے ہیں قیمت کم ہوتی ہے، پہلے 3 دن مفت۔
اکثر پوچھے جانے والے سوالات
کیا اس کے لیے Next.js یا Vercel ہوسٹنگ درکار ہے؟
نہیں۔ AI SDK Node.js میں چلتا ہے، اس لیے کوئی بھی ہوسٹ جو HTTPS روٹ دے کام کرتا ہے، اور MCP کلائنٹ کو صرف easycoexistence.com تک آؤٹ باؤنڈ HTTPS درکار ہے۔
کیا چیٹ انٹرفیس ٹول کالز کو اسٹریم کر سکتا ہے؟
ہاں۔ وہی ٹولز streamText کو دیں اور MCP کلائنٹ کو اس کے onEnd کال بیک میں بند کریں، جیسا کہ AI SDK اسٹریم شدہ جوابات کے لیے دستاویز کرتا ہے۔
کیا وہی ایپ WhatsApp میسجز کا جواب دے سکتی ہے؟
ہاں۔ نمبر کے ٹولز اسی کلائنٹ سے آتے ہیں: connection_id کے لیے list_numbers، پھر گاہک کے آخری میسج کے 24 گھنٹوں میں send_message۔ انہیں وصول کرنے کا طریقہ AI SDK کی WhatsApp گائیڈ میں ہے۔
AI SDK ایپ کے لیے easyCoexistence کتنے کا ہے؟
فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جوں جوں کنکشن بڑھتے ہیں کم ہوتا ہے، ہر نیٹ ورک پر یکساں۔ MCP سرور اور Partner API اسی میں شامل ہیں، اور پہلے 3 دن مفت ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ