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 में डालकर हर नेटवर्क के आधिकारिक एपीआई के ज़रिए पोस्ट करना, शेड्यूल करना, कमेंट और DM का जवाब देना और इनसाइट्स पढ़ना संभव होता है।
@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 के ज़रिए सहमति यूआरएल देती है; यह REDIRECT लौटाती है, और आपका रूट यूज़र को वहाँ भेजता है। फिर easyCoexistence कोड के साथ आपके कॉलबैक पर रीडायरेक्ट करता है, और 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 तक कैसे पहुँचते हैं?
HTTP ट्रांसपोर्ट वाले createMCPClient से, easyCoexistence यूआरएल और प्रोवाइडर के साथ। 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 या की-वैल्यू स्टोर, जिसकी कुंजी आपके ऐप के उस यूज़र से हो जिसके टोकन हैं। Vercel या किसी अन्य सर्वरलेस प्लेटफ़ॉर्म पर फ़ंक्शन मेमोरी में कुछ नहीं लेकर शुरू होता है, इसलिए जो प्रोवाइडर टोकन किसी वेरिएबल में रखता है, कोल्ड स्टार्ट के बाद यूज़र को फिर सहमति स्क्रीन पर भेज देता है। एक्सेस टोकन एक घंटा चलते हैं और रिफ्रेश टोकन 60 दिन, और हर इस्तेमाल पर नया रिफ्रेश टोकन मिलता है, इसलिए जो ऐप 60 दिन में कम से कम एक बार टूल्स चलाता है, उसका लॉग इन बना रहता है। क्लाइंट रजिस्ट्रेशन को टोकन के साथ रखें, क्योंकि प्रोवाइडर हर कनेक्शन पर दोनों पढ़ता है।
कमेंट और DM ऐप तक कैसे पहुँचते हैं?
साइन किए गए POST के रूप में एक रूट हैंडलर तक, जिसे set_social_webhook_destination किसी खाते के लिए रजिस्टर करता है, और फिर वह Instagram और Facebook के कमेंट, मेंशन और DM और TikTok के कमेंट प्राप्त करता है। हर बॉडी में platform, account_id, external_id और entry होते हैं, यानी नेटवर्क की इवेंट जैसी भेजी गई थी। बॉडी को टेक्स्ट के रूप में पढ़ें, X-EC-Signature की जाँच खाते के साइनिंग सीक्रेट से करें, और जल्दी जवाब दें: easyCoexistence रूट को 8 सेकंड देता है और हर इवेंट एक बार भेजता है, बिना दोबारा प्रयास के। इवेंट को क्यू में डालें और एक वर्कर से replyToEvent कॉल करवाएँ, ताकि मॉडल का समय उन 8 सेकंड में कभी न गिना जाए।
हर नेटवर्क मॉडल को क्या करने देता है?
खाते के एपीआई जितना, जिसे निर्देशों में साफ़ लिखना चाहिए:
- Instagram: JPEG इमेज के साथ पोस्ट, Reels और Stories; DM का जवाब सिर्फ़ उन्हीं लोगों को, जिन्होंने पिछले 24 घंटों में लिखा हो, और अधिकतम 1,000 बाइट में।
- Facebook: पेज पोस्ट, कमेंट का जवाब और Messenger का जवाब उन्हीं 24 घंटों के भीतर।
- TikTok: वीडियो और फ़ोटो पोस्ट; कमेंट का जवाब हमेशा सार्वजनिक, वीडियो की ID को
post_idके रूप में, और कोई DM नहीं। - WhatsApp:
send_messageग्राहक के आख़िरी मैसेज के 24 घंटों के भीतर,send_templateकिसी और के लिए। - YouTube और LinkedIn: अपलोड और पोस्ट जब यूज़र माँगे, कमेंट का जवाब और एनालिटिक्स; दोनों इवेंट आगे नहीं भेजते, इसलिए ऐप नए कमेंट शेड्यूल पर पढ़ता है।
आम गड़बड़ियाँ
- stopWhen को डिफ़ॉल्ट पर छोड़ना। generateText पहले स्टेप के बाद रुक जाता है, इसलिए मॉडल reply_to_comment कॉल करता है और कभी नहीं जानता कि जवाब गया या नहीं; isStepCount से कुछ स्टेप्स की अनुमति दें।
- सर्वरलेस होस्ट पर टोकन मॉड्यूल-स्तर वेरिएबल में रखना। अगले कोल्ड स्टार्ट पर कुछ नहीं बचता, और यूज़र फिर सहमति स्क्रीन पर पहुँच जाता है; उन्हें वहाँ सेव करें जहाँ tokens() और saveTokens() डेटाबेस तक पहुँचें।
- एक रीडायरेक्ट यूआरएल रजिस्टर करना और दूसरा भेजना। easyCoexistence redirect_uri को रजिस्ट्रेशन से हूबहू मिलाता है, इसलिए अंत में स्लैश या अलग पाथ हो तो लॉग इन एरर पेज पर खत्म होता है।
- खाते की अपनी गतिविधि का जवाब देना। Instagram खाते के DM वापस echo के रूप में भेजता है और उसके सार्वजनिक जवाब कमेंट बनकर लौटते हैं, इसलिए प्रॉम्प्ट मॉडल तक पहुँचने से पहले दोनों छोड़ दें।
easyCoexistence Vercel AI SDK से बनाए गए एजेंटों को WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn और अन्य चैनलों पर ग्राहकों तक पहुँच देता है, हर एक उसके आधिकारिक एपीआई के ज़रिए: OAuth लॉग इन के पीछे MCP टूल्स, कमेंट और DM के लिए साइन किए गए इवेंट, और 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। WhatsApp के लिए AI SDK गाइड उन्हें प्राप्त करना समझाती है।
AI SDK ऐप के लिए easyCoexistence कितना खर्च होता है?
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ाने पर घटता हुआ, हर नेटवर्क पर एक जैसा। MCP सर्वर और Partner एपीआई इसमें शामिल हैं, और पहले 3 दिन निःशुल्क हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित