Tumia zana za mitandao ya kijamii kwenye Vercel AI SDK: Instagram, TikTok na zaidi
Vercel AI SDK inapokea zana za mitandao ya kijamii za Instagram, TikTok, Facebook, WhatsApp na njia zaidi kutoka kwenye seva ya MCP ya easyCoexistence. createMCPClient, kutoka kwenye kifurushi cha @ai-sdk/mcp, inafungua muunganisho wa HTTP hadi https://easycoexistence.com/api/mcp, OAuthClientProvider unayoandika wewe inashikilia mchakato wa kuingia, na tools() za client huingizwa kwenye generateText au streamText ili kuchapisha, kuratibu, kujibu maoni na DM, na kusoma takwimu kupitia API rasmi ya kila mtandao.
Kazi ya @ai-sdk/mcp inayomaliza callback ya OAuth kutoka serverUrl na authorizationCode, pamoja na callbackState na callbackIssuer zikiwepo.
stopWhen chaguo-msingi ya generateText, hivyo modeli husoma matokeo ya zana tu pale stopWhen inaporuhusu hatua zaidi.
Njia ya usafirishaji ya MCP ambayo AI SDK inapendekeza kwa uzalishaji; njia yake ya stdio imekusudiwa kwa seva za ndani pekee.
Muda wa token ya ufikiaji ya MCP ya easyCoexistence; refresh token yake inadumu siku 60 na hubadilishwa kila inapoonyeshwa upya.
Ukubwa mkubwa zaidi wa maandishi ambao DM moja ya Instagram hubeba, unapimwa kwa UTF-8, hivyo herufi zenye lafudhi na emoji huchukua nafasi zaidi.
AI SDK huingiaje kwenye easyCoexistence?
Kupitia OAuthClientProvider unayotekeleza juu ya hifadhi yako mwenyewe, ambayo kazi ya auth() ya AI SDK inaiendesha. Mwito wa kwanza husajili programu yako na easyCoexistence kama public client, huhifadhi PKCE verifier na kukupa URL ya idhini kupitia redirectToAuthorization; hurudisha REDIRECT, na route yako humpeleka mtumiaji huko. Kisha easyCoexistence humwelekeza upya kwenye callback yako pamoja na code, na mwito wa pili wa auth() wenye authorizationCode hubadilisha code hiyo kuwa token. Token zikishahifadhiwa, auth() hutumia refresh token kupata jozi mpya bila kumrudisha mtumiaji. Weka redirectUrl na redirect_uris zilizosajiliwa zikiwa sawa kabisa, kwa sababu easyCoexistence huzilinganisha kwa usahihi.
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");
}Zana hufikaje kwenye generateText?
Kutoka kwenye createMCPClient ukiwa na usafirishaji wa HTTP, URL ya easyCoexistence na provider. tools() hurudisha zana za seva kama zana za AI SDK; chagua zile kazi inazohitaji kwa jina na uzipitishe kwa generateText au streamText. Weka stopWhen kwa isStepCount, kwa sababu kwa chaguo-msingi mwito huishia baada ya hatua moja na modeli haisomi kile reply_to_comment ilichorudisha. Weka sheria za mitandao kwenye instructions, parameter ambayo marejeo ya sasa hutumia kwa tabia ya modeli. Funga client kwenye kizuizi cha finally, au kwenye callback ya onEnd ya streamText, ili kusiwe na muunganisho ulio wazi.
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();
}
}Token zinapaswa kuishi wapi kwenye seva ya serverless?
Mahali popote panapodumu zaidi ya mwito mmoja: safu kwenye hifadhidata, Redis au hifadhi ya ufunguo na thamani, ikiwa na kitambulisho cha mtumiaji wa programu yako ambaye token ni zake. Function kwenye Vercel au jukwaa jingine la serverless huanza bila chochote kwenye kumbukumbu, kwa hiyo provider inayohifadhi token kwenye variable humrudisha mtumiaji kwenye skrini ya idhini baada ya cold start. Access token hudumu saa moja na refresh token siku 60, huku refresh token mpya ikitolewa kila inapotumika; kwa hiyo programu inayoita zana angalau mara moja ndani ya siku 60 hubaki imeingia. Weka usajili wa client pamoja na token, kwa sababu provider huzisoma zote mbili kila muunganisho unapofanywa.
Maoni na DM hufikaje kwenye programu?
Kama POST zilizosainiwa kwenda route handler, ambayo set_social_webhook_destination huisajili kwa akaunti, na ambayo hupokea maoni, kutajwa na DM za Instagram na Facebook, pamoja na maoni ya TikTok. Kila body hubeba platform, account_id, external_id na entry, tukio la mtandao kama lilivyotumwa. Soma body kama maandishi, linganisha X-EC-Signature nayo kwa siri ya kusaini ya akaunti, na jibu haraka: easyCoexistence huipa route sekunde 8 na hutuma kila tukio mara moja tu, bila kujaribu tena. Weka tukio kwenye foleni na acha worker aite replyToEvent nalo, ili muda wa modeli usihesabiwe ndani ya sekunde 8.
Kila mtandao unamruhusu modeli kufanya nini?
Kadri API ya akaunti inavyoruhusu, ambayo maelekezo yanapaswa kueleza waziwazi:
- Instagram: machapisho, Reels na Stories kwa picha za JPEG; majibu ya DM kwa watu walioandika ndani ya saa 24 zilizopita pekee, kwa baiti zisizozidi 1,000.
- Facebook: machapisho ya Ukurasa, majibu ya maoni na majibu ya Messenger ndani ya saa 24 zilezile.
- TikTok: video na machapisho ya picha; majibu ya maoni daima ni ya hadharani, kwa video ID kama
post_id, na bila DM. - WhatsApp:
send_messagendani ya saa 24 tangu ujumbe wa mwisho wa mteja,send_templatekwa mtu mwingine yeyote. - YouTube na LinkedIn: upakiaji na machapisho mtumiaji anapoomba, majibu ya maoni na takwimu; hakuna hata moja inayosambaza matukio, kwa hiyo programu husoma maoni mapya kwa ratiba.
Makosa ya kawaida
- Kuacha stopWhen kwenye chaguo-msingi. generateText huishia baada ya hatua ya kwanza, kwa hiyo modeli huita reply_to_comment na haijui kama jibu limetoka; ruhusu hatua chache kwa isStepCount.
- Kuweka token kwenye variable ya kiwango cha moduli kwenye seva ya serverless. Cold start inayofuata haina chochote, na mtumiaji anarudi kwenye skrini ya idhini; zihifadhi mahali ambapo tokens() na saveTokens() zinafikia hifadhidata.
- Kusajili URL moja ya redirect halafu kutuma nyingine. easyCoexistence huangalia redirect_uri dhidi ya usajili kwa usahihi, kwa hiyo slash ya mwisho au njia tofauti huimaliza kuingia kwenye ukurasa wa hitilafu.
- Kujibu shughuli za akaunti yenyewe. Instagram hurudisha DM za akaunti kama echo, na majibu yake ya umma hurudi kama maoni, kwa hiyo ruka vyote viwili kabla ujumbe haujafika kwa modeli.
easyCoexistence huipa mawakala wa AI ambao unawajenga kwa Vercel AI SDK ufikiaji wa wateja kwenye WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn na njia zaidi, kila moja kupitia API yake rasmi: zana za MCP nyuma ya kuingia kwa OAuth, matukio yaliyosainiwa kwa maoni na DM, na foleni ya machapisho hadi siku 90 mbele, huku kila muunganisho ukifuatiliwa saa 24 kwa siku. US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka kadri unavyoongeza muunganisho, na siku 3 za kwanza ni bila malipo.
Maswali yanayoulizwa mara kwa mara
Je, hii inahitaji Next.js au hosting ya Vercel?
Hapana. AI SDK inaendeshwa kwenye Node.js, kwa hiyo host yoyote inayotoa route ya HTTPS inafanya kazi, na MCP client inahitaji tu HTTPS ya kutoka kwenda easycoexistence.com.
Je, kiolesura cha mazungumzo kinaweza kutiririsha mwito wa zana?
Ndiyo. Pitisha zana zilezile kwa streamText na ufunge MCP client kwenye callback yake ya onEnd, kama AI SDK inavyoelekeza kwa majibu yaliyotiririshwa.
Je, programu hiyohiyo inaweza kujibu ujumbe wa WhatsApp?
Ndiyo. Zana za nambari hupitia client hiyohiyo: list_numbers kwa connection_id, kisha send_message ndani ya saa 24 tangu ujumbe wa mwisho wa mteja. Mwongozo wa AI SDK wa WhatsApp unashughulikia kuzipokea.
easyCoexistence inagharimu kiasi gani kwa programu ya AI SDK?
US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka kadri unavyoongeza muunganisho, sawa kwenye kila mtandao. MCP server na Partner API vimejumuishwa, na siku 3 za kwanza ni bila malipo.
Endelea kusoma
Unganisha chaneli yako ya kwanza ndani ya dakika mbili.
Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.
- Siku 3 bila malipo
- Ghairi wakati wowote
- API rasmi pekee
- Hufuatiliwa saa 24/7
Imethibitishwa kwenye