Инструменты соцсетей в Vercel AI SDK: Instagram, TikTok и другие
Vercel AI SDK получает инструменты для Instagram, TikTok, Facebook, WhatsApp и других каналов из MCP-сервера easyCoexistence. createMCPClient из пакета @ai-sdk/mcp открывает HTTP-подключение к https://easycoexistence.com/api/mcp, OAuthClientProvider, который вы пишете, отвечает за вход, а tools() клиента передаются в generateText или streamText, чтобы публиковать, планировать, отвечать на комментарии и личные сообщения (DM) и читать аналитику через официальный API каждой сети.
Функция пакета @ai-sdk/mcp, которая завершает обратный вызов OAuth по serverUrl и authorizationCode, а также по callbackState и callbackIssuer, если они переданы.
stopWhen по умолчанию в generateText: модель читает результат инструмента только тогда, когда stopWhen допускает дополнительные шаги.
Транспорт MCP, который Vercel AI SDK рекомендует для продакшена; стандартный ввод-вывод (stdio) предназначен только для локальных серверов.
Срок жизни токена доступа MCP easyCoexistence; refresh-токен действует 60 дней и заменяется при каждом обновлении.
Максимальный объём текста одного DM в Instagram, измеряемый в UTF-8: акценты и эмодзи занимают в нём больше места.
Как AI SDK входит в easyCoexistence?
Через OAuthClientProvider, который вы реализуете поверх собственного хранилища и которым управляет функция auth() из AI SDK. Первый вызов регистрирует ваше приложение в easyCoexistence как публичный клиент, сохраняет PKCE-верификатор и передаёт ссылку согласия через redirectToAuthorization; функция возвращает REDIRECT, и ваш маршрут отправляет пользователя по ней. Затем easyCoexistence перенаправляет на ваш обратный вызов с кодом, и второй вызов auth() с authorizationCode обменивает его на токены. Когда токены сохранены, auth() использует refresh-токен для получения новой пары и не возвращает пользователя на вход. Держите redirectUrl и зарегистрированные redirect_uris идентичными: easyCoexistence сравнивает их точно.
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");
}Как инструменты попадают в generateText?
Из createMCPClient с HTTP-транспортом, URL easyCoexistence и провайдером. tools() возвращает инструменты сервера как инструменты AI SDK; оставьте по имени те, что нужны задаче, и передайте их в generateText или streamText. Задайте stopWhen с isStepCount, потому что по умолчанию вызов останавливается после одного шага, и модель не узнает, что вернул reply_to_comment. Правила для каждой сети опишите в instructions, параметре, который текущий справочник использует для поведения модели. Закрывайте клиент в блоке finally или в колбэке onEnd у streamText, чтобы не оставить открытым ни одного подключения.
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();
}
}Где хранить токены на бессерверной платформе?
Там, где данные переживают один запуск: строка в базе данных, Redis или хранилище «ключ-значение», с ключом по пользователю вашего приложения, которому принадлежат токены. Функция на Vercel или другой бессерверной платформе стартует с пустой памятью, поэтому провайдер, который хранит токены в переменной, после холодного старта возвращает пользователя на экран согласия. Токены доступа живут час, refresh-токены 60 дней, и при каждом использовании выдаётся новый refresh-токен, так что приложение, которое вызывает инструменты хотя бы раз в 60 дней, остаётся авторизованным. Регистрацию клиента храните рядом с токенами: провайдер читает оба при каждом подключении.
Как комментарии и DM попадают в приложение?
Подписанными POST-запросами на обработчик маршрута, который регистрирует set_social_webhook_destination для аккаунта. Далее приходят комментарии, упоминания и DM из Instagram и Facebook, а также комментарии TikTok. Каждое тело содержит platform, account_id, external_id и entry, событие сети в исходном виде. Читайте тело как текст, сверяйте X-EC-Signature с ним по секрету подписи аккаунта и отвечайте быстро: easyCoexistence даёт маршруту 8 секунд и отправляет каждое событие один раз, без повторов. Поставьте событие в очередь и пусть воркер вызывает replyToEvent с ним, чтобы время модели не шло в счёт этих 8 секунд.
Что каждая сеть позволяет модели?
Столько, сколько разрешает API аккаунта; инструкции должны это прописать:
- Instagram: публикации, Reels и Stories с JPEG-изображениями; ответы в DM только тем, кто написал за последние 24 часа, не более 1 000 байт.
- Facebook: публикации на Странице, ответы на комментарии и ответы в Messenger в пределах тех же 24 часов.
- TikTok: видео и фотопубликации; ответы на комментарии всегда публичные, с ID видео в качестве
post_id, без DM. - WhatsApp:
send_messageв течение 24 часов после последнего сообщения клиента,send_templateдля всех остальных. - YouTube и LinkedIn: загрузки и публикации по запросу пользователя, ответы на комментарии и аналитика; ни одна из двух сетей не передаёт события, поэтому приложение читает новые комментарии по расписанию.
Распространённые ошибки
- Оставить stopWhen по умолчанию. generateText останавливается после первого шага, поэтому модель вызывает reply_to_comment и не узнаёт, ушёл ли ответ; разрешите несколько шагов через isStepCount.
- Хранить токены в переменной уровня модуля на бессерверной платформе. При следующем холодном старте её не будет, и пользователь снова окажется на экране согласия; сохраняйте токены там, куда дотягиваются tokens() и saveTokens(), то есть в базу данных.
- Зарегистрировать один redirect URL, а отправлять другой. easyCoexistence сверяет redirect_uri с регистрацией точно, так что завершающий слеш или другой путь приводят к странице ошибки входа.
- Отвечать на собственную активность аккаунта. Instagram присылает DM аккаунта обратно как эхо, а его публичные ответы возвращаются как комментарии; пропускайте оба типа до того, как запрос к модели дойдёт до неё.
easyCoexistence даёт агентам, которых вы строите на Vercel AI SDK, доступ к клиентам в WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналах через официальный API каждой сети: MCP-инструменты за входом по OAuth, подписанные события для комментариев и DM и очередь публикаций на 90 дней вперёд; каждое подключение находится под мониторингом круглосуточно. От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужен ли Next.js или хостинг Vercel?
Нет. AI SDK работает в Node.js, поэтому подойдёт любой хостинг, который отдаёт маршрут по HTTPS. MCP-клиенту нужен только исходящий HTTPS на easycoexistence.com.
Может ли чат-интерфейс передавать вызовы инструментов потоком?
Да. Передайте те же инструменты в streamText и закройте MCP-клиент в колбэке onEnd, как AI SDK описывает для потоковых ответов.
Может ли то же приложение отвечать на сообщения WhatsApp?
Да. Инструменты номера приходят через тот же клиент: list_numbers для connection_id, затем send_message в течение 24 часов после последнего сообщения клиента. Руководство AI SDK по WhatsApp описывает приём сообщений.
Сколько стоит easyCoexistence для приложения на AI SDK?
От US$ 9 до US$ 0,75 за подключение в месяц, с понижением по мере добавления подключений, одинаково в каждой сети. В стоимость входят MCP-сервер и Partner API, а первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на