ログイン無料トライアルを開始
easyCoexistence 公式 API

1 つの API で Node.js から Instagram、TikTok、Facebook へ投稿

easyCoexistence を使うと、Node.js や TypeScript のバックエンドから、Instagram、Facebook、TikTok、YouTube、LinkedIn へ、各ネットワークの公式 API を通じて投稿できます。アカウントは一度、ホストされたリンクからサインインするだけで接続でき、ジョブごとに 1 回の fetch で、TikTok、YouTube、LinkedIn の新しいトークンを取得できます。署名付きのイベントで、コメントや DM をルートに届けます。TypeScript の MCP SDK で構築したエージェントは、同じアカウントをツールとして利用できます。

15 a day

TikTok の投稿エンドポイントがアカウントごとに受け付ける動画投稿は、1 分あたり 6 件までです。

10 min to 30 days

published を false にし scheduled_publish_time を指定したとき、Facebook のページ投稿を予約できる期間。

x-restli-id

新しい LinkedIn 投稿の URN を運ぶレスポンスヘッダーで、ステータスは 201 で返されます。

5 minutes

コメントの作成、削除、公開範囲の変更から、TikTok が comment.update イベントを発火するまでの時間。

1 hour

Partner API の接続リンクが、セッションの期限切れまで開いたままでいられる時間。

Node.js のバックエンドはどのようにアカウントを接続し、トークンを取得しますか?

バックエンドから接続セッションを開き、アカウントの所有者がブラウザーで手続きを完了します。/connect-sessions に対して、ベアラートークンとして ec_live_ キーを付けて POST します。リクエストには tiktok や linkedin などのチャンネル、redirect_url、顧客用の external_ref を含めます。すると easycoexistence.com 上の url が返されます。所有者はネットワーク自身の同意画面でサインインし、status=connected と channel_id を付けて redirect_url に戻ります。キャンセルした場合は、作成から 1 時間で期限切れになるまで同じリンクから再試行できます。

각ジョブは GET /channels/{id}?credentials=1 から始まります。レスポンスには、現在有効なトークン(Instagram と Facebook を除く。これらのトークンは決して渡されません)と、各ネットワークが必要とするフィールドが含まれます。Instagram と Facebook では graph_api_base と account_id_on_meta、TikTok では api_base と business_id、YouTube では channel_id、LinkedIn では author_urn と required_headers です。ダッシュボードで設定したイベント URL には、署名付きの channel.connected、channel.disconnected、channel.removed、channel.suspended が送られ、アカウントの変化をアプリに伝えます。

A connect link and per-job credentials with fetch
const EC = "https://easycoexistence.com/api/v1";
const KEY = { Authorization: `Bearer ${process.env.EC_API_KEY}` }; // ec_live_...

type Network = "instagram" | "facebook" | "tiktok" | "youtube" | "linkedin";

// A hosted sign-in link for one of your customers on one network
export async function connectLink(customerId: string, channel: Network): Promise<string> {
  const r = await fetch(`${EC}/connect-sessions`, {
    method: "POST",
    headers: { ...KEY, "Content-Type": "application/json" },
    body: JSON.stringify({
      channel,
      redirect_url: "https://app.example.com/connected",
      external_ref: customerId,
    }),
  });
  const session = (await r.json()) as { url: string; error?: { message: string } };
  if (!r.ok) throw new Error(session.error?.message);
  return session.url; // they come back with ?session=...&status=connected&channel_id=...
}

// At the start of every job: the API base and a token that is valid now
export async function credentials(channelId: string) {
  const r = await fetch(`${EC}/channels/${channelId}?credentials=1`, { headers: KEY });
  const body: any = await r.json(); // the credential fields differ by network
  if (!r.ok) throw new Error(body.error.message);
  if (!body.credentials.access_token) throw new Error(body.credentials.note);
  return body.credentials;
}

Node.js から Instagram と Facebook に投稿するにはどうしますか?

Instagram はコンテナを経由して投稿します。リール(Reel)の場合は、media_type に REELS、video_url、キャプションを指定してコンテナを作成し、status_code が FINISHED になるまでポーリングします。そのあと creation_id にコンテナ ID を渡して media_publish を呼び出します。Meta は約 1 分間隔のポーリングを推奨し、5 分で諦めるよう案内しています。ERROR や EXPIRED の場合、そのコンテナは公開されません。未公開のまま 24 時間たったコンテナは自動的に期限切れになります。

Facebook のページは、/{page-id}/photos に画像の url とキャプションを 1 回のリクエストで渡して写真を投稿します。テキストやリンクは /{page-id}/feed に送ります。どちらも published を false にして scheduled_publish_time を指定すると予約投稿になり、時刻が来ると Meta 自身が投稿します。予約できるのは 10 分後から 30 日後までです。トークンはベアラーヘッダーで送り、Graph API のバージョンは graph_api_base にすでに含まれています。メディアは Meta がダウンロードできる公開 URL に置く必要があります。

Publish a Reel and schedule a Page photo
type Meta = { graph_api_base: string; access_token: string };

async function graph(c: Meta, path: string, body?: object) {
  const r = await fetch(`${c.graph_api_base}/${path}`, {
    method: body ? "POST" : "GET",
    headers: { Authorization: `Bearer ${c.access_token}`, "Content-Type": "application/json" },
    body: body && JSON.stringify(body),
  });
  const data: any = await r.json();
  if (!r.ok) throw new Error(data.error?.message ?? `Graph API ${r.status}`);
  return data;
}

export async function postReel(channelId: string, videoUrl: string, caption: string) {
  const c = await credentials(channelId);
  const ig = c.account_id_on_meta;
  const { id } = await graph(c, `${ig}/media`, { media_type: "REELS", video_url: videoUrl, caption });
  for (let check = 0; check < 5; check++) {
    await new Promise((wake) => setTimeout(wake, 60_000)); // about once a minute, as Meta advises
    const { status_code } = await graph(c, `${id}?fields=status_code`);
    if (status_code === "FINISHED") return graph(c, `${ig}/media_publish`, { creation_id: id });
    if (status_code === "ERROR" || status_code === "EXPIRED") throw new Error(`Reel container ${status_code}`);
  }
  throw new Error("The Reel is still processing after five minutes");
}

export async function schedulePagePhoto(channelId: string, url: string, caption: string, at: Date) {
  const c = await credentials(channelId);
  return graph(c, `${c.account_id_on_meta}/photos`, {
    url,
    caption,
    published: false,
    scheduled_publish_time: Math.floor(at.getTime() / 1000), // 10 minutes to 30 days ahead
  });
}

Node.js から LinkedIn に投稿し、YouTube にアップロードするにはどうしますか?

LinkedIn では、すべてのリクエストでベアラートークンに加えて 2 つのヘッダーが必要です。LinkedIn-Version には、easyCoexistence が required_headers で返す YYYYMM 形式の値を設定します。X-Restli-Protocol-Version には 2.0.0 を設定します。投稿は、著者の URN、commentary としての本文、公開範囲 PUBLIC、配信先のメインフィード distribution、lifecycleState の PUBLISHED を指定して /rest/posts に POST します。LinkedIn は 201 を返し、新しい投稿の URN を x-restli-id ヘッダーに入れます。URL のパスに URN を入れる場合は URL エンコードが必要です。

YouTube へのアップロードには 2 回のリクエストが必要です。uploadType=resumable と part=snippet,status を付けてアップロード用エンドポイントに POST すると、メタデータが送られ、セッションのアドレスが Location ヘッダーで返されます。そのアドレスにファイルのバイト列を PUT すると、ID を含む動画リソースが返ります。非公開で publishAt の日時を指定してアップロードすると、公開は YouTube 自身のスケジューラーに任されるため、その時刻にご自身のプログラムを動かしておく必要はありません。

Publish on LinkedIn and schedule a YouTube upload
import { readFile } from "node:fs/promises";

export async function postOnLinkedIn(channelId: string, text: string) {
  const c = await credentials(channelId);
  const r = await fetch(`${c.api_base}/posts`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${c.access_token}`,
      "LinkedIn-Version": c.required_headers["LinkedIn-Version"],
      "X-Restli-Protocol-Version": "2.0.0",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      author: c.author_urn, // urn:li:organization:... or urn:li:person:...
      commentary: text,
      visibility: "PUBLIC",
      distribution: { feedDistribution: "MAIN_FEED", targetEntities: [], thirdPartyDistributionChannels: [] },
      lifecycleState: "PUBLISHED",
      isReshareDisabledByAuthor: false,
    }),
  });
  if (r.status !== 201) throw new Error(`LinkedIn ${r.status}: ${await r.text()}`);
  return r.headers.get("x-restli-id"); // the new post's URN
}

export async function scheduleOnYouTube(channelId: string, file: string, title: string, publishAt: string) {
  const c = await credentials(channelId);
  const auth = { Authorization: `Bearer ${c.access_token}` };
  const start = await fetch(
    "https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status",
    {
      method: "POST",
      headers: { ...auth, "Content-Type": "application/json; charset=UTF-8", "X-Upload-Content-Type": "video/mp4" },
      body: JSON.stringify({
        snippet: { title },
        status: { privacyStatus: "private", publishAt, selfDeclaredMadeForKids: false },
      }),
    },
  );
  const session = start.headers.get("location");
  if (!start.ok || !session) throw new Error(`YouTube ${start.status}: ${await start.text()}`);
  const done = await fetch(session, {
    method: "PUT",
    headers: { ...auth, "Content-Type": "video/mp4" },
    body: await readFile(file),
  });
  const video = (await done.json()) as { id: string };
  return video.id;
}

Node.js のルートでコメントや DM を受け取るにはどうしますか?

各チャンネルは、PUT /channels/{id}/webhook で指定した URL に転送します。この呼び出しは、チャンネルの signing_secret を 1 回だけ返します。すべての配信は POST で、platform、account_id、external_id、entry を含みます。X-EC-Signature ヘッダーは t=<unix>,v1=<hex> の形式で、v1 は t、ドット、生のボディを連結した文字列の HMAC-SHA256 です。パースする前にボディをテキストとして受け取り、5 分より古い t は拒否し、timingSafeEqual で比較してください。

Instagram と Facebook では、entry は Meta が送ったままの webhook entry です。コメントとメンションは changes に、DM は messaging に入ります。TikTok では entry に comment.update イベントが入ります。TikTok はコメントから 5 分以内にこのイベントを発火します。comment_id と video_id は文字列で届くため、JavaScript で 64 ビットの数値が丸められることはありません。配信は 1 イベントにつき 1 回だけ試行され、コピーも保存されないため、すぐに 204 を返し、処理はキューから行ってください。

Turn on forwarding and verify X-EC-Signature in a route handler
import { createHmac, timingSafeEqual } from "node:crypto";

const secrets = new Map<string, string>(); // channel id -> signing_secret, kept in your database

export async function forwardEvents(channelId: string, url: string) {
  const r = await fetch(`${EC}/channels/${channelId}/webhook`, {
    method: "PUT",
    headers: { ...KEY, "Content-Type": "application/json" },
    body: JSON.stringify({ url }),
  });
  const body = (await r.json()) as { signing_secret: string; error?: { message: string } };
  if (!r.ok) throw new Error(body.error?.message);
  secrets.set(channelId, body.signing_secret); // returned only this once
}

function verify(raw: string, header: string | null, secret: string): boolean {
  const parts = Object.fromEntries((header ?? "").split(",").map((kv) => kv.split("=", 2)));
  const t: string = parts.t ?? "";
  const v1: string = parts.v1 ?? "";
  if (!/^[0-9]+$/.test(t) || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const mac = createHmac("sha256", secret).update(`${t}.${raw}`).digest("hex");
  return mac.length === v1.length && timingSafeEqual(Buffer.from(mac), Buffer.from(v1));
}

// POST /hooks/social as a web-standard handler (Next.js, Hono, Bun and others)
export async function POST(req: Request) {
  const raw = await req.text(); // the signature covers these exact bytes
  const event = JSON.parse(raw); // { platform, account_id, external_id, entry }
  const secret = secrets.get(event.account_id);
  if (!secret || !verify(raw, req.headers.get("x-ec-signature"), secret)) {
    return new Response("invalid signature", { status: 401 });
  }
  await enqueue(event); // one attempt per event and no retries: acknowledge first
  return new Response(null, { status: 204 });
}

Node.js からコメントや DM に返信するにはどうしますか?

新しいクレデンシャルの呼び出しを行い、イベントに含まれる ID を使います。Instagram と Facebook では、DM への返信を /{account-id}/messages に送ります。account_id_on_meta を使い、recipient には送信者の ID を指定します。返信できるのは、相手の最後のメッセージから 24 時間以内に限られます。Page の場合は messaging_type に RESPONSE を加え、Instagram のテキストは最大 1,000 バイトまでです。コメントには公開の返信を付けられます。Instagram は /{comment-id}/replies、Facebook は /{comment-id}/comments です。または、7 日以内に非公開の返信を 1 件だけ送れます。

TikTok には DM がないため、会話は公開のままです。business/comment/reply/create/ に Access-Token ヘッダー、business_id、video_id、comment_id を付けて送ると、最大 1,200 文字の返信を投稿できます。成功かどうかは HTTP ステータスではなく、レスポンスの code フィールドで判断してください。0 が成功です。自分の返信もイベントとして届くため、comment_action が insert かつ comment_type が comment のイベントだけに反応してください。

Reply to a TikTok comment and a Messenger DM
export async function reply(event: any, text: string) {
  const c = await credentials(event.account_id);
  if (event.platform === "tiktok") {
    const e = event.entry.content; // the comment.update event, ids as strings
    if (e.comment_action !== "insert" || e.comment_type !== "comment") return; // your replies arrive as "reply"
    const r = await fetch(`${c.api_base}/business/comment/reply/create/`, {
      method: "POST",
      headers: { "Access-Token": c.access_token, "Content-Type": "application/json" },
      body: JSON.stringify({ business_id: c.business_id, video_id: e.video_id, comment_id: e.comment_id, text }),
    });
    const out = (await r.json()) as { code: number; message: string };
    if (out.code !== 0) throw new Error(out.message); // 0 is success, whatever the HTTP status
  } else if (event.platform === "facebook") {
    for (const m of event.entry.messaging ?? []) {
      if (!m.message || m.message.is_echo) continue; // only what people sent the Page
      await graph(c, `${c.account_id_on_meta}/messages`, {
        recipient: { id: m.sender.id },
        messaging_type: "RESPONSE", // within 24 hours of their last message
        message: { text },
      });
    }
  }
}

TikTok に投稿し、TypeScript のエージェントにこれらのツールを渡すにはどうしますか?

どちらも easyCoexistence の MCP サーバー https://easycoexistence.com/api/mcp を経由します。このサーバーは OAuth 2.1 のみを受け付け、動的クライアント登録、PKCE 付きの認可コード、1 時間有効なアクセストークン、リフレッシュトークンに対応します。Node 20 以降向けの公式 TypeScript SDK である @modelcontextprotocol/client を使うと、OAuthClientProvider がクライアント、トークン、PKCE の verifier を保持します。最初の接続ではユーザーをサインイン画面に送り、UnauthorizedError を投げます。コールバックのクエリを finishAuth に渡すと認証が完了します。

TikTok への投稿機能がここにあるのは、TikTok が、トークンの背後にある開発者アプリで検証済みの URL プレフィックスからしかメディアをダウンロードしないためです。publish_tiktok_post は HTTPS のリンクを受け取り、easyCoexistence の検証済みメディアルートにある署名付きアドレスを TikTok に渡します。get_tiktok_publish_status で投稿の状況を追えます。同じクライアントは、アカウントのネットワークすべてのツールをエージェントに渡します。まず list_social_accounts を呼び出してください。そのアカウント ID は Partner API のチャンネル ID です。

Sign in over OAuth and publish to TikTok with the MCP client
import { createInterface } from "node:readline/promises";
import { Client, StreamableHTTPClientTransport, UnauthorizedError, type OAuthClientProvider } from "@modelcontextprotocol/client";

const MCP = new URL("https://easycoexistence.com/api/mcp");
const saved: Record<string, any> = {}; // persist this, so the browser sign-in happens once

const provider: OAuthClientProvider = {
  redirectUrl: "http://localhost:8090/callback",
  clientMetadata: { client_name: "My social agent", redirect_uris: ["http://localhost:8090/callback"] },
  state: () => (saved.state = crypto.randomUUID()),
  clientInformation: () => saved.client,
  saveClientInformation: (info) => { saved.client = info; },
  tokens: () => saved.tokens,
  saveTokens: (tokens) => { saved.tokens = tokens; },
  saveCodeVerifier: (verifier) => { saved.verifier = verifier; },
  codeVerifier: () => saved.verifier,
  redirectToAuthorization: (url) => console.log("Sign in to easyCoexistence:", url.href),
};

const client = new Client({ name: "my-social-agent", version: "1.0.0" });
const transport = new StreamableHTTPClientTransport(MCP, { authProvider: provider });
try {
  await client.connect(transport);
} catch (error) {
  if (!(error instanceof UnauthorizedError)) throw error;
  const rl = createInterface({ input: process.stdin, output: process.stdout });
  const back = new URL(await rl.question("Paste the address you were sent back to: ")).searchParams;
  rl.close();
  if (back.get("state") !== saved.state) throw new Error("state mismatch");
  await transport.finishAuth(back);
  await client.connect(new StreamableHTTPClientTransport(MCP, { authProvider: provider }));
}

const result = await client.callTool({
  name: "publish_tiktok_post",
  arguments: {
    account_id: process.env.TIKTOK_CHANNEL_ID, // the Partner API channel id
    video_url: "https://cdn.example.com/launch.mp4",
    caption: "New drop #behindthescenes",
  },
});
console.log(result.content); // a share_id to follow with get_tiktok_publish_status

よくある間違い

  • パースして再シリアライズした JSON に対して HMAC を計算すること。署名は生のボディをバイト単位で対象にするため、まず req.text() を呼び、その後でパースしてください。そうしないと、すべての配信が検証に失敗します。
  • TikTok の ID を数値に変換すること。コメント ID と動画 ID は 64 ビットで、Number() は丸めてしまいます。返信やコメントの検索には、イベントに含まれる文字列のまま使ってください。
  • リダイレクトから channel_id だけを保存すること。Facebook や LinkedIn のサインインでは、一度に複数のページを追加できます。GET /channels?external_ref= で一覧を取得し、それぞれを保存してください。
  • Messenger や Instagram の DM への返信を夜間のバッチで行うこと。相手の最後のメッセージから 24 時間を過ぎると送信は失敗します。返信は、ウィンドウが開いている間にイベントハンドラーから行ってください。
EasyCoexistence で実現する

easyCoexistence は、Node.js のバックエンドや AI エージェントに、WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn などのチャンネルを通じて顧客との接点を提供します。各チャンネルは公式 API を通じて接続されます。Partner API でアカウントを接続し、新しいトークンと署名付きイベントを取得できます。TypeScript のエージェントは MCP サーバー経由で操作できます。すべての接続を 24 時間体制で監視します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 までです。最初の 3 日間は無料トライアルです。

よくある質問

Node.js からこれらの API を呼び出すのに SDK は必要ですか?

いいえ。Partner API とネットワークの API は通常の HTTPS なので、Node 18 以降のグローバル fetch で十分です。@modelcontextprotocol/client は MCP ツールを使う場合のみ必要です。TikTok への投稿も、そのツールに含まれます。

TikTok への投稿が MCP サーバーを経由するのはなぜですか?

TikTok は、開発者アプリに対して検証済みのドメインや URL プレフィックスからのみ動画と写真をダウンロードします。そのアプリは easyCoexistence のものです。publish_tiktok_post は検証済みのアドレスから HTTPS のファイルを配信するため、ご自身のドメインを検証する必要はありません。

1 回のサインインで複数の Facebook や LinkedIn のページを接続できますか?

はい。各ページは、LinkedIn の場合はメンバー自身のプロフィールも含めて、それぞれ独立したチャンネルと接続になります。リダイレクトには最初の channel_id が含まれ、GET /channels?external_ref= で全件を一覧できます。

easyCoexistence の Node.js 向けの料金はいくらですか?

接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 までです。どのネットワークでも同じ料金です。Partner API と MCP コネクターも追加費用なしで含まれ、シート課金はありません。最初の 3 日間は無料トライアルです。

続きを読む

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

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

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

確認日