Używaj narzędzi social media w Vercel AI SDK: Instagram, TikTok i nie tylko
Vercel AI SDK zyskuje narzędzia do social media dla Instagrama, TikToka, Facebooka, WhatsAppa i kolejnych kanałów z serwera MCP easyCoexistence. createMCPClient z pakietu @ai-sdk/mcp otwiera połączenie HTTP z https://easycoexistence.com/api/mcp, a napisany przez Ciebie OAuthClientProvider prowadzi logowanie. Metoda tools() klienta trafia do generateText lub streamText, by publikować, planować posty, odpowiadać na komentarze i wiadomości DM oraz odczytywać statystyki przez oficjalne API każdej sieci.
Funkcja z @ai-sdk/mcp, która kończy callback OAuth na podstawie serverUrl i authorizationCode, a także callbackState i callbackIssuer, gdy są obecne.
Domyślne stopWhen w generateText, więc model odczytuje wynik narzędzia tylko wtedy, gdy stopWhen pozwala na więcej kroków.
Transport MCP, który AI SDK zaleca w produkcji; transport stdio jest przeznaczony wyłącznie dla lokalnych serwerów.
Czas życia tokenu dostępu MCP easyCoexistence; token odświeżania działa 60 dni i jest wymieniany przy każdym odświeżeniu.
Najdłuższa treść jednej wiadomości DM na Instagramie, liczona w UTF-8, więc akcenty i emoji zajmują jej więcej miejsca.
Jak AI SDK loguje się do easyCoexistence?
Przez OAuthClientProvider, który implementujesz nad własnym magazynem danych i którym steruje funkcja auth() z AI SDK. Pierwsze wywołanie rejestruje Twoją aplikację w easyCoexistence jako publiczny klient, zapisuje weryfikator PKCE i przekazuje adres zgody przez redirectToAuthorization; zwraca REDIRECT, a Twoja trasa wysyła tam użytkownika. easyCoexistence przekierowuje następnie na Twój callback z kodem, a drugie wywołanie auth() z authorizationCode wymienia go na tokeny. Gdy tokeny są zapisane, auth() używa tokenu odświeżania do uzyskania nowej pary zamiast odsyłać użytkownika do logowania. Zachowaj redirectUrl i zarejestrowane redirect_uris identyczne, ponieważ easyCoexistence porównuje je dokładnie.
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");
}Jak narzędzia trafiają do generateText?
Z createMCPClient z transportem HTTP, adresem easyCoexistence i providerem. tools() zwraca narzędzia serwera jako narzędzia AI SDK; zachowaj te potrzebne zadaniu po nazwie i przekaż je do generateText lub streamText. Ustaw stopWhen z isStepCount, ponieważ domyślnie wywołanie kończy się po jednym kroku i model nigdy nie odczyta, co zwróciło reply_to_comment. Zasady dotyczące sieci umieść w instructions, czyli parametrze, którego aktualna dokumentacja używa do sterowania zachowaniem modelu. Zamknij klienta w bloku finally albo w callbacku onEnd z streamText, aby nie zostało otwarte żadne połączenie.
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();
}
}Gdzie tokeny powinny być przechowywane na hostingu serverless?
Tam, gdzie przetrwają jedno wywołanie: w wierszu bazy danych, Redisie lub magazynie klucz-wartość, z kluczem odpowiadającym użytkownikowi Twojej aplikacji, do którego należą tokeny. Funkcja na Vercel lub innej platformie serverless startuje bez niczego w pamięci, więc provider, który trzyma tokeny w zmiennej, po zimnym starcie odsyła użytkownika na ekran zgody. Tokeny dostępu działają godzinę, a tokeny odświeżania 60 dni, przy czym przy każdym użyciu wydawany jest nowy token odświeżania, więc aplikacja wywołująca narzędzia przynajmniej raz na 60 dni pozostaje zalogowana. Trzymaj rejestrację klienta obok tokenów, ponieważ provider odczytuje oba przy każdym połączeniu.
Jak komentarze i wiadomości DM docierają do aplikacji?
Jako podpisane żądania POST do handlera trasy, który set_social_webhook_destination rejestruje dla konta i który następnie odbiera komentarze, wzmianki i wiadomości DM z Instagrama i Facebooka oraz komentarze z TikToka. Każde ciało zawiera platform, account_id, external_id i entry, czyli zdarzenie sieci w postaci, w jakiej zostało wysłane. Odczytaj ciało jako tekst, sprawdź nagłówek X-EC-Signature względem niego sekretem podpisu konta i odpowiedz szybko: easyCoexistence daje trasie 8 sekund i wysyła każde zdarzenie raz, bez ponawiania. Umieść zdarzenie w kolejce i pozwól workerowi wywołać replyToEvent z nim, aby czas modelu nie wchodził w tych 8 sekund.
Co każda sieć pozwala modelowi zrobić?
Tyle, ile pozwala API konta; instrukcje powinny to dokładnie opisać:
- Instagram: posty, Reels i Stories ze zdjęciami JPEG; odpowiedzi DM tylko do osób, które napisały w ciągu ostatnich 24 godzin, w maksymalnie 1 000 bajtów.
- Facebook: posty na Stronie, odpowiedzi na komentarze i odpowiedzi w Messengerze w tych samych 24 godzinach.
- TikTok: filmy i posty ze zdjęciami; odpowiedzi na komentarze zawsze publiczne, z ID filmu jako
post_id, bez wiadomości DM. - WhatsApp:
send_messagew ciągu 24 godzin od ostatniej wiadomości klienta,send_templatedla każdego innego. - YouTube i LinkedIn: przesyłanie i publikacja, gdy użytkownik o to poprosi, odpowiedzi na komentarze i statystyki; żadna z tych sieci nie przekazuje zdarzeń, więc aplikacja czyta nowe komentarze według harmonogramu.
Typowe błędy
- Zostawienie stopWhen w ustawieniu domyślnym. generateText kończy się po pierwszym kroku, więc model wywołuje reply_to_comment i nigdy nie dowiaduje się, czy odpowiedź została wysłana; zezwól na kilka kroków przez isStepCount.
- Przechowywanie tokenów w zmiennej na poziomie modułu na hostingu serverless. Następny zimny start już ich nie ma, a użytkownik ląduje ponownie na ekranie zgody; zapisz je tam, gdzie `tokens()` i `saveTokens()` docierają do bazy danych.
- Rejestracja jednego adresu przekierowania i wysyłanie innego. easyCoexistence sprawdza redirect_uri dokładnie względem rejestracji, więc ukośnik na końcu lub inna ścieżka kończy logowanie na stronie błędu.
- Odpowiadanie na własną aktywność konta. Instagram odsyła wiadomości DM konta jako echa, a jego publiczne odpowiedzi wracają jako komentarze, więc pomiń jedno i drugie, zanim prompt dotrze do modelu.
easyCoexistence daje agentom, które budujesz w Vercel AI SDK, zasięg do klientów na WhatsAppie, Instagramie, Facebooku, TikToku, YouTube, LinkedIn i kolejnych kanałach, każdym przez oficjalne API: narzędzia MCP za logowaniem OAuth, podpisane zdarzenia dla komentarzy i wiadomości DM oraz kolejkę publikacji do 90 dni naprzód, a każde połączenie jest monitorowane 24/7. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Czy to wymaga Next.js lub hostingu Vercel?
Nie. AI SDK działa w Node.js, więc każdy hosting obsługujący trasę HTTPS się nadaje, a klient MCP potrzebuje jedynie wychodzącego HTTPS do easycoexistence.com.
Czy interfejs czatu może strumieniować wywołania narzędzi?
Tak. Przekaż te same narzędzia do streamText i zamknij klienta MCP w callbacku onEnd, tak jak AI SDK opisuje dla odpowiedzi strumieniowanych.
Czy ta sama aplikacja może odpowiadać na wiadomości WhatsApp?
Tak. Narzędzia numeru przychodzą przez ten sam klient: list_numbers dla connection_id, a następnie send_message w ciągu 24 godzin od ostatniej wiadomości klienta. Przewodnik AI SDK dla WhatsAppa opisuje ich odbieranie.
Ile kosztuje easyCoexistence dla aplikacji z AI SDK?
Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając w miarę dodawania połączeń, tak samo w każdej sieci. W cenie są serwer MCP i Partner API, a pierwsze 3 dni są bezpłatne.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w