InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Social media tools in de Vercel AI SDK: Instagram, TikTok en meer

De Vercel AI SDK krijgt social media-tools voor Instagram, TikTok, Facebook, WhatsApp en meer kanalen via de MCP-server van easyCoexistence. createMCPClient, uit het pakket @ai-sdk/mcp, opent een HTTP-verbinding met https://easycoexistence.com/api/mcp. Een OAuthClientProvider die jij schrijft, houdt de aanmelding bij, en de tools() van de client gaan naar generateText of streamText om te publiceren, in te plannen, te reageren op reacties en DM's en inzichten te lezen via de officiële API van elk netwerk.

auth()

De @ai-sdk/mcp-functie die een OAuth-callback afrondt op basis van serverUrl en de authorizationCode, plus callbackState en callbackIssuer wanneer die aanwezig zijn.

isStepCount(1)

De standaard stopWhen van generateText, waardoor het model het resultaat van een tool alleen leest wanneer stopWhen meer stappen toestaat.

HTTP

Het MCP-transport dat de AI SDK aanraadt voor productie; het stdio-transport is alleen bedoeld voor lokale servers.

1 hour

De levensduur van een MCP-toegangstoken van easyCoexistence; het refresh-token geldt 60 dagen en wordt bij elke vernieuwing vervangen.

1,000 bytes

De meeste tekst die één Instagram-DM bevat, gemeten in UTF-8, zodat accenten en emoji er meer van innemen.

Hoe meldt de AI SDK zich aan bij easyCoexistence?

Via een OAuthClientProvider die jij implementeert op je eigen opslag, die de auth()-functie van de AI SDK aanstuurt. De eerste aanroep registreert je app bij easyCoexistence als publieke client, bewaart de PKCE-verifier en geeft je de toestemmings-URL via redirectToAuthorization; die geeft REDIRECT terug en je route stuurt de gebruiker daarheen. easyCoexistence stuurt de gebruiker dan terug naar je callback met een code, en een tweede auth()-aanroep met authorizationCode ruilt die in voor tokens. Zodra de tokens zijn opgeslagen, gebruikt auth() het refresh-token voor een nieuw paar, zonder de gebruiker opnieuw te sturen. Houd redirectUrl en de geregistreerde redirect_uris identiek, want easyCoexistence vergelijkt ze exact.

An OAuthClientProvider over your database, with the two routes it needs
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");
}

Hoe komen de tools bij generateText?

Via createMCPClient met het HTTP-transport, de easyCoexistence-URL en de provider. tools() geeft de tools van de server terug als AI SDK-tools; houd op naam de tools over die de taak nodig heeft en geef ze door aan generateText of streamText. Zet stopWhen met isStepCount, want standaard stopt de aanroep na één stap en leest het model nooit wat reply_to_comment heeft teruggegeven. Zet de netwerkregels in instructions, de parameter die de huidige referentie gebruikt voor het gedrag van het model. Sluit de client af in een finally-blok, of in de onEnd-callback van streamText, zodat er geen verbinding openstaat.

Reply to one forwarded comment or DM with a filtered set of tools
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();
  }
}

Waar moeten de tokens staan op een serverless host?

Op een plek die één aanroep overleeft: een databaserij, Redis of een key-value store, gekoppeld aan de gebruiker van jouw app aan wie de tokens toebehoren. Een functie op Vercel of een ander serverless platform begint zonder iets in het geheugen, dus een provider die tokens in een variabele bewaart, stuurt de gebruiker na een cold start terug naar het toestemmingsscherm. Toegangstokens gelden een uur en refresh-tokens 60 dagen, met elke keer een nieuw refresh-token wanneer het wordt gebruikt; een app die de tools minstens één keer in 60 dagen aanroept, blijft dus ingelogd. Bewaar de clientregistratie naast de tokens, want de provider leest beide bij elke verbinding.

Hoe bereiken reacties en DM's de app?

Als ondertekende POST-verzoeken naar een route handler, die set_social_webhook_destination registreert voor een account. Daarna ontvangt die handler Instagram- en Facebook-reacties, vermeldingen en DM's, en TikTok-reacties. Elke body bevat platform, account_id, external_id en entry, de gebeurtenis van het netwerk zoals die is verzonden. Lees de body als tekst, controleer X-EC-Signature daarop met het ondertekeningsgeheim van het account en reageer snel: easyCoexistence geeft de route 8 seconden en stuurt elke gebeurtenis één keer, zonder nieuwe poging. Zet de gebeurtenis in een wachtrij en laat een worker replyToEvent ermee aanroepen, zodat de rekentijd van het model nooit meetelt in die 8 seconden.

Wat mag het model per netwerk doen?

Net zoveel als de API van het account toestaat, wat de instructies moeten uitschrijven:

  • Instagram: posts, Reels en Stories met JPEG-afbeeldingen; DM-antwoorden alleen aan mensen die in de laatste 24 uur hebben geschreven, in maximaal 1.000 bytes.
  • Facebook: Pagina-posts, antwoorden op reacties en Messenger-antwoorden binnen dezelfde 24 uur.
  • TikTok: video's en fotoposts; antwoorden op reacties zijn altijd openbaar, met de ID van de video als post_id, en er zijn geen DM's.
  • WhatsApp: send_message binnen 24 uur na het laatste bericht van de klant, send_template voor iedereen anders.
  • YouTube en LinkedIn: uploads en posts wanneer een gebruiker erom vraagt, antwoorden op reacties en analyses; geen van beide stuurt gebeurtenissen door, dus de app leest nieuwe reacties volgens een schema.

Veelgemaakte fouten

  • stopWhen op de standaardwaarde laten. generateText stopt na de eerste stap, dus het model roept reply_to_comment aan en leert nooit of het antwoord is verstuurd; sta een paar stappen toe met isStepCount.
  • Tokens bewaren in een variabele op moduleniveau op een serverless host. Bij de volgende cold start is die leeg en belandt de gebruiker opnieuw op het toestemmingsscherm; sla ze op waar tokens() en saveTokens() bij een database kunnen.
  • Eén redirect-URL registreren en een andere versturen. easyCoexistence controleert redirect_uri exact tegen de registratie, dus een slash aan het eind of een ander pad eindigt de aanmelding op een foutpagina.
  • Reageren op de eigen activiteit van het account. Instagram stuurt de DM's van het account terug als echo's en openbare antwoorden komen terug als reacties; sla beide over voordat de prompt het model bereikt.
Dit doen met EasyCoexistence

easyCoexistence geeft de agents die je bouwt met de Vercel AI SDK bereik tot klanten op WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn en meer kanalen, elk via de officiële API: MCP-tools achter een OAuth-aanmelding, ondertekende gebeurtenissen voor reacties en DM's, en een wachtrij voor posts tot 90 dagen vooruit, met elke verbinding 24/7 bewaakt. US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Heeft dit Next.js of Vercel-hosting nodig?

Nee. De AI SDK draait in Node.js, dus elke host die een HTTPS-route aanbiedt werkt, en de MCP-client heeft alleen uitgaand HTTPS naar easycoexistence.com nodig.

Kan een chatinterface de toolaanroepen streamen?

Ja. Geef dezelfde tools door aan streamText en sluit de MCP-client af in de onEnd-callback, zoals de AI SDK voor gestreamde antwoorden beschrijft.

Kan dezelfde app antwoorden op WhatsApp-berichten?

Ja. De tools van het nummer komen via dezelfde client: list_numbers voor de connection_id, daarna send_message binnen 24 uur na het laatste bericht van de klant. De AI SDK-gids voor WhatsApp behandelt het ontvangen ervan.

Wat kost easyCoexistence voor een AI SDK-app?

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je verbindingen toevoegt, op elk netwerk gelijk. De MCP-server en de Partner API zijn erbij inbegrepen, en de eerste 3 dagen zijn gratis.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op