Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Gunakan alat media sosial dalam Vercel AI SDK: Instagram, TikTok dan lain-lain

Vercel AI SDK mendapat alat media sosial untuk Instagram, TikTok, Facebook, WhatsApp dan saluran lain daripada pelayan MCP easyCoexistence. createMCPClient, daripada pakej @ai-sdk/mcp, membuka sambungan HTTP ke https://easycoexistence.com/api/mcp, OAuthClientProvider yang anda tulis mengekalkan log masuk, dan tools() klien dimasukkan ke generateText atau streamText untuk menyiarkan, menjadualkan, membalas komen dan DM serta membaca statistik melalui API rasmi setiap rangkaian.

auth()

Fungsi pakej @ai-sdk/mcp yang melengkapkan panggilan balik OAuth daripada serverUrl dan authorizationCode, serta callbackState dan callbackIssuer apabila ada.

isStepCount(1)

stopWhen lalai bagi generateText, jadi model hanya membaca hasil alat apabila stopWhen membenarkan lebih banyak langkah.

HTTP

Pengangkutan MCP yang disyorkan AI SDK untuk produksi; pengangkutan stdio hanya untuk pelayan tempatan.

1 hour

Tempoh hayat token akses MCP easyCoexistence; token segar pula tahan 60 hari dan digantikan pada setiap penyegaran.

1,000 bytes

Jumlah teks paling banyak yang boleh dibawa oleh satu DM Instagram, diukur dalam UTF-8, jadi aksara beraksen dan emoji mengambil lebih ruang.

Bagaimana AI SDK log masuk ke easyCoexistence?

Melalui OAuthClientProvider yang anda laksanakan atas storan anda sendiri, dipacu oleh fungsi auth() AI SDK. Panggilan pertama mendaftarkan apl anda dengan easyCoexistence sebagai klien awam, menyimpan PKCE verifier dan menyerahkan URL persetujuan melalui redirectToAuthorization; ia mengembalikan REDIRECT, dan laluan anda menghantar pengguna ke sana. easyCoexistence kemudian mengubah hala ke panggil balik anda dengan kod, dan panggilan auth() kedua dengan authorizationCode menukarnya kepada token. Apabila token disimpan, auth() menggunakan token segar untuk mendapatkan pasangan baharu tanpa menghantar pengguna kembali. Pastikan redirectUrl dan redirect_uris yang didaftarkan sama persis, kerana easyCoexistence memadankannya tepat-tepat.

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

Bagaimana alat sampai ke generateText?

Daripada createMCPClient dengan pengangkutan HTTP, URL easyCoexistence dan penyedia. tools() mengembalikan alat pelayan sebagai alat AI SDK; simpan alat yang diperlukan mengikut nama dan hantarkannya ke generateText atau streamText. Tetapkan stopWhen dengan isStepCount, kerana secara lalai panggilan berhenti selepas satu langkah dan model tidak pernah membaca apa yang dikembalikan oleh reply_to_comment. Letakkan peraturan rangkaian dalam instructions, parameter yang dirujuk dalam dokumentasi semasa untuk kelakuan model. Tutup klien dalam blok finally, atau dalam panggil balik onEnd streamText, supaya tiada sambungan terbiar.

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

Di mana token perlu disimpan pada hos tanpa pelayan?

Di mana-mana yang hidup melebihi satu panggilan: baris pangkalan data, Redis atau storan nilai-kunci, dikunci mengikut pengguna apl anda yang memiliki token itu. Fungsi di Vercel atau platform tanpa pelayan lain bermula tanpa apa-apa dalam memori, jadi penyedia yang menyimpan token dalam pembolehubah akan menghantar pengguna kembali ke skrin persetujuan selepas cold start. Token akses tahan satu jam dan token segar 60 hari, dengan token segar baharu setiap kali digunakan, jadi apl yang memanggil alat sekurang-kurangnya sekali dalam 60 hari kekal log masuk. Simpan pendaftaran klien di sebelah token, kerana penyedia membaca kedua-duanya pada setiap sambungan.

Bagaimana komen dan DM sampai ke apl?

Sebagai POST yang ditandatangani ke pengendali laluan, yang didaftarkan oleh set_social_webhook_destination untuk akaun, dan yang kemudian menerima komen, sebutan dan DM Instagram serta Facebook, dan komen TikTok. Setiap badan mengandungi platform, account_id, external_id dan entry, acara rangkaian seperti yang dihantar. Baca badan sebagai teks, semak X-EC-Signature dengannya menggunakan rahsia tandatangan akaun, dan balas dengan pantas: easyCoexistence memberi laluan itu 8 saat dan menghantar setiap acara sekali sahaja, tanpa cuba semula. Letakkan acara dalam giliran dan biarkan pekerja memanggil replyToEvent dengannya, supaya masa model tidak pernah dikira dalam 8 saat itu.

Apa yang dibenarkan setiap rangkaian kepada model?

Setakat yang dibenarkan API akaun, yang arahan perlu nyatakan dengan jelas:

  • Instagram: siaran, Reels dan Stories dengan imej JPEG; balasan DM hanya kepada orang yang menulis dalam 24 jam terakhir, dalam paling banyak 1,000 bait.
  • Facebook: siaran Halaman, balasan komen dan balasan Messenger dalam tempoh 24 jam yang sama.
  • TikTok: video dan siaran foto; balasan komen sentiasa awam, dengan ID video sebagai post_id, dan tiada DM.
  • WhatsApp: send_message dalam 24 jam selepas mesej terakhir pelanggan, send_template untuk sesiapa lain.
  • YouTube dan LinkedIn: muat naik dan siaran apabila pengguna meminta, balasan komen dan analitik; kedua-duanya tidak menghantar acara, jadi apl membaca komen baharu mengikut jadual.

Kesilapan biasa

  • Membiarkan stopWhen pada lalai. generateText berhenti selepas langkah pertama, jadi model memanggil reply_to_comment dan tidak tahu sama ada balasan telah dihantar; benarkan beberapa langkah dengan isStepCount.
  • Menyimpan token dalam pembolehubah peringkat modul pada hos tanpa pelayan. Permulaan sejuk seterusnya tidak mempunyai apa-apa, dan pengguna kembali ke skrin persetujuan; simpan di tempat tokens() dan saveTokens() boleh sampai ke pangkalan data.
  • Mendaftarkan satu URL ubah hala tetapi menghantar yang lain. easyCoexistence menyemak redirect_uri tepat-tepat dengan pendaftaran, jadi garis miring di hujung atau laluan berbeza menamatkan log masuk pada halaman ralat.
  • Membalas aktiviti akaun sendiri. Instagram menghantar semula DM akaun sebagai gema dan balasan awamnya kembali sebagai komen, jadi langkau kedua-duanya sebelum gesaan sampai ke model.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberikan ejen yang anda bina dengan Vercel AI SDK capaian kepada pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan saluran lain, setiap satu melalui API rasmi: alat MCP di sebalik log masuk OAuth, acara bertanda tangan untuk komen dan DM, dan giliran siaran sehingga 90 hari ke hadapan, dengan setiap sambungan dipantau 24/7. Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah ini memerlukan Next.js atau hos Vercel?

Tidak. AI SDK berjalan dalam Node.js, jadi mana-mana hos yang menyediakan laluan HTTPS berfungsi, dan klien MCP hanya memerlukan HTTPS keluar ke easycoexistence.com.

Bolehkah antara muka sembang menstrim panggilan alat?

Boleh. Hantar alat yang sama ke streamText dan tutup klien MCP dalam panggil balik onEnd, seperti yang didokumentasikan AI SDK untuk respons yang distrim.

Bolehkah apl yang sama membalas mesej WhatsApp?

Boleh. Alat nombor datang melalui klien yang sama: list_numbers untuk connection_id, kemudian send_message dalam 24 jam selepas mesej terakhir pelanggan. Panduan AI SDK untuk WhatsApp merangkumi cara menerimanya.

Berapa kos easyCoexistence untuk apl AI SDK?

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, sama pada setiap rangkaian. Pelayan MCP dan Partner API termasuk, dan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada