登录开始免费试用
easyCoexistence 官方 API

在 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 发布、定时发布、回复评论与私信,并读取洞察数据。

auth()

@ai-sdk/mcp 中的函数,依据 serverUrl 与 authorizationCode 完成 OAuth 回调;存在时还需提供 callbackState 与 callbackIssuer。

isStepCount(1)

generateText 的默认 stopWhen 设置,只有在 stopWhen 允许更多步骤时,模型才会读取工具的结果。

HTTP

AI SDK 为生产环境推荐的 MCP 传输方式;其 stdio 传输仅适用于本地服务器。

1 hour

easyCoexistence MCP 访问令牌的有效期;其刷新令牌有效期为 60 天,并会在每次刷新时被替换。

1,000 bytes

单条 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 会严格比对。

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");
}

工具如何传入 generateText?

通过 createMCPClient 加上 HTTP 传输、easyCoexistence 的 URL 与 provider 即可。tools() 会将服务器的工具以 AI SDK 工具的形式返回;请按名称保留任务所需的工具,并将其传给 generateText 或 streamText。请使用 isStepCount 设置 stopWhen,因为默认情况下调用会在一步后停止,模型将无法读取 reply_to_comment 的返回结果。网络规则请写入 instructions,这是当前参考文档中用于控制模型行为的参数。请在 finally 代码块中关闭客户端,或在 streamText 的 onEnd 回调中关闭,以免留下未关闭的连接。

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();
  }
}

在无服务器主机上,令牌应存放在哪里?

应存放在能够跨越单次调用而持续存在的地方,例如数据库记录、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 完成这些操作

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 监控

验证时间