在 Vercel AI SDK 中使用社交媒体工具:Instagram、TikTok 等
Vercel AI SDK 可通过 easyCoexistence 的 MCP 服务器,获得 Instagram、TikTok、Facebook、WhatsApp 等渠道的社交媒体工具。来自 @ai-sdk/mcp 包的 createMCPClient 会建立到 https://easycoexistence.com/api/mcp 的 HTTP 连接,您编写的 OAuthClientProvider 负责保持登录状态,客户端的 tools() 则被放入 generateText 或 streamText,通过各平台的官方 API 发布、定时发布、回复评论与私信,并读取洞察数据。
@ai-sdk/mcp 中的函数,依据 serverUrl 与 authorizationCode 完成 OAuth 回调;存在时还需提供 callbackState 与 callbackIssuer。
generateText 的默认 stopWhen 设置,只有在 stopWhen 允许更多步骤时,模型才会读取工具的结果。
AI SDK 为生产环境推荐的 MCP 传输方式;其 stdio 传输仅适用于本地服务器。
easyCoexistence MCP 访问令牌的有效期;其刷新令牌有效期为 60 天,并会在每次刷新时被替换。
单条 Instagram 私信可承载的最长文本,以 UTF-8 计算,因此重音字符与表情符号会占用更多空间。
AI SDK 如何登录 easyCoexistence?
通过您自行实现、并基于自有存储的 OAuthClientProvider 完成登录,由 AI SDK 的 auth() 函数驱动。第一次调用会以公共客户端身份在 easyCoexistence 注册您的应用,保存 PKCE verifier,并通过 redirectToAuthorization 提供授权 URL;此时返回 REDIRECT,您的路由需将用户引导至该地址。easyCoexistence 随后会携带 code 重定向至您的回调地址,而带有 authorizationCode 的第二次 auth() 调用会将其兑换为令牌。令牌保存之后,auth() 会使用刷新令牌获取新的一组令牌,而无需让用户重新登录。请确保 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 传输、easyCoexistence 的 URL 与 provider 即可。tools() 会将服务器的工具以 AI SDK 工具的形式返回;请按名称保留任务所需的工具,并将其传给 generateText 或 streamText。请使用 isStepCount 设置 stopWhen,因为默认情况下调用会在一步后停止,模型将无法读取 reply_to_comment 的返回结果。网络规则请写入 instructions,这是当前参考文档中用于控制模型行为的参数。请在 finally 代码块中关闭客户端,或在 streamText 的 onEnd 回调中关闭,以免留下未关闭的连接。
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 或其他无服务器平台上的函数每次启动时内存都是空的,因此把令牌保存在变量中的 provider,会在冷启动后让用户被重定向至授权页面。访问令牌有效期为一小时,刷新令牌为 60 天,且每次使用时都会发放新的刷新令牌,因此每 60 天内至少调用一次工具的应用会保持登录状态。请将客户端注册信息与令牌存放在一起,因为 provider 每次建立连接时都会同时读取两者。
评论和私信如何传到应用?
以经过签名的 POST 请求发送到 Webhook 端点,也就是您的路由处理程序。set_social_webhook_destination 会为账户注册该路由,之后它会接收 Instagram 和 Facebook 的评论、提及与私信,以及 TikTok 的评论。每个请求体包含 platform、account_id、external_id 和 entry,即平台原始发送的事件内容。请将请求体以文本形式读取,并使用账户的签名密钥核对 X-EC-Signature,同时尽快响应:easyCoexistence 只给路由 8 秒时间,每个事件只发送一次,不会重试。请将事件放入队列,由后台工作进程携带该事件调用 replyToEvent,这样模型的处理时间就不会计入这 8 秒。
每个网络允许模型做什么?
取决于账户的 API 允许范围,指令中应明确说明:
- Instagram:可发布帖子、Reels 与 Stories,图片需为 JPEG;私信回复仅限于 24 小时内有来信的用户,且最多 1,000 字节。
- Facebook:可在同一 24 小时窗口内发布 Page 帖子、回复评论,以及回复 Messenger 消息。
- TikTok:可发布视频与图文帖子;评论回复一律公开,并以视频 ID 作为
post_id,不支持私信。 - WhatsApp:客户最后一条消息后的 24 小时内使用
send_message,其他情况使用send_template。 - YouTube 与 LinkedIn:仅在用户要求时上传并发布内容,可回复评论并查看数据分析;两者均不转发事件,因此应用需定时读取新评论。
常见错误
- 让 stopWhen 保持默认值。generateText 在第一步后即停止,因此模型调用 reply_to_comment 后,无从得知回复是否已发出;请使用 isStepCount 允许多步执行。
- 将令牌保存在无服务器主机的模块级变量中。下一次冷启动时变量为空,用户会再次被重定向至授权页面;请将令牌保存在 tokens() 与 saveTokens() 可访问的数据库中。
- 注册的重定向 URL 与实际发送的不一致。easyCoexistence 会严格比对注册的 redirect_uri,末尾的斜杠或不同路径都会让登录以错误页面结束。
- 回复账户自身的活动。Instagram 会把账户发出的私信以 echo 形式返回,公开回复也会以评论形式回传;请在提示词到达模型之前将两者都过滤掉。
easyCoexistence 让您用 Vercel AI SDK 构建的 AI 代理,通过各平台官方 API 触达 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 等渠道的客户:OAuth 登录背后的 MCP 工具、评论与私信的签名事件,以及最长可提前 90 天定时发布的队列,每个连接全天候 24/7 监控。每个连接每月从 US$ 9 降至 US$ 0.75,连接越多单价越低,前 3 天免费试用。
常见问题
这需要 Next.js 或 Vercel 托管吗?
不需要。AI SDK 运行于 Node.js,因此任何能提供 HTTPS 路由的主机都可以使用,MCP 客户端只需对 easycoexistence.com 发起出站 HTTPS 请求即可。
聊天界面能否串流工具调用?
可以。将同一组工具传给 streamText,并在 onEnd 回调中关闭 MCP 客户端,这也是 AI SDK 在串流响应中的文档做法。
同一个应用能否回复 WhatsApp 消息?
可以。号码的工具通过同一客户端提供:先用 list_numbers 获取 connection_id,然后在客户最后一条消息后的 24 小时内使用 send_message。接收消息的方法请参阅 AI SDK 的 WhatsApp 指南。
easyCoexistence 对 AI SDK 应用的收费是多少?
每个连接每月从 US$ 9 降至 US$ 0.75,连接越多单价越低,各网络收费相同。MCP 服务器与 Partner API 均包含在内,前 3 天免费。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间