Folosiți instrumentele de social media din Vercel AI SDK: Instagram, TikTok și altele
Vercel AI SDK primește instrumente de social media pentru Instagram, TikTok, Facebook, WhatsApp și alte canale, de la serverul MCP easyCoexistence. createMCPClient, din pachetul @ai-sdk/mcp, deschide o conexiune HTTP către https://easycoexistence.com/api/mcp, un OAuthClientProvider scris de dumneavoastră păstrează autentificarea, iar tools() al clientului se trimite în generateText sau streamText ca să publice, să programeze, să răspundă la comentarii și DM-uri și să citească statisticile prin API-ul oficial al fiecărei rețele.
Funcția din @ai-sdk/mcp care finalizează un callback OAuth pe baza serverUrl și a authorizationCode, plus callbackState și callbackIssuer, când există.
Valoarea implicită a stopWhen din generateText, astfel încât modelul citește rezultatul unui instrument doar dacă stopWhen permite mai mulți pași.
Transportul MCP recomandat de AI SDK pentru producție; transportul stdio este destinat doar serverelor locale.
Durata de viață a unui token de acces MCP easyCoexistence; token-ul de reîmprospătare are 60 de zile și este înlocuit la fiecare reîmprospătare.
Cel mai mare text pe care îl poate conține un DM pe Instagram, măsurat în UTF-8, deci diacriticele și emoji-urile ocupă mai mult din el.
Cum se autentifică AI SDK la easyCoexistence?
Printr-un OAuthClientProvider implementat peste propriul dumneavoastră stocaj, pe care îl acționează funcția auth() din AI SDK. Primul apel înregistrează aplicația dumneavoastră la easyCoexistence ca client public, salvează verificatorul PKCE și vă oferă URL-ul de consimțământ prin redirectToAuthorization; funcția returnează REDIRECT, iar ruta dumneavoastră trimite utilizatorul acolo. easyCoexistence redirecționează apoi către callback-ul dumneavoastră cu un cod, iar un al doilea apel auth() cu authorizationCode îl schimbă pe token-uri. Odată ce token-urile sunt salvate, auth() folosește token-ul de reîmprospătare pentru o pereche nouă, în loc să trimită utilizatorul înapoi. Păstrați redirectUrl și redirect_uris înregistrate identice, deoarece easyCoexistence le compară exact.
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");
}Cum ajung instrumentele la generateText?
De la createMCPClient cu transportul HTTP, URL-ul easyCoexistence și provider-ul. tools() returnează instrumentele serverului ca instrumente AI SDK; păstrați după nume pe cele de care are nevoie sarcina și transmiteți-le la generateText sau streamText. Setați stopWhen cu isStepCount, pentru că în mod implicit apelul se oprește după un pas și modelul nu citește niciodată ce a returnat reply_to_comment. Puneți regulile pentru rețele în instructions, parametrul pe care îl folosește referința actuală pentru comportamentul modelului. Închideți clientul într-un bloc finally sau în callback-ul onEnd al streamText, ca să nu rămână nicio conexiune deschisă.
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();
}
}Unde trebuie păstrate token-urile pe un host serverless?
Oriunde supraviețuiește unei singure invocări: un rând într-o bază de date, Redis sau un depozit cheie-valoare, indexat după utilizatorul aplicației dumneavoastră căruia îi aparțin token-urile. O funcție pe Vercel sau pe altă platformă serverless pornește fără nimic în memorie, deci un provider care ține token-urile într-o variabilă trimite utilizatorul înapoi la ecranul de consimțământ după o pornire la rece. Token-urile de acces durează o oră, iar cele de reîmprospătare 60 de zile, cu un token de reîmprospătare nou de fiecare dată când este folosit; deci o aplicație care apelează instrumentele cel puțin o dată la 60 de zile rămâne autentificată. Păstrați înregistrarea clientului lângă token-uri, deoarece provider-ul citește ambele la fiecare conexiune.
Cum ajung comentariile și DM-urile la aplicație?
Ca POST-uri semnate către un route handler, pe care set_social_webhook_destination îl înregistrează pentru un cont și care apoi primește comentariile, mențiunile și DM-urile de pe Instagram și Facebook, precum și comentariile de pe TikTok. Fiecare corp conține platform, account_id, external_id și entry, evenimentul rețelei așa cum a fost trimis. Citiți corpul ca text, verificați X-EC-Signature față de acesta cu secretul de semnare al contului și răspundeți rapid: easyCoexistence acordă ruteiei 8 secunde și trimite fiecare eveniment o singură dată, fără reîncercare. Puneți evenimentul într-o coadă și lăsați un worker să apeleze replyToEvent cu el, astfel încât timpul modelului să nu conteze niciodată din cele 8 secunde.
Ce îi permite fiecare rețea modelului?
Atât cât permite API-ul contului, lucru pe care instrucțiunile trebuie să îl precizeze:
- Instagram: postări, Reels și Stories cu imagini JPEG; răspunsuri la DM-uri doar pentru persoanele care au scris în ultimele 24 de ore, în cel mult 1.000 de octeți.
- Facebook: postări pe Pagină, răspunsuri la comentarii și răspunsuri pe Messenger în aceleași 24 de ore.
- TikTok: videoclipuri și postări cu fotografii; răspunsurile la comentarii sunt mereu publice, cu ID-ul videoclipului drept
post_id, și fără DM-uri. - WhatsApp:
send_messageîn decurs de 24 de ore de la ultimul mesaj al clientului,send_templatepentru oricine altcineva. - YouTube și LinkedIn: încărcări și postări la cererea unui utilizator, răspunsuri la comentarii și statistici; niciuna nu transmite evenimente, deci aplicația citește comentariile noi programat.
Greșeli frecvente
- Lăsarea stopWhen la valoarea implicită. generateText se oprește după primul pas, deci modelul apelează reply_to_comment și nu află niciodată dacă răspunsul a plecat; permiteți câțiva pași cu isStepCount.
- Păstrarea token-urilor într-o variabilă la nivel de modul pe un host serverless. La următoarea pornire la rece nu mai există, iar utilizatorul ajunge din nou pe ecranul de consimțământ; salvați-le acolo unde tokens() și saveTokens() ajung la o bază de date.
- Înregistrarea unui URL de redirecționare și trimiterea altuia. easyCoexistence compară redirect_uri cu înregistrarea exact, deci o bară finală sau o cale diferită încheie autentificarea pe o pagină de eroare.
- Răspunsul la propria activitate a contului. Instagram trimite înapoi DM-urile contului ca ecouri, iar răspunsurile publice revin ca fiind comentarii; ignorați ambele înainte ca promptul să ajungă la model.
easyCoexistence oferă agenților pe care îi construiți cu Vercel AI SDK acces la clienți pe WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale, fiecare prin API-ul oficial: instrumente MCP în spatele unei autentificări OAuth, evenimente semnate pentru comentarii și DM-uri și o coadă de postări cu până la 90 de zile înainte, cu fiecare conexiune monitorizată non-stop. US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu primele 3 zile gratuite.
Întrebări frecvente
Are nevoie de Next.js sau de găzduire pe Vercel?
Nu. AI SDK rulează în Node.js, deci funcționează orice host care servește o rută HTTPS, iar clientul MCP are nevoie doar de trafic HTTPS de ieșire către easycoexistence.com.
Poate o interfață de chat să transmită în flux apelurile de instrumente?
Da. Transmiteți aceleași instrumente către streamText și închideți clientul MCP în callback-ul său onEnd, așa cum documentează AI SDK pentru răspunsurile transmise în flux.
Aceeași aplicație poate răspunde la mesajele WhatsApp?
Da. Instrumentele numărului vin prin același client: list_numbers pentru connection_id, apoi send_message în decurs de 24 de ore de la ultimul mesaj al clientului. Ghidul AI SDK pentru WhatsApp explică primirea lor.
Cât costă easyCoexistence pentru o aplicație cu AI SDK?
US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, la fel pe fiecare rețea. Serverul MCP și Partner API sunt incluse, iar primele 3 zile sunt gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la