ログイン無料トライアルを開始
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 を通じて投稿、予約、コメントや DM への返信、インサイトの取得を行います。

auth()

serverUrl と authorizationCode から OAuth コールバックを完了させる @ai-sdk/mcp の関数。callbackState と callbackIssuer は、ある場合に併せて渡します。

isStepCount(1)

generateText の既定の stopWhen では、モデルは stopWhen が追加のステップを許可した場合にのみツールの結果を読みます。

HTTP

AI SDK が本番環境向けに推奨する MCP トランスポート。stdio トランスポートはローカルサーバー専用です。

1 hour

easyCoexistence の MCP アクセストークンの有効期間。リフレッシュトークンは 60 日間有効で、更新のたびに入れ替わります。

1,000 bytes

Instagram の DM 1 件に入る最大テキスト量。UTF-8 基準で計測するため、アクセント記号や絵文字はより多くの容量を占めます。

AI SDK は easyCoexistence にどのようにサインインしますか?

自分で実装する OAuthClientProvider を通じて行います。この OAuthClientProvider は自分のストレージを使い、AI SDK の auth() 関数が操作します。最初の呼び出しでは、アプリを easyCoexistence にパブリッククライアントとして登録し、PKCE verifier を保存して、redirectToAuthorization で同意 URL を渡します。このとき REDIRECT を返すので、ルートがユーザーをその URL へ送ります。その後 easyCoexistence は code を付けて callback へリダイレクトし、authorizationCode を付けた 2 回目の auth() 呼び出しがそれをトークンに交換します。トークンが保存されると、auth() はユーザーを戻さず、リフレッシュトークンで新しいトークンを取得します。easyCoexistence は redirectUrl と登録済みの redirect_uris を厳密に照合するため、両者を完全に一致させてください。

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 にどう渡されますか?

HTTP トランスポート、easyCoexistence の URL、プロバイダーを指定した createMCPClient からツールを取得します。tools() はサーバーのツールを AI SDK のツールとして返すので、処理に必要なものを名前で絞り込み、generateText または streamText に渡します。既定では 1 ステップで呼び出しが終わり、モデルは reply_to_comment の戻り値を読めないため、isStepCount を使って stopWhen を設定します。ネットワークごとのルールは 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();
  }
}

サーバーレスのホストでトークンはどこに置くべきですか?

1 回の呼び出しを超えて存続する場所に置いてください。たとえばデータベースの行、Redis、キーバリューストアなどで、トークンの持ち主であるアプリのユーザーをキーにします。Vercel などのサーバーレス基盤の関数は、メモリが空の状態で起動します。そのため、トークンを変数に保持するプロバイダーでは、コールドスタートのたびにユーザーが同意画面へ戻されてしまいます。アクセストークンは 1 時間、リフレッシュトークンは 60 日間有効です。リフレッシュトークンは使用されるたびに新しいものに替わるので、60 日以内に 1 回でもツールを呼び出すアプリはサインインを維持できます。クライアント登録もトークンと並べて保存してください。プロバイダーは接続のたびに両方を読み込みます。

コメントや DM はどのようにアプリに届きますか?

set_social_webhook_destination でアカウントに登録したルートハンドラーへの署名付き POST として届きます。Instagram と Facebook のコメント、メンション、DM、TikTok のコメントが届きます。各ボディには platform、account_id、external_id、そしてネットワークから届いたままのイベントである entry が含まれます。ボディはテキストとして読み込み、アカウントの署名シークレットで X-EC-Signature を照合し、すぐに応答してください。easyCoexistence はルートに 8 秒の猶予を与え、各イベントを 1 回だけ送信します。再送はありません。イベントはキューに入れ、ワーカーが replyToEvent を呼び出すようにしてください。そうすればモデルの処理時間が 8 秒の枠に含まれません。

各ネットワークでモデルにできることは?

アカウントの API が許す範囲で、指示文に明記すべき内容は次のとおりです。

  • Instagram:JPEG 画像付きの投稿、リール、ストーリーズ。DM への返信は過去 24 時間以内にメッセージを送ってきた相手にのみ、1,000 バイト以内で可能です。
  • Facebook:Page の投稿、コメントへの返信、Messenger への返信を、同じ 24 時間以内に行えます。
  • TikTok:動画と写真投稿。コメントへの返信は常に公開となり、post_id には動画の ID を指定します。DM はできません。
  • WhatsApp:お客様の最後のメッセージから 24 時間以内は send_message、それ以外の相手には send_template を使います。
  • YouTube と LinkedIn:ユーザーの依頼があった場合の動画や投稿のアップロード、コメントへの返信、アナリティクス。どちらもイベントを転送しないため、アプリはスケジュールに従って新しいコメントを読み取ります。

よくある間違い

  • stopWhen を既定値のままにしないでください。generateText は最初のステップで停止するため、モデルは reply_to_comment を呼び出しても返信が送信されたかどうかを知ることができません。isStepCount で数ステップを許可してください。
  • サーバーレスのホストでトークンをモジュールレベルの変数に保存しないでください。次のコールドスタートではトークンが残っておらず、ユーザーは再び同意画面に戻されます。tokens() と saveTokens() がデータベースに届く場所に保存してください。
  • 登録したリダイレクト URL と異なる URL を送らないでください。easyCoexistence は redirect_uri を登録内容と厳密に照合するため、末尾のスラッシュや異なるパスがあるとサインインはエラーページで終わります。
  • アカウント自身の活動に返信しないでください。Instagram はアカウントの DM をエコーとして送り返し、公開の返信はコメントとして戻ってきます。プロンプトがモデルに届く前に、その両方を除外してください。
EasyCoexistence で実現する

easyCoexistence は、Vercel AI SDK で構築するエージェントに、WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのお客様とのやり取りを届けます。各チャネルは各ネットワークの公式 API を通じて動作します。OAuth サインインの背後にある MCP ツール、コメントや DM の署名付きイベント、最大 90 日先まで予約できる投稿キューを提供し、すべての接続は 24 時間体制で監視されます。接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。最初の 3 日間は無料です。

よくある質問

Next.js や Vercel のホスティングは必要ですか?

いいえ。AI SDK は Node.js で動作するため、HTTPS のルートを提供するどのホストでも使えます。MCP クライアントに必要なのは easycoexistence.com への外向き HTTPS 通信だけです。

チャット画面でツール呼び出しをストリーミングできますか?

はい。同じツールを streamText に渡し、AI SDK がストリーミング応答について文書化しているとおり、onEnd コールバックで MCP クライアントを閉じてください。

同じアプリで WhatsApp のメッセージに返信できますか?

はい。番号のツールも同じクライアントから取得できます。connection_id は list_numbers で取得し、お客様の最後のメッセージから 24 時間以内に send_message を使います。受信方法は、WhatsApp 向けの AI SDK ガイドで説明しています。

AI SDK のアプリで easyCoexistence を使うと、料金はいくらですか?

接続 1 件あたり月額 US$ 9 から US$ 0.75 まで、接続を増やすほど下がります。どのネットワークでも同じです。MCP サーバーと Partner API も含まれ、最初の 3 日間は無料です。

続きを読む

最初のチャンネルを 2 分で接続しましょう。

プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。

  • 3 日間無料
  • いつでも解約可能
  • 公式 API のみ使用
  • 24/7 監視

確認日