Gunakan alat media sosial di Vercel AI SDK: Instagram, TikTok, dan lainnya
Vercel AI SDK mendapatkan alat media sosial untuk Instagram, TikTok, Facebook, WhatsApp, dan saluran lainnya dari server MCP easyCoexistence. createMCPClient, dari paket @ai-sdk/mcp, membuka koneksi HTTP ke https://easycoexistence.com/api/mcp. OAuthClientProvider yang Anda tulis menjaga proses masuk, dan tools() dari klien dimasukkan ke generateText atau streamText untuk memublikasikan, menjadwalkan, membalas komentar dan DM, serta membaca insight melalui API resmi masing-masing jaringan.
Fungsi dari paket @ai-sdk/mcp yang menyelesaikan callback OAuth dari serverUrl dan authorizationCode, plus callbackState dan callbackIssuer bila ada.
stopWhen default generateText, sehingga model hanya membaca hasil alat jika stopWhen mengizinkan langkah tambahan.
Transport MCP yang direkomendasikan AI SDK untuk produksi; transport stdio-nya hanya untuk server lokal.
Masa berlaku token akses MCP easyCoexistence; refresh token-nya berlaku 60 hari dan diganti pada setiap penyegaran.
Teks terpanjang yang dapat dibawa satu DM Instagram, diukur dalam UTF-8, sehingga aksen dan emoji memakan lebih banyak ruang.
Bagaimana AI SDK masuk ke easyCoexistence?
Melalui OAuthClientProvider yang Anda implementasikan di atas penyimpanan Anda sendiri, yang dijalankan oleh fungsi auth() dari AI SDK. Panggilan pertama mendaftarkan aplikasi Anda ke easyCoexistence sebagai klien publik, menyimpan verifier PKCE, dan memberikan URL persetujuan melalui redirectToAuthorization; fungsi ini mengembalikan REDIRECT, dan rute Anda mengirim pengguna ke sana. easyCoexistence kemudian mengarahkan kembali ke callback Anda dengan code, dan panggilan auth() kedua dengan authorizationCode menukarnya menjadi token. Setelah token tersimpan, auth() menggunakan refresh token untuk pasangan baru tanpa mengirim pengguna kembali. Pastikan redirectUrl dan redirect_uris yang terdaftar sama persis, karena easyCoexistence mencocokkannya secara tepat.
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");
}Bagaimana alat sampai ke generateText?
Dari createMCPClient dengan transport HTTP, URL easyCoexistence, dan provider. tools() mengembalikan alat server sebagai alat AI SDK; simpan yang dibutuhkan pekerjaan berdasarkan nama, lalu berikan ke generateText atau streamText. Atur stopWhen dengan isStepCount, karena secara default panggilan berhenti setelah satu langkah dan model tidak pernah membaca apa yang dikembalikan reply_to_comment. Letakkan aturan jaringan di instructions, parameter yang dipakai referensi terkini untuk perilaku model. Tutup klien dalam blok finally, atau di callback onEnd dari streamText, agar tidak ada koneksi yang terbuka.
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();
}
}Di mana token harus disimpan pada host serverless?
Di tempat yang bertahan lebih lama dari satu pemanggilan: baris database, Redis, atau penyimpanan key-value, dengan kunci berupa pengguna aplikasi Anda yang memiliki token tersebut. Fungsi di Vercel atau platform serverless lain dimulai tanpa apa pun di memori, sehingga penyedia yang menyimpan token dalam variabel akan mengirim pengguna kembali ke layar persetujuan setelah cold start. Token akses berlaku satu jam dan refresh token 60 hari, dengan refresh token baru setiap kali digunakan, sehingga aplikasi yang memanggil alat setidaknya sekali dalam 60 hari tetap masuk. Simpan pendaftaran klien di samping token, karena penyedia membaca keduanya pada setiap koneksi.
Bagaimana komentar dan DM sampai ke aplikasi?
Sebagai POST bertanda tangan ke route handler, yang didaftarkan set_social_webhook_destination untuk sebuah akun dan yang kemudian menerima komentar, mention, dan DM Instagram serta Facebook, serta komentar TikTok. Setiap body memuat platform, account_id, external_id, dan entry, yaitu event jaringan sebagaimana dikirim. Baca body sebagai teks, periksa X-EC-Signature terhadapnya dengan rahasia penandatanganan akun, dan balas dengan cepat: easyCoexistence memberi route 8 detik dan mengirim setiap event sekali saja, tanpa mencoba kembali. Masukkan event ke antrean dan biarkan worker memanggil replyToEvent dengan event tersebut, sehingga waktu model tidak pernah dihitung terhadap 8 detik.
Apa yang bisa dilakukan model di tiap jaringan?
Sebanyak yang diizinkan API akun, yang sebaiknya dijelaskan dalam instructions:
- Instagram: posting, Reels, dan Stories dengan gambar JPEG; balasan DM hanya untuk orang yang menulis dalam 24 jam terakhir, maksimal 1,000 byte.
- Facebook: posting Halaman, balasan komentar, dan balasan Messenger dalam 24 jam yang sama.
- TikTok: video dan posting foto; balasan komentar selalu publik, dengan ID video sebagai
post_id, dan tanpa DM. - WhatsApp:
send_messagedalam 24 jam sejak pesan terakhir pelanggan,send_templateuntuk pihak lain. - YouTube dan LinkedIn: unggahan dan posting saat pengguna memintanya, balasan komentar, dan analitik; keduanya tidak meneruskan event, sehingga aplikasi membaca komentar baru sesuai jadwal.
Kesalahan umum
- Membiarkan stopWhen pada default. generateText berhenti setelah langkah pertama, sehingga model memanggil reply_to_comment dan tidak pernah tahu apakah balasan terkirim; izinkan beberapa langkah dengan isStepCount.
- Menyimpan token dalam variabel tingkat modul di host serverless. Cold start berikutnya tidak memilikinya, dan pengguna kembali ke layar persetujuan; simpan di tempat tokens() dan saveTokens() dapat menjangkau database.
- Mendaftarkan satu URL redirect lalu mengirim URL lain. easyCoexistence memeriksa redirect_uri secara tepat terhadap pendaftaran, sehingga garis miring di akhir atau path yang berbeda mengakhiri proses masuk di halaman galat.
- Membalas aktivitas akun sendiri. Instagram mengirim DM akun kembali sebagai echo dan balasan publiknya kembali sebagai komentar, jadi lewati keduanya sebelum prompt sampai ke model.
easyCoexistence memberi agen yang Anda bangun dengan Vercel AI SDK jangkauan ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn, dan saluran lainnya, masing-masing melalui API resminya: alat MCP di balik proses masuk OAuth, event bertanda tangan untuk komentar dan DM, serta antrean posting hingga 90 hari ke depan, dengan setiap koneksi dipantau 24/7. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah ini memerlukan hosting Next.js atau Vercel?
Tidak. AI SDK berjalan di Node.js, sehingga host apa pun yang melayani route HTTPS dapat digunakan, dan klien MCP hanya membutuhkan HTTPS keluar ke easycoexistence.com.
Apakah antarmuka chat bisa men-stream pemanggilan alat?
Bisa. Berikan alat yang sama ke streamText dan tutup klien MCP di callback onEnd-nya, seperti yang didokumentasikan AI SDK untuk respons yang di-stream.
Bisakah aplikasi yang sama membalas pesan WhatsApp?
Bisa. Alat nomor datang melalui klien yang sama: list_numbers untuk connection_id, lalu send_message dalam 24 jam sejak pesan terakhir pelanggan. Panduan AI SDK untuk WhatsApp membahas cara menerimanya.
Berapa biaya easyCoexistence untuk aplikasi AI SDK?
US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring bertambahnya koneksi, sama di setiap jaringan. Server MCP dan Partner API termasuk di dalamnya, dan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada