Vercel AI SDK: Instagram, TikTok e mais ferramentas de redes sociais
O Vercel AI SDK recebe ferramentas de redes sociais para Instagram, TikTok, Facebook, WhatsApp e mais canais, a partir do servidor MCP da easyCoexistence. O createMCPClient, do pacote @ai-sdk/mcp, abre uma ligação HTTP a https://easycoexistence.com/api/mcp; um OAuthClientProvider que implementa assegura o início de sessão, e o tools() do cliente entra em generateText ou streamText para publicar, agendar, responder a comentários e mensagens diretas e ler métricas através da API oficial de cada rede.
A função do @ai-sdk/mcp que conclui um callback OAuth a partir de serverUrl e authorizationCode, além de callbackState e callbackIssuer quando existem.
O stopWhen predefinido do generateText, pelo que o modelo só lê o resultado de uma ferramenta quando o stopWhen permite mais passos.
O transporte MCP que o AI SDK recomenda para produção; o seu transporte stdio destina-se apenas a servidores locais.
A duração de um token de acesso MCP da easyCoexistence; o seu token de atualização dura 60 dias e é substituído em cada atualização.
O texto máximo de uma mensagem direta do Instagram, medido em UTF-8, pelo que os acentos e os emojis ocupam mais espaço.
Como é que o AI SDK inicia sessão na easyCoexistence?
Através de um OAuthClientProvider que implementa sobre o seu próprio armazenamento, que a função auth() do AI SDK conduz. A primeira chamada regista a sua aplicação na easyCoexistence como cliente público, guarda o verificador PKCE e entrega-lhe o URL de consentimento através de redirectToAuthorization; devolve REDIRECT, e a sua rota envia o utilizador para lá. A easyCoexistence redireciona depois para o seu callback com um código, e uma segunda chamada a auth() com authorizationCode troca-o por tokens. Quando os tokens estão guardados, auth() utiliza o token de atualização para obter um novo par em vez de enviar o utilizador de volta. Mantenha redirectUrl e os redirect_uris registados idênticos, já que a easyCoexistence os compara exatamente.
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");
}Como chegam as ferramentas ao generateText?
Do createMCPClient com o transporte HTTP, o URL da easyCoexistence e o provider. O tools() devolve as ferramentas do servidor como ferramentas do AI SDK; mantenha pelo nome as que o trabalho exige e passe-as a generateText ou streamText. Defina stopWhen com isStepCount, porque por predefinição a chamada para após um passo e o modelo nunca lê o que o reply_to_comment devolveu. Coloque as regras da rede em instructions, o parâmetro que a referência atual usa para o comportamento do modelo. Feche o cliente num bloco finally, ou no callback onEnd do streamText, para que não fique nenhuma ligação aberta.
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();
}
}Onde devem ficar os tokens num alojamento serverless?
Em qualquer sítio que sobreviva a uma invocação: uma linha numa base de dados, Redis ou um armazenamento chave-valor, indexado pelo utilizador da sua aplicação a quem os tokens pertencem. Uma função na Vercel ou noutra plataforma serverless começa sem nada em memória, por isso um provider que guarda os tokens numa variável envia o utilizador de volta ao ecrã de consentimento depois de um arranque a frio. Os tokens de acesso duram uma hora e os de atualização 60 dias, com um novo token de atualização a cada utilização, pelo que uma aplicação que chama as ferramentas pelo menos uma vez em 60 dias mantém o início de sessão. Guarde o registo do cliente junto dos tokens, já que o provider lê ambos em cada ligação.
Como chegam os comentários e as mensagens diretas à aplicação?
Como pedidos POST assinados para um route handler, que o set_social_webhook_destination regista para uma conta e que depois recebe comentários, menções e mensagens diretas do Instagram e do Facebook, e comentários do TikTok. Cada corpo contém platform, account_id, external_id e entry, o evento da rede tal como foi enviado. Leia o corpo como texto, verifique o X-EC-Signature contra ele com o segredo de assinatura da conta, e responda depressa: a easyCoexistence dá à rota 8 segundos e envia cada evento uma só vez, sem nova tentativa. Coloque o evento numa fila e deixe um worker chamar replyToEvent com ele, para que o tempo do modelo nunca conte nos 8 segundos.
O que permite cada rede ao modelo?
Tanto quanto a API da conta permite, o que as instruções devem detalhar:
- Instagram: publicações, Reels e Stories com imagens JPEG; respostas em mensagens diretas apenas a pessoas que escreveram nas últimas 24 horas, com no máximo 1,000 bytes.
- Facebook: publicações na Página, respostas a comentários e respostas no Messenger dentro das mesmas 24 horas.
- TikTok: vídeos e publicações com fotografias; respostas a comentários sempre públicas, com o ID do vídeo como
post_id, e sem mensagens diretas. - WhatsApp:
send_messagedentro de 24 horas da última mensagem do cliente,send_templatepara qualquer outra pessoa. - YouTube e LinkedIn: carregamentos e publicações quando um utilizador o pede, respostas a comentários e métricas; nenhum dos dois reencaminha eventos, por isso a aplicação lê os novos comentários de acordo com uma agenda.
Erros comuns
- Deixar o stopWhen no valor predefinido. O generateText para após o primeiro passo, por isso o modelo chama reply_to_comment e nunca fica a saber se a resposta foi enviada; permita alguns passos com isStepCount.
- Guardar os tokens numa variável ao nível do módulo num alojamento serverless. O arranque a frio seguinte já não a tem, e o utilizador volta ao ecrã de consentimento; guarde-os onde tokens() e saveTokens() chegam a uma base de dados.
- Registar um URL de redirecionamento e enviar outro. A easyCoexistence compara o redirect_uri com o registo exatamente, por isso uma barra final ou outro caminho termina o início de sessão numa página de erro.
- Responder à atividade da própria conta. O Instagram devolve as mensagens enviadas pela conta como ecos e as respostas públicas voltam como comentários, por isso ignore ambos antes de chegarem ao modelo.
A easyCoexistence dá aos agentes que cria com o Vercel AI SDK alcance a clientes no WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, cada um através da API oficial: ferramentas MCP por trás de um início de sessão OAuth, eventos assinados para comentários e mensagens diretas, e uma fila de publicações até 90 dias à frente, com cada ligação monitorizada 24 horas por dia. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Isto precisa de Next.js ou de alojamento na Vercel?
Não. O AI SDK corre em Node.js, por isso qualquer alojamento que sirva uma rota HTTPS funciona, e o cliente MCP só precisa de HTTPS de saída para easycoexistence.com.
Uma interface de chat pode transmitir as chamadas às ferramentas?
Sim. Passe as mesmas ferramentas ao streamText e feche o cliente MCP no seu callback onEnd, como o AI SDK documenta para respostas em fluxo.
A mesma aplicação pode responder a mensagens do WhatsApp?
Sim. As ferramentas do número chegam pelo mesmo cliente: list_numbers para o connection_id e, depois, send_message dentro de 24 horas da última mensagem do cliente. O guia do AI SDK para WhatsApp explica como as receber.
Quanto custa a easyCoexistence para uma aplicação com o AI SDK?
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, igual em cada rede. A MCP server e a Partner API estão incluídas, e os primeiros 3 dias são gratuitos.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em