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 ద్వారా పబ్లిష్, షెడ్యూల్, కామెంట్లు మరియు DMలకు రిప్లై చేయడం, అలాగే ఇన్సైట్స్ చదవడం చేయవచ్చు.
@ai-sdk/mcp ఫంక్షన్, ఇది serverUrl మరియు authorizationCode నుండి OAuth కాల్బ్యాక్ను పూర్తి చేస్తుంది; ఉంటే callbackState మరియు callbackIssuer కూడా.
generateText యొక్క డిఫాల్ట్ stopWhen, అంటే stopWhen ఎక్కువ దశలను అనుమతించే వరకు మోడల్ టూల్ ఫలితాన్ని చదవదు.
AI SDK ఉత్పత్తి కోసం సిఫార్సు చేసే MCP ట్రాన్స్పోర్ట్; దాని stdio ట్రాన్స్పోర్ట్ స్థానిక సర్వర్ల కోసం మాత్రమే.
easyCoexistence MCP యాక్సెస్ టోకెన్ జీవితకాలం; దాని రిఫ్రెష్ టోకెన్ 60 రోజులు ఉంటుంది మరియు ప్రతి రిఫ్రెష్లో భర్తీ చేయబడుతుంది.
ఒక Instagram DM గరిష్టంగా మోసుకెళ్లే టెక్స్ట్, UTF-8 లో కొలవబడుతుంది, కాబట్టి యాక్సెంట్లు మరియు ఎమోజీలు ఎక్కువ స్థానం తీసుకుంటాయి.
AI SDK easyCoexistence లో ఎలా సైన్ ఇన్ చేస్తుంది?
మీరు అమలు చేసే OAuthClientProvider ద్వారా, ఇది మీ స్వంత స్టోరేజ్పై ఉంటుంది మరియు AI SDK యొక్క auth() ఫంక్షన్ దీన్ని నడుపుతుంది. మొదటి కాల్ మీ యాప్ను easyCoexistence తో public client గా నమోదు చేస్తుంది, 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 కు ఇవ్వండి. isStepCount తో stopWhen సెట్ చేయండి, ఎందుకంటే డిఫాల్ట్గా కాల్ ఒక దశ తర్వాత ఆగిపోతుంది మరియు reply_to_comment ఏమి తిరిగి ఇచ్చిందో మోడల్ ఎప్పటికీ చదవదు. నెట్వర్క్ నియమాలను ఇన్స్ట్రక్షన్స్ లో ఉంచండి, ప్రస్తుత రిఫరెన్స్ మోడల్ ప్రవర్తన కోసం ఉపయోగించే పరామితి ఇది. client ను 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 లేదా ఇతర సర్వర్లెస్ ప్లాట్ఫామ్పై ఫంక్షన్ మెమరీలో ఏమీ లేకుండా మొదలవుతుంది, కాబట్టి టోకెన్లను వేరియబుల్లో ఉంచే provider కోల్డ్ స్టార్ట్ తర్వాత వినియోగదారుని మళ్లీ సమ్మతి స్క్రీన్కు పంపుతుంది. యాక్సెస్ టోకెన్లు ఒక గంట, రిఫ్రెష్ టోకెన్లు 60 రోజులు ఉంటాయి, ప్రతి ఉపయోగంలో కొత్త రిఫ్రెష్ టోకెన్ వస్తుంది, కాబట్టి 60 రోజుల్లో కనీసం ఒకసారి టూల్స్ను కాల్ చేసే యాప్ సైన్ ఇన్లో ఉంటుంది. క్లయింట్ నమోదును టోకెన్ల పక్కన ఉంచండి, ఎందుకంటే provider ప్రతి కనెక్షన్లో రెండింటినీ చదువుతుంది.
కామెంట్లు మరియు DMలు యాప్కు ఎలా చేరతాయి?
route handler కు signed POST లుగా, దీన్ని set_social_webhook_destination ఖాతాకు నమోదు చేస్తుంది, తర్వాత Instagram మరియు Facebook కామెంట్లు, మెన్షన్లు మరియు DMలు, మరియు TikTok కామెంట్లను అందుకుంటుంది. ప్రతి బాడీలో platform, account_id, external_id మరియు entry ఉంటాయి, అంటే పంపినట్లుగానే నెట్వర్క్ ఈవెంట్. బాడీని టెక్స్ట్గా చదవండి, ఖాతా signing secret తో X-EC-Signature ను దానికి వ్యతిరేకంగా తనిఖీ చేయండి, మరియు త్వరగా స్పందించండి: easyCoexistence route కు 8 సెకన్లు ఇస్తుంది మరియు ప్రతి ఈవెంట్ను ఒకసారి పంపుతుంది, మళ్లీ ప్రయత్నం లేకుండా. ఈవెంట్ను క్యూలో ఉంచి, worker తో replyToEvent కాల్ చేయించండి, తద్వారా మోడల్ సమయం ఎప్పుడూ 8 సెకన్లలో లెక్కించబడదు.
ప్రతి నెట్వర్క్ మోడల్ను ఏమి చేయనిస్తుంది?
ఖాతా యొక్క API అనుమతించినంత, ఇన్స్ట్రక్షన్స్ స్పష్టంగా చెప్పాలి:
- Instagram: JPEG చిత్రాలతో పోస్ట్లు, Reels మరియు Stories; DM రిప్లైలు గత 24 గంటల్లో రాసిన వ్యక్తులకు మాత్రమే, గరిష్టంగా 1,000 బైట్లలో.
- Facebook: Page పోస్ట్లు, కామెంట్ రిప్లైలు మరియు Messenger రిప్లైలు అదే 24 గంటల్లో.
- TikTok: వీడియోలు మరియు ఫోటో పోస్ట్లు; కామెంట్ రిప్లైలు ఎల్లప్పుడూ పబ్లిక్గా,
post_idగా వీడియో ID తో, మరియు DMలు లేవు. - WhatsApp: కస్టమర్ చివరి మెసేజ్ నుండి 24 గంటల్లో
send_message, ఇతరులకుsend_template. - YouTube మరియు LinkedIn: వినియోగదారు కోరినప్పుడు అప్లోడ్లు మరియు పోస్ట్లు, కామెంట్ రిప్లైలు మరియు ఎనలిటిక్స్; రెండూ ఈవెంట్లను ఫార్వర్డ్ చేయవు, కాబట్టి యాప్ షెడ్యూల్లో కొత్త కామెంట్లను చదువుతుంది.
సాధారణ పొరపాట్లు
- stopWhen ను డిఫాల్ట్గా వదలడం. generateText మొదటి దశ తర్వాత ఆగిపోతుంది, కాబట్టి మోడల్ reply_to_comment ను కాల్ చేస్తుంది మరియు రిప్లై వెళ్లిందో లేదో ఎప్పటికీ తెలుసుకోదు; isStepCount తో కొన్ని దశలను అనుమతించండి.
- సర్వర్లెస్ హోస్ట్లో టోకెన్లను మాడ్యూల్-స్థాయి వేరియబుల్లో ఉంచడం. తర్వాతి కోల్డ్ స్టార్ట్లో అవి ఉండవు, మరియు వినియోగదారు మళ్లీ సమ్మతి స్క్రీన్పై దిగుతారు; tokens() మరియు saveTokens() డేటాబేస్ను చేరుకునే చోట వాటిని సేవ్ చేయండి.
- ఒక redirect URL నమోదు చేసి మరొకటి పంపడం. easyCoexistence redirect_uri ను నమోదుతో ఖచ్చితంగా తనిఖీ చేస్తుంది, కాబట్టి చివర స్లాష్ లేదా వేరే పాత్ సైన్ ఇన్ను ఎర్రర్ పేజీతో ముగిస్తుంది.
- ఖాతా స్వంత కార్యకలాపానికి రిప్లై ఇవ్వడం. Instagram ఖాతా యొక్క DMలను ఎకోలుగా తిరిగి పంపుతుంది, మరియు దాని పబ్లిక్ రిప్లైలు కామెంట్లుగా తిరిగి వస్తాయి, కాబట్టి ప్రాంప్ట్ మోడల్కు చేరే ముందు రెండింటినీ దాటవేయండి.
easyCoexistence, Vercel AI SDK తో మీరు నిర్మించే ఏజెంట్లకు WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn మరియు ఇతర ఛానెళ్లలోని కస్టమర్లకు చేరువ ఇస్తుంది, ప్రతి ఒక్కటి అధికారిక API ద్వారా: OAuth సైన్ ఇన్ వెనుక MCP టూల్స్, కామెంట్లు మరియు DMల కోసం signed ఈవెంట్లు, మరియు 90 రోజుల ముందు వరకు పోస్టింగ్ క్యూ, ప్రతి కనెక్షన్ 24/7 పర్యవేక్షించబడుతుంది. కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్లు జోడించేకొద్దీ తగ్గుతూ, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
దీనికి Next.js లేదా Vercel హోస్టింగ్ అవసరమా?
లేదు. AI SDK Node.js లో నడుస్తుంది, కాబట్టి HTTPS రూట్ అందించే ఏ హోస్ట్ అయినా పనిచేస్తుంది, మరియు MCP క్లయింట్కు easycoexistence.com కు బయటకు వెళ్లే HTTPS మాత్రమే కావాలి.
చాట్ ఇంటర్ఫేస్ టూల్ కాల్స్ను స్ట్రీమ్ చేయగలదా?
అవును. అదే టూల్స్ను streamText కు ఇవ్వండి మరియు AI SDK స్ట్రీమ్ చేసిన రెస్పాన్స్ల కోసం డాక్యుమెంట్ చేసినట్లుగా onEnd కాల్బ్యాక్లో MCP క్లయింట్ను మూసివేయండి.
అదే యాప్ WhatsApp మెసేజ్లకు రిప్లై ఇవ్వగలదా?
అవును. నంబర్ యొక్క టూల్స్ అదే క్లయింట్ ద్వారా వస్తాయి: connection_id కోసం list_numbers, తర్వాత కస్టమర్ చివరి మెసేజ్ నుండి 24 గంటల్లో send_message. WhatsApp కోసం AI SDK గైడ్ వాటిని స్వీకరించడాన్ని కవర్ చేస్తుంది.
AI SDK యాప్ కోసం easyCoexistence ఎంత ఖర్చు అవుతుంది?
కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్లు జోడించేకొద్దీ తగ్గుతుంది, ప్రతి నెట్వర్క్లో ఒకే విధంగా. MCP సర్వర్ మరియు Partner API దీనిలో భాగం, మొదటి 3 రోజులు ఉచితం.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ