Koristite alate za društvene mreže u Vercel AI SDK-u: Instagram, TikTok i drugi
Vercel AI SDK dobiva alate za društvene mreže: Instagram, TikTok, Facebook, WhatsApp i druge kanale iz MCP poslužitelja easyCoexistencea. createMCPClient iz paketa @ai-sdk/mcp otvara HTTP vezu prema https://easycoexistence.com/api/mcp, OAuthClientProvider koji napišete čuva prijavu, a tools() klijenta ulazi u generateText ili streamText radi objavljivanja, zakazivanja, odgovaranja na komentare i izravne poruke te čitanja uvida kroz službeni API svake mreže.
Funkcija iz @ai-sdk/mcp koja dovršava OAuth povratni poziv iz serverUrl i authorizationCode, uz callbackState i callbackIssuer kada postoje.
Zadani stopWhen funkcije generateText, pa model čita rezultat alata samo ako stopWhen dopušta više koraka.
MCP transport koji AI SDK preporučuje za produkciju; njegov stdio transport namijenjen je samo lokalnim poslužiteljima.
Vijek trajanja MCP pristupnog tokena easyCoexistencea; njegov refresh token traje 60 dana i zamjenjuje se pri svakom osvježavanju.
Najveći tekst koji jedna Instagram izravna poruka može nositi, mjereno u UTF-8, pa slova s dijakriticima i emoji zauzimaju više prostora.
Kako se AI SDK prijavljuje u easyCoexistence?
Preko OAuthClientProvidera koji sami implementirate nad vlastitom pohranom, a njime upravlja funkcija auth() iz AI SDK-a. Prvi poziv registrira vašu aplikaciju kod easyCoexistencea kao javnog klijenta, sprema PKCE verifikator i preko redirectToAuthorization vam predaje URL za odobrenje; vraća vrijednost REDIRECT, a vaša ruta šalje korisnika tamo. easyCoexistence zatim preusmjerava na vaš povratni poziv s kodom, a drugi poziv auth() s authorizationCode mijenja ga za tokene. Kad su tokeni pohranjeni, auth() koristi refresh token za novi par umjesto da korisnika vrati na prijavu. Držite redirectUrl i registrirane redirect_uris identičnima jer ih easyCoexistence uspoređuje točno.
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 dolaze do generateText?
Iz createMCPClient s HTTP transportom, easyCoexistence URL-om i providerom. tools() vraća alate poslužitelja kao AI SDK alate; po nazivu zadržite samo one koji su potrebni i prosljedite ih u generateText ili streamText. Postavite stopWhen s isStepCount, jer se poziv zadano zaustavlja nakon jednog koraka i model nikada ne pročita što je reply_to_comment vratio. Pravila za mrežu stavite u instructions, parametar koji aktualna referenca koristi za ponašanje modela. Zatvorite klijenta u finally bloku ili u funkciji onEnd od streamText, 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();
}
}Gdje tokeni trebaju biti na serverless hostu?
Bilo gdje što nadživljava jedan poziv: u retku baze podataka, Redisu ili spremištu ključeva i vrijednosti, s ključem korisnika vaše aplikacije kojem tokeni pripadaju. Funkcija na Vercelu ili nekoj drugoj serverless platformi kreće bez ičega u memoriji, pa provider koji tokene drži u varijabli modula nakon hladnog starta korisnika šalje natrag na zaslon za odobrenje. Pristupni tokeni traju sat, a refresh tokeni 60 dana, uz novi refresh token pri svakoj upotrebi, pa aplikacija koja pozove alate barem jednom u 60 dana ostaje prijavljena. Registraciju klijenta držite uz tokene, jer ih provider čita pri svakom povezivanju.
Kako komentari i izravne poruke dolaze do aplikacije?
Kao potpisani POST zahtjevi na route handler koji set_social_webhook_destination registrira za račun. Na njega stižu komentari, spominjanja i izravne poruke na Instagramu i Facebooku te komentari na TikToku. Svako tijelo zahtjeva sadrži platform, account_id, external_id i entry, događaj mreže onako kako je poslan. Čitajte tijelo kao tekst, provjerite X-EC-Signature prema njemu uz tajni ključ za potpisivanje računa 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 s njim, da se vrijeme modela ne broji u tih 8 sekundi.
Što svaka mreža dopušta modelu?
Onoliko koliko API računa dopušta, što upute trebaju jasno navesti:
- Instagram: objave, Reels i Stories s JPEG slikama; odgovori na izravne poruke samo onima koji su pisali u posljednja 24 sata, u najviše 1,000 bajtova.
- Facebook: objave na stranici, odgovori na komentare i odgovori u Messengeru unutar istih 24 sata.
- TikTok: videozapisi i objave fotografija; odgovori na komentare uvijek su javni, s ID-em videozapisa kao
post_id, a izravnih poruka nema. - WhatsApp:
send_messageunutar 24 sata od posljednje poruke korisnika,send_templateza sve ostale. - YouTube i LinkedIn: učitavanja i objave kada korisnik to zatraži, odgovori na komentare i analitika; nijedna ne prosljeđuje događaje, pa aplikacija nove komentare čita prema rasporedu.
Uobičajene pogreške
- Ostavljanje stopWhen na zadanoj vrijednosti. generateText se zaustavlja nakon prvog koraka, pa model pozove reply_to_comment i nikada ne sazna je li odgovor otišao; dopustite nekoliko koraka s isStepCount.
- Držanje tokena u varijabli na razini modula na serverless hostu. Nakon sljedećeg hladnog starta nema ih, pa se korisnik ponovno nađe na zaslonu za odobrenje; spremite ih tamo gdje tokens() i saveTokens() dosežu bazu podataka.
- Registriranje jedne povratne URL adrese, a slanje druge. easyCoexistence provjerava redirect_uri točno prema registraciji, pa kosa crta na kraju ili drugi put prijavu završi na stranici s pogreškom.
- Odgovaranje na vlastitu aktivnost računa. Instagram šalje izravne poruke računa natrag kao odjeke, a njegovi javni odgovori vraćaju se kao komentari, pa oba preskočite prije nego upit stigne do modela.
easyCoexistence agentima koje gradite s Vercel AI SDK-om daje doseg do kupaca na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i drugim kanalima, svakom kroz službeni API: MCP alati iza OAuth prijave, potpisani događaji za komentare i izravne poruke te red za objave do 90 dana unaprijed, uz praćenje svake veze 24/7. US$ 9 do US$ 0.75 po vezi mjesečno, a cijena pada kako dodajete veze, uz prva 3 dana koja su besplatna.
Često postavljana pitanja
Treba li ovo Next.js ili Vercel hosting?
Ne. AI SDK radi u Node.js-u, pa svaki host koji poslužuje HTTPS rutu radi, a MCP klijentu treba samo odlazni HTTPS prema easycoexistence.com.
Može li chat sučelje streamati pozive alata?
Može. Prosljedite iste alate u streamText i zatvorite MCP klijenta u njegovoj funkciji onEnd, kako AI SDK dokumentira za streamirane odgovore.
Može li ista aplikacija odgovarati na WhatsApp poruke?
Može. Alati broja dolaze kroz isti klijent: list_numbers za connection_id, zatim send_message unutar 24 sata od posljednje poruke korisnika. Vodič AI SDK-a za WhatsApp pokriva primanje tih poruka.
Koliko košta easyCoexistence za aplikaciju s AI SDK-om?
US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, jednako na svakoj mreži. MCP poslužitelj i Partner API su uključeni, a prva 3 dana su besplatna.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na