Usa gli strumenti social nel Vercel AI SDK: Instagram, TikTok e altri
Il Vercel AI SDK riceve strumenti social per Instagram, TikTok, Facebook, WhatsApp e altri canali dal server MCP di easyCoexistence. createMCPClient, dal pacchetto @ai-sdk/mcp, apre una connessione HTTP verso https://easycoexistence.com/api/mcp, un OAuthClientProvider che scrivi tu mantiene l'accesso, e i tools() del client entrano in generateText o streamText per pubblicare, programmare, rispondere a commenti e DM e leggere le statistiche tramite l'API ufficiale di ciascuna rete.
La funzione di @ai-sdk/mcp che completa un callback OAuth partendo da serverUrl e authorizationCode, più callbackState e callbackIssuer quando presenti.
Lo stopWhen predefinito di generateText, quindi il modello legge il risultato di uno strumento solo se stopWhen consente altri passaggi.
Il trasporto MCP che l'AI SDK raccomanda per la produzione; il suo trasporto stdio è pensato solo per server locali.
La durata di un token di accesso MCP di easyCoexistence; il suo refresh token dura 60 giorni e viene sostituito a ogni rinnovo.
La lunghezza massima di un DM Instagram, misurata in UTF-8: accenti ed emoji ne occupano di più.
Come accede l'AI SDK a easyCoexistence?
Tramite un OAuthClientProvider che implementi sul tuo archivio, che la funzione auth() dell'AI SDK pilota. La prima chiamata registra la tua app presso easyCoexistence come client pubblico, salva il verifier PKCE e ti passa l'URL di consenso tramite redirectToAuthorization; restituisce REDIRECT, e la tua route invia l'utente lì. easyCoexistence poi reindirizza al tuo callback con un code, e una seconda chiamata a auth() con authorizationCode lo scambia con i token. Una volta salvati i token, auth() usa il refresh token per ottenerne una nuova coppia invece di rimandare l'utente indietro. Mantieni identici redirectUrl e i redirect_uris registrati, perché easyCoexistence li confronta alla lettera.
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");
}Come arrivano gli strumenti a generateText?
Da createMCPClient con il trasporto HTTP, l'URL di easyCoexistence e il provider. tools() restituisce gli strumenti del server come strumenti dell'AI SDK; tieni per nome quelli che servono al lavoro e passali a generateText o streamText. Imposta stopWhen con isStepCount, perché di default la chiamata si ferma dopo un passaggio e il modello non legge mai ciò che ha restituito reply_to_comment. Metti le regole di ciascuna rete in instructions, il parametro che il riferimento attuale usa per il comportamento del modello. Chiudi il client in un blocco finally, oppure nel callback onEnd di streamText, così non resta aperta nessuna connessione.
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();
}
}Dove devono stare i token su un host serverless?
In un posto che sopravvive a una singola invocazione: una riga di database, Redis o un key-value store, associata all'utente della tua app a cui appartengono i token. Una funzione su Vercel o su un'altra piattaforma serverless parte senza nulla in memoria, quindi un provider che tiene i token in una variabile rimanda l'utente alla schermata di consenso dopo un cold start. I token di accesso durano un'ora e i refresh token 60 giorni, con un nuovo refresh token a ogni utilizzo, quindi un'app che richiama gli strumenti almeno una volta ogni 60 giorni resta connessa. Tieni la registrazione del client accanto ai token, perché il provider legge entrambi a ogni connessione.
Come arrivano commenti e DM all'app?
Come POST firmati verso un route handler, che set_social_webhook_destination registra per un account e che poi riceve commenti, menzioni e DM di Instagram e Facebook, e commenti di TikTok. Ogni corpo contiene platform, account_id, external_id ed entry, l'evento della rete così come è stato inviato. Leggi il corpo come testo, verifica X-EC-Signature su di esso con il segreto di firma dell'account e rispondi in fretta: easyCoexistence concede alla route 8 secondi e invia ogni evento una sola volta, senza ritentare. Metti l'evento in una coda e lascia che un worker chiami replyToEvent con esso, così il tempo del modello non conta mai sugli 8 secondi.
Che cosa permette a ciascuna rete il modello?
Quanto consente l'API dell'account, che le istruzioni devono descrivere con precisione:
- Instagram: post, Reel e Storie con immagini JPEG; risposte ai DM solo a chi ha scritto nelle ultime 24 ore, in al massimo 1.000 byte.
- Facebook: post sulla Pagina, risposte ai commenti e risposte su Messenger entro le stesse 24 ore.
- TikTok: video e post di foto; le risposte ai commenti sono sempre pubbliche, con l'ID del video come
post_id, e niente DM. - WhatsApp:
send_messageentro 24 ore dall'ultimo messaggio del cliente,send_templateper chiunque altro. - YouTube e LinkedIn: caricamenti e post su richiesta dell'utente, risposte ai commenti e statistiche; nessuno dei due inoltra eventi, quindi l'app legge i nuovi commenti a intervalli programmati.
Errori comuni
- Lasciare stopWhen al valore predefinito. generateText si ferma al primo passaggio, quindi il modello chiama reply_to_comment e non scopre mai se la risposta è partita; consenti alcuni passaggi con isStepCount.
- Tenere i token in una variabile a livello di modulo su un host serverless. Al cold start successivo non ce ne sono più, e l'utente torna alla schermata di consenso; salvali dove tokens() e saveTokens() raggiungono un database.
- Registrare un redirect URL e inviarne un altro. easyCoexistence confronta redirect_uri con la registrazione alla lettera, quindi una barra finale o un percorso diverso chiude l'accesso su una pagina di errore.
- Rispondere all'attività dell'account stesso. Instagram rimanda i DM inviati dall'account come echo e le sue risposte pubbliche tornano come commenti; scartali entrambi prima che il messaggio raggiunga il modello.
easyCoexistence dà agli agenti che costruisci con il Vercel AI SDK la possibilità di raggiungere i clienti su WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e altri canali, ciascuno tramite la sua API ufficiale: strumenti MCP dietro un accesso OAuth, eventi firmati per commenti e DM e una coda di pubblicazione fino a 90 giorni prima, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo decrescente man mano che aggiungi connessioni, e i primi 3 giorni di prova gratuita.
Domande frequenti
Serve Next.js o l'hosting di Vercel?
No. L'AI SDK gira in Node.js, quindi va bene qualsiasi host che serve una route HTTPS, e il client MCP richiede solo HTTPS in uscita verso easycoexistence.com.
Un'interfaccia di chat può trasmettere in streaming le chiamate agli strumenti?
Sì. Passa gli stessi strumenti a streamText e chiudi il client MCP nel suo callback onEnd, come documenta l'AI SDK per le risposte in streaming.
La stessa app può rispondere ai messaggi WhatsApp?
Sì. Gli strumenti del numero arrivano dallo stesso client: list_numbers per il connection_id, poi send_message entro 24 ore dall'ultimo messaggio del cliente. La guida dell'AI SDK per WhatsApp spiega come riceverli.
Quanto costa easyCoexistence per un'app con l'AI SDK?
Da US$ 9 a US$ 0,75 per connessione al mese, con prezzo decrescente man mano che aggiungi connessioni, uguale su ogni rete. Il server MCP e la Partner API sono compresi, e i primi 3 giorni sono gratuiti.
Continua a leggere
Collega il tuo primo canale in due minuti.
Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.
- 3 giorni gratis
- Disdici quando vuoi
- Solo API ufficiali
- Monitorato 24/7
Verificato il