在 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 提供同意網址;此時回傳 REDIRECT,您的路由會把用戶導向該處。easyCoexistence 隨後會攜帶 code 回調至您的 callback,第二次以 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?
透過 HTTP 傳輸的 createMCPClient,搭配 easyCoexistence 網址與該提供者。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 或其他無伺服器平台上的函數每次啟動時記憶體都是空的,因此把權杖放在變數中的提供者,會在冷啟動後把用戶送回同意畫面。存取權杖有效一小時,刷新權杖有效 60 天,且每次使用都會更換為新的刷新權杖,所以應用程式只要在 60 天內至少調用一次工具,便會保持登入狀態。請把客戶端註冊資料與權杖存放在一起,因為提供者每次連接時都會同時讀取兩者。
留言與私訊如何送達應用程式?
以已簽署的 POST 送至路由處理器。該處理器由 set_social_webhook_destination 為帳戶註冊,之後會接收 Instagram 與 Facebook 的留言、提及及私訊,以及 TikTok 留言。每個請求主體包含 platform、account_id、external_id 與 entry,即各網絡發送的原始事件。請以文字方式讀取請求主體,並用帳戶的簽署密鑰核對 X-EC-Signature,同時盡快回應:easyCoexistence 只給路由 8 秒,且每個事件只發送一次,不會重試。請把事件放入佇列,由工作程式以它調用 replyToEvent,如此模型的處理時間便不會計入那 8 秒。
各網絡容許模型做什麼?
以帳戶 API 所容許的為限,指示內容應詳列如下:
- Instagram:以 JPEG 圖片發布貼文、Reels 與 Stories;私訊回覆僅限於過去 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() 可讀寫的資料庫。
- 註冊一個回調網址卻發送另一個。easyCoexistence 會嚴格比對 redirect_uri 與註冊內容,尾隨斜線或不同路徑都會令登入以錯誤頁面結束。
- 回應帳戶自身的活動。Instagram 會把帳戶發出的私訊以 echo 形式送回,其公開回覆亦會以留言形式返回;應在提示送達模型前將兩者略過。
easyCoexistence 讓您以 Vercel AI SDK 建構的代理,透過各渠道的官方 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 監察
驗證日期