Usa herramientas de redes sociales en el Vercel AI SDK: Instagram, TikTok y más
El Vercel AI SDK recibe herramientas de redes sociales para Instagram, TikTok, Facebook, WhatsApp y más canales desde el servidor MCP de easyCoexistence. createMCPClient, del paquete @ai-sdk/mcp, abre una conexión HTTP a https://easycoexistence.com/api/mcp; un OAuthClientProvider que escribes mantiene el inicio de sesión, y los tools() del cliente se pasan a generateText o streamText para publicar, programar, responder comentarios y mensajes directos y leer métricas a través de la API oficial de cada red.
La función de @ai-sdk/mcp que termina un callback de OAuth a partir de serverUrl y authorizationCode, más callbackState y callbackIssuer cuando existen.
El stopWhen predeterminado de generateText, de modo que el modelo solo lee el resultado de una herramienta si stopWhen permite más pasos.
El transporte MCP que el AI SDK recomienda para producción; su transporte stdio está pensado solo para servidores locales.
La vida de un token de acceso MCP de easyCoexistence; su refresh token dura 60 días y se reemplaza en cada renovación.
El texto máximo de un DM de Instagram, medido en UTF-8, de modo que los acentos y emojis ocupan más de ese espacio.
¿Cómo inicia sesión el AI SDK en easyCoexistence?
A través de un OAuthClientProvider que implementas sobre tu propio almacenamiento, que ejecuta la función auth() del AI SDK. La primera llamada registra tu app en easyCoexistence como cliente público, guarda el verificador PKCE y te entrega la URL de consentimiento mediante redirectToAuthorization; devuelve REDIRECT y tu ruta envía al usuario allí. easyCoexistence luego redirige a tu callback con un código, y una segunda llamada a auth() con authorizationCode lo intercambia por tokens. Una vez guardados los tokens, auth() usa el refresh token para obtener un par nuevo sin devolver al usuario al inicio. Mantén idénticos redirectUrl y los redirect_uris registrados, ya que easyCoexistence los compara exactamente.
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");
}¿Cómo llegan las herramientas a generateText?
Desde createMCPClient con el transporte HTTP, la URL de easyCoexistence y el proveedor. tools() devuelve las herramientas del servidor como herramientas del AI SDK; conserva por nombre las que necesita el trabajo y pásalas a generateText o streamText. Define stopWhen con isStepCount, porque por defecto la llamada se detiene tras un paso y el modelo nunca lee lo que devolvió reply_to_comment. Pon las reglas de cada red en instructions, el parámetro que la referencia actual usa para el comportamiento del modelo. Cierra el cliente en un bloque finally, o en el callback onEnd de streamText, para que no quede ninguna conexión abierta.
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();
}
}¿Dónde deben vivir los tokens en un host serverless?
En cualquier lugar que sobreviva a una invocación: una fila de base de datos, Redis o un almacén clave-valor, indexado por el usuario de tu app al que pertenecen los tokens. Una función en Vercel u otra plataforma serverless arranca sin nada en memoria, así que un proveedor que guarda los tokens en una variable devuelve al usuario a la pantalla de consentimiento tras un arranque en frío. Los tokens de acceso duran una hora y los refresh tokens 60 días, con un refresh token nuevo cada vez que se usa, así que una app que llama a las herramientas al menos una vez cada 60 días sigue con sesión iniciada. Guarda el registro del cliente junto a los tokens, ya que el proveedor lee ambos en cada conexión.
¿Cómo llegan los comentarios y mensajes directos a la app?
Como POST firmados a un route handler, que set_social_webhook_destination registra para una cuenta y que luego recibe comentarios, menciones y DMs de Instagram y Facebook, además de comentarios de TikTok. Cada cuerpo contiene platform, account_id, external_id y entry, el evento de la red tal como se envió. Lee el cuerpo como texto, compara X-EC-Signature con él usando el secreto de firma de la cuenta y responde rápido: easyCoexistence da al route 8 segundos y envía cada evento una sola vez, sin volver a enviarlo. Pon el evento en una cola y deja que un worker llame a replyToEvent con él, para que el tiempo del modelo nunca cuente contra los 8 segundos.
¿Qué permite hacer cada red al modelo?
Todo lo que permita la API de la cuenta, lo que las instrucciones deben detallar:
- Instagram: publicaciones, Reels e Historias con imágenes JPEG; las respuestas a DMs solo a personas que escribieron en las últimas 24 horas, en como máximo 1,000 bytes.
- Facebook: publicaciones en la Página, respuestas a comentarios y respuestas en Messenger dentro de esas mismas 24 horas.
- TikTok: videos y publicaciones de fotos; las respuestas a comentarios siempre son públicas, con el ID del video como
post_id, y sin DMs. - WhatsApp:
send_messagedentro de las 24 horas del último mensaje del cliente,send_templatepara cualquier otro caso. - YouTube y LinkedIn: subidas y publicaciones cuando un usuario lo pide, respuestas a comentarios y analíticas; ninguna reenvía eventos, así que la app lee los comentarios nuevos con una programación.
Errores comunes
- Dejar stopWhen en su valor predeterminado. generateText se detiene tras el primer paso, así que el modelo llama a reply_to_comment y nunca sabe si la respuesta salió; permite algunos pasos con isStepCount.
- Guardar los tokens en una variable a nivel de módulo en un host serverless. El siguiente arranque en frío no la tiene, y el usuario vuelve a la pantalla de consentimiento; guárdalos donde tokens() y saveTokens() lleguen a una base de datos.
- Registrar una URL de redirección y enviar otra. easyCoexistence compara redirect_uri con el registro exactamente, así que una barra final o una ruta distinta termina el inicio de sesión en una página de error.
- Responder a la actividad propia de la cuenta. Instagram devuelve los DMs de la cuenta como echoes y sus respuestas públicas llegan como comentarios; descártalos ambos antes de que el mensaje llegue al modelo.
easyCoexistence da a los agentes que construyes con el Vercel AI SDK alcance hacia clientes en WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn y más canales, cada uno a través de su API oficial: herramientas MCP detrás de un inicio de sesión OAuth, eventos firmados para comentarios y DMs, y una cola de publicación de hasta 90 días de antelación, con cada conexión monitoreada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿Necesita esto Next.js o alojamiento en Vercel?
No. El AI SDK corre en Node.js, así que cualquier host que sirva una ruta HTTPS funciona, y el cliente MCP solo necesita salida HTTPS hacia easycoexistence.com.
¿Puede una interfaz de chat transmitir las llamadas a herramientas?
Sí. Pasa las mismas herramientas a streamText y cierra el cliente MCP en su callback onEnd, como documenta el AI SDK para las respuestas en streaming.
¿Puede la misma app responder mensajes de WhatsApp?
Sí. Las herramientas del número llegan por el mismo cliente: list_numbers para el connection_id, y luego send_message dentro de las 24 horas del último mensaje del cliente. La guía del AI SDK para WhatsApp explica cómo recibirlos.
¿Cuánto cuesta easyCoexistence para una app del AI SDK?
De US$ 9 a US$ 0.75 por conexión al mes, que baja a medida que añades conexiones, igual en cada red. El servidor MCP y la Partner API están incluidos, y los primeros 3 días son gratis.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el