以單一 API 從 Node.js 發布至 Instagram、TikTok 與 Facebook
透過 easyCoexistence,Node.js 或 TypeScript 後端可經由各網絡的官方 API,發布到 Instagram、Facebook、TikTok、YouTube 與 LinkedIn。帳戶只需透過託管連結登入一次;之後每項工作僅需一次 fetch,即可取得 TikTok、YouTube 及 LinkedIn 的新存取權杖,而已簽署的事件會把留言與私訊送到您的路由。以 TypeScript MCP SDK 建構的代理,則會把同一批帳戶視為工具使用。
TikTok 發布端點每個帳戶可接受的影片發布,每分鐘最多 6 則。
使用 published false 與 scheduled_publish_time 時,Facebook 專頁貼文可提前多久排程。
承載新 LinkedIn 貼文 URN 的回應標頭,隨 201 狀態碼送出。
留言建立、刪除或可見度變更後,TikTok 多快觸發 comment.update 事件。
Partner API 的連接連結,在工作階段過期前可保持開啟多久。
Node.js 後端如何連接帳戶,並取得其存取權杖?
您的後端會開啟一個連接工作階段,由帳戶擁有人在瀏覽器中完成授權。以 ec_live_ 金鑰作為 bearer 權杖,向 /connect-sessions 發出 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。已簽署的 channel.connected、channel.disconnected、channel.removed 與 channel.suspended 事件,會送到您在控制台設定的事件 URL,讓應用程式得知帳戶何時有變。
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 與 caption 建立容器,輪詢其 status_code 直至顯示 FINISHED,再以容器 ID 作為 creation_id 呼叫 media_publish。Meta 建議約每分鐘輪詢 1 次,並於 5 分鐘後停止;ERROR 或 EXPIRED 表示容器不會發布,而未發布滿 24 小時的容器會自動過期。
Facebook 專頁只需一次呼叫 /{page-id}/photos,附上圖片 url 與說明文字即可發布相片,文字與連結則送到 /{page-id}/feed。兩者都接受 published false 與 scheduled_publish_time,由 Meta 於指定時間自行發布,可排程於 10 分鐘至 30 天後。權杖以 bearer 標頭傳送,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?
除每次呼叫的 bearer 權杖外,LinkedIn 還需要兩個標頭:LinkedIn-Version,填入 easyCoexistence 於 required_headers 回傳的 YYYYMM 值;以及設為 2.0.0 的 X-Restli-Protocol-Version。發布貼文時,以 POST 送到 /rest/posts,內容包括作者 URN、commentary 文字、PUBLIC 可見度、以動態消息作為 distribution,以及 lifecycleState PUBLISHED。LinkedIn 以 201 回應,並把新貼文的 URN 放在 x-restli-id 標頭中;任何放進 URL 路徑的 URN 都必須進行 URL 編碼。
YouTube 需要兩個請求。以 POST 送至上傳端點,附上 uploadType=resumable 與 part=snippet,status,即可送出中繼資料,並在 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 路由中接收留言與私訊?
每個頻道會把事件轉送到您透過 PUT /channels/{id}/webhook 提供的 URL,該呼叫只回傳一次頻道的 signing_secret。每次送遞均為 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 中,私訊放在 messaging 中。TikTok 的 entry 則包含 comment.update 事件,TikTok 會在留言後 5 分鐘內觸發,並以字串形式提供 comment_id 與 video_id,以免 JavaScript 把這兩個 64 位元數字捨入。每個事件只嘗試一次,且不會儲存副本,因此請立即以 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 中回覆留言與私訊?
以新的 credentials 呼叫,並使用事件中的 ID。在 Instagram 與 Facebook 上,私訊回覆送到 /{account-id}/messages,使用 account_id_on_meta,以對方的 ID 作為 recipient,且須在對方最後一則訊息後 24 小時內發送;專頁另須加上 messaging_type RESPONSE,而 Instagram 文字上限為 1,000 位元組。留言可獲公開回覆,Instagram 送至 /{comment-id}/replies,Facebook 送至 /{comment-id}/comments;亦可在 7 天內作一次私下回覆。
TikTok 的對話一律公開,因為 TikTok 沒有私訊。business/comment/reply/create/ 以 Access-Token 標頭、business_id、video_id 與 comment_id 發出,可回覆最多 1,200 個字元的留言。請讀取回應的 code 欄位,0 表示成功,而非 HTTP 狀態碼。只處理 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 連結,並向 TikTok 提供 easyCoexistence 已驗證媒體路由上的簽署位址;get_tiktok_publish_status 則追蹤該貼文的狀態。同一個用戶端會把帳戶所屬各網絡的所有工具交給代理;請先呼叫 list_social_accounts,其中的 account_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 為 64 位元,Number() 會捨入,因此回覆或查詢留言時,請保留事件所附的字串。
- 只從重新導向保留 channel_id。Facebook 或 LinkedIn 登入可能一次新增多個專頁,因此請以 GET /channels?external_ref= 列出,並分別儲存每一個。
- 在每晚批次中回覆 Messenger 或 Instagram 私訊。超過對方最後一則訊息後 24 小時,發送便會失敗,因此應在有效時段內,於事件處理程式中回覆。
easyCoexistence 為 Node.js 後端與 AI 代理提供與客戶溝通的能力,涵蓋 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 等頻道,並會陸續加入更多頻道,各自透過官方 API 運作。以 Partner API 連接帳戶、取得新鮮權杖與已簽署事件,並讓 TypeScript 代理透過 MCP 伺服器執行操作,所有連接均全天候 24/7 監控。每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,首 3 天免費試用。
常見問題
從 Node 呼叫這些 API 需要 SDK 嗎?
不需要。Partner API 與各網絡的 API 都是純 HTTPS,Node 18 及以上版本內建的全域 fetch 即可應付。只有 MCP 工具(當中包括 TikTok 發布)才需要 @modelcontextprotocol/client。
為何 TikTok 發布要經過 MCP 伺服器?
TikTok 只會從已為開發者應用程式驗證的網域或 URL 前綴下載影片與相片,而該應用程式屬於 easyCoexistence。publish_tiktok_post 會從該已驗證位址提供您的 HTTPS 檔案,因此您自己的網域無需驗證。
一次登入可以連接多個 Facebook 或 LinkedIn 專頁嗎?
可以。每個專頁,以及 LinkedIn 上會員本人的個人檔案,各自成為一個頻道與一個連接。重新導向會附上第一個 channel_id,而 GET /channels?external_ref= 可列出全部。
easyCoexistence 用於 Node.js 的費用是多少?
每個連接每月 US$ 9 至 US$ 0.75,連接越多單價越低,各網絡收費一致。Partner API 與 MCP 連接器包含在內,不按座位收費,首 3 天免費試用。
繼續閱讀
兩分鐘內連接您的第一個頻道。
無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期