Društvene mreže u Vercel AI SDK: Instagram, TikTok i još
Vercel AI SDK dobija alate za društvene mreže za Instagram, TikTok, Facebook, WhatsApp i još kanala iz easyCoexistence MCP servera. createMCPClient, iz paketa @ai-sdk/mcp, otvara HTTP vezu sa https://easycoexistence.com/api/mcp, OAuthClientProvider koji vi napišete čuva prijavu, a klijentov tools() ide u generateText ili streamText da objavi, zakaže, odgovori na komentare i DM-ove i pročita analitiku preko službenog API-ja svake mreže.
Funkcija iz paketa @ai-sdk/mcp koja završava OAuth povratni poziv pomoću serverUrl i authorizationCode, uz callbackState i callbackIssuer kada postoje.
Podrazumevani stopWhen u generateText, pa model čita rezultat alata samo ako stopWhen dozvoljava više koraka.
MCP transport koji AI SDK preporučuje za produkciju; njegov stdio transport namenjen je samo lokalnim serverima.
Vek easyCoexistence MCP pristupnog tokena; njegov refresh token traje 60 dana i zamenjuje se pri svakom osvežavanju.
Najviše teksta koji stane u jednu Instagram DM poruku, meren u UTF-8, pa dijakritici i emoji zauzimaju više prostora.
Kako se AI SDK prijavljuje u easyCoexistence?
Preko OAuthClientProvider-a koji sami implementirate nad sopstvenim skladištem, a njime upravlja auth() funkcija AI SDK-a. Prvi poziv registruje vašu aplikaciju kod easyCoexistence kao javnog klijenta, čuva PKCE verifikator i daje vam URL za saglasnost kroz redirectToAuthorization; vraća REDIRECT, a vaša ruta šalje korisnika tamo. easyCoexistence zatim preusmerava na vaš povratni poziv sa kodom, a drugi auth() poziv sa authorizationCode razmenjuje ga za tokene. Kada su tokeni sačuvani, auth() koristi refresh token za novi par umesto da korisnika vraća na početak. Držite redirectUrl i registrovane redirect_uris identičnim, jer easyCoexistence ih proverava doslovno.
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");
}Kako alati stižu do generateText?
Iz createMCPClient sa HTTP transportom, easyCoexistence URL-om i provajderom. tools() vraća alate servera kao AI SDK alate; zadržite one koje posao traži po imenu i prosledite ih u generateText ili streamText. Postavite stopWhen sa isStepCount, jer se poziv podrazumevano zaustavlja posle jednog koraka i model nikada ne pročita šta je reply_to_comment vratio. Pravila za mreže stavite u instructions, parametar koji aktuelna referenca koristi za ponašanje modela. Zatvorite klijenta u finally bloku ili u onEnd callback-u streamText-a, da ne ostane otvorena nijedna veza.
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();
}
}Gde tokeni treba da žive na serverless hostu?
Bilo gde što preživljava jedan poziv: red u bazi, Redis ili key-value skladište, uz ključ korisnika vaše aplikacije kome tokeni pripadaju. Funkcija na Vercel-u ili drugoj serverless platformi počinje bez ičega u memoriji, pa provajder koji tokene čuva u promenljivoj vraća korisnika na ekran za saglasnost posle hladnog starta. Pristupni tokeni traju sat vremena, a refresh tokeni 60 dana, uz novi refresh token pri svakoj upotrebi, pa aplikacija koja pozove alate bar jednom u 60 dana ostaje prijavljena. Registraciju klijenta držite uz tokene, jer provajder čita oba pri svakoj vezi.
Kako komentari i DM-ovi stižu do aplikacije?
Kao potpisani POST zahtevi ka route handler-u, koji set_social_webhook_destination registruje za nalog, a koji zatim prima Instagram i Facebook komentare, pominjanja i DM-ove, kao i TikTok komentare. Svako telo sadrži platform, account_id, external_id i entry, događaj mreže kako je poslat. Telo pročitajte kao tekst, proverite X-EC-Signature prema njemu uz tajni ključ naloga i odgovorite brzo: easyCoexistence daje ruti 8 sekundi i šalje svaki događaj jednom, bez ponovnog pokušaja. Stavite događaj u red čekanja i neka radnik pozove replyToEvent sa njim, da vreme modela nikada ne ulazi u tih 8 sekundi.
Šta svaka mreža dozvoljava modelu?
Koliko god API naloga dozvoljava, što uputstva treba da navedu:
- Instagram: objave, Reels i Stories sa JPEG slikama; odgovori na DM samo ljudima koji su pisali u poslednja 24 sata, u najviše 1.000 bajtova.
- Facebook: objave na stranici, odgovori na komentare i odgovori u Messengeru u istih 24 sata.
- TikTok: videi i foto objave; odgovori na komentare uvek su javni, sa ID-jem videa kao
post_id, i bez DM-ova. - WhatsApp:
send_messageu roku od 24 sata od poslednje poruke klijenta,send_templateza sve ostale. - YouTube i LinkedIn: otpremanja i objave kada korisnik to zatraži, odgovori na komentare i analitika; nijedna ne prosleđuje događaje, pa aplikacija čita nove komentare po rasporedu.
Česte greške
- Ostavljanje stopWhen na podrazumevanoj vrednosti. generateText se zaustavlja posle prvog koraka, pa model pozove reply_to_comment i nikada ne sazna da li je odgovor izašao; dozvolite nekoliko koraka sa isStepCount.
- Čuvanje tokena u promenljivoj na nivou modula na serverless hostu. Sledeći hladni start nema ništa, pa korisnik ponovo završava na ekranu za saglasnost; sačuvajte ih tamo gde tokens() i saveTokens() dolaze do baze.
- Registrovanje jednog redirect URL-a, a slanje drugog. easyCoexistence proverava redirect_uri doslovno prema registraciji, pa kosa crta na kraju ili druga putanja završavaju prijavu na stranici sa greškom.
- Odgovaranje na sopstvenu aktivnost naloga. Instagram vraća DM-ove naloga kao eho, a njegovi javni odgovori dolaze nazad kao komentari, pa ih preskočite pre nego što upit stigne do modela.
easyCoexistence daje agentima koje pravite uz Vercel AI SDK doseg do klijenata na WhatsApp-u, Instagramu, Facebooku, TikToku, YouTube-u, LinkedIn-u i još kanala, svaki preko svog službenog API-ja: MCP alati iza OAuth prijave, potpisani događaji za komentare i DM-ove, i red za objave do 90 dana unapred, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0,75 po vezi mesečno, pri čemu cena pada kako dodajete veze, a prva 3 dana su besplatna.
Često postavljana pitanja
Da li je potreban Next.js ili Vercel hosting?
Ne. AI SDK radi u Node.js-u, pa svaki host koji služi HTTPS rutu radi, a MCP klijentu je potreban samo odlazni HTTPS ka easycoexistence.com.
Može li chat interfejs da strimuje pozive alata?
Može. Prosledite iste alate u streamText i zatvorite MCP klijenta u njegovom onEnd callback-u, kako AI SDK dokumentuje za strimovane odgovore.
Može li ista aplikacija da odgovara na WhatsApp poruke?
Može. Alati broja stižu kroz isti klijent: list_numbers za connection_id, pa send_message u roku od 24 sata od poslednje poruke klijenta. Vodič AI SDK-a za WhatsApp pokriva njihovo primanje.
Koliko košta easyCoexistence za aplikaciju sa AI SDK-om?
Od US$ 9 do US$ 0,75 po vezi mesečno, uz pad kako dodajete veze, isto na svakoj mreži. MCP server i Partner API su uključeni, a prva 3 dana su besplatna.
Nastavite sa čitanjem
Povežite prvi kanal za dva minuta.
Bez čekanja na odobrenja platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoj AI da objavi, odgovori ili napravi izveštaj, i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo zvanični API-ji
- Nadzor 24/7
Provereno na