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 で構築したエージェントは、同じアカウントをツールとして利用できます。
TikTok の投稿エンドポイントがアカウントごとに受け付ける動画投稿は、1 分あたり 6 件までです。
published を false にし scheduled_publish_time を指定したとき、Facebook のページ投稿を予約できる期間。
新しい LinkedIn 投稿の URN を運ぶレスポンスヘッダーで、ステータスは 201 で返されます。
コメントの作成、削除、公開範囲の変更から、TikTok が comment.update イベントを発火するまでの時間。
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 が送られ、アカウントの変化をアプリに伝えます。
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 に置く必要があります。
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 自身のスケジューラーに任されるため、その時刻にご自身のプログラムを動かしておく必要はありません。
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 を返し、処理はキューから行ってください。
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 のイベントだけに反応してください。
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 です。
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 は、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 監視
確認日