Siarkan ke Instagram, TikTok dan Facebook dari Node.js dengan satu API
Dengan easyCoexistence, backend Node.js atau TypeScript menyiarkan ke Instagram, Facebook, TikTok, YouTube dan LinkedIn melalui API rasmi setiap rangkaian. Setiap akaun log masuk sekali melalui pautan yang dihoskan; satu fetch kemudian memulangkan token baharu bagi setiap tugasan pada TikTok, YouTube dan LinkedIn, dan peristiwa bertandatangan membawa komen dan DM ke laluan anda. Ejen yang dibina dengan SDK MCP TypeScript mendapat akaun yang sama sebagai alat.
Video yang diterima oleh endpoint penerbitan TikTok bagi setiap akaun, tidak melebihi enam setiap minit.
Sejauh mana siaran Halaman Facebook boleh dijadualkan ke hadapan dengan published false dan scheduled_publish_time.
Pengepala respons yang membawa URN siaran LinkedIn baharu, dihantar dengan status 201.
Betapa cepat TikTok mencetuskan peristiwa comment.update selepas komen dicipta, dipadam atau keterlihatannya ditukar.
Tempoh pautan sambungan Partner API kekal terbuka sebelum sesinya tamat.
Bagaimana backend Node.js menyambungkan akaun dan mendapatkan tokennya?
Backend anda membuka sesi sambungan dan pemilik akaun menyelesaikannya dalam pelayar. Satu POST ke /connect-sessions, dengan kunci ec_live_ anda sebagai bearer token, saluran seperti tiktok atau linkedin, redirect_url dan external_ref bagi pelanggan anda, memulangkan url di easycoexistence.com. Di sana pemilik log masuk pada skrin kebenaran rangkaian itu sendiri dan kembali ke redirect_url anda dengan status=connected dan channel_id; percubaan yang dibatalkan boleh dicuba semula dari pautan yang sama sehingga ia tamat, iaitu sejam selepas ia dicipta.
Setiap tugasan kemudian bermula dengan GET /channels/{id}?credentials=1. Jawapannya mengandungi token yang sah sekarang (bukan bagi Instagram dan Facebook, yang tokennya tidak pernah diserahkan) serta medan yang diperlukan setiap rangkaian: graph_api_base dan account_id_on_meta bagi Instagram dan Facebook, api_base dan business_id bagi TikTok, channel_id bagi YouTube, author_urn dan required_headers bagi LinkedIn. Peristiwa channel.connected, channel.disconnected, channel.removed dan channel.suspended yang bertandatangan, dihantar ke URL peristiwa yang ditetapkan dalam dashboard anda, memberitahu aplikasi anda apabila sesuatu akaun berubah.
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;
}Bagaimana anda menyiarkan ke Instagram dan Facebook dari Node.js?
Instagram menyiarkan melalui bekas (container). Untuk Reel, cipta dengan media_type REELS, video_url dan caption, kemudian semak status_code sehingga ia menunjukkan FINISHED, lalu panggil media_publish dengan id bekas sebagai creation_id. Meta mengesyorkan menyemak kira-kira sekali seminit dan berhenti selepas lima minit; ERROR atau EXPIRED bermakna bekas itu tidak akan disiarkan, dan bekas yang kekal tidak disiarkan selama 24 jam tamat tempoh dengan sendirinya.
Halaman Facebook mengambil foto dalam satu panggilan ke /{page-id}/photos, dengan url imej dan caption, manakala teks dan pautan dihantar ke /{page-id}/feed. Kedua-duanya menerima published false dengan scheduled_publish_time, dan Meta sendiri menyiarkan siaran itu apabila masanya tiba, antara 10 minit hingga 30 hari ke hadapan. Token dihantar sebagai pengepala bearer, versi Graph API sudah terkandung dalam graph_api_base, dan media mesti berada di URL awam yang dimuat turun oleh Meta.
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
});
}Bagaimana anda menyiarkan ke LinkedIn dan memuat naik ke YouTube dari Node.js?
LinkedIn memerlukan dua pengepala tambahan selain token bearer pada setiap panggilan: LinkedIn-Version, dengan nilai YYYYMM yang dipulangkan easyCoexistence dalam required_headers, dan X-Restli-Protocol-Version ditetapkan kepada 2.0.0. Siaran ialah POST ke /rest/posts dengan URN pengarang, teks sebagai commentary, keterlihatan PUBLIC, suapan utama sebagai distribution dan lifecycleState PUBLISHED. LinkedIn membalas 201 dan meletakkan URN siaran baharu dalam pengepala x-restli-id, dan mana-mana URN yang diletakkan dalam laluan URL mesti dikodkan URL.
YouTube memerlukan dua permintaan. POST ke endpoint muat naik dengan uploadType=resumable dan part=snippet,status menghantar metadata dan memulangkan alamat sesi dalam pengepala Location; PUT bait fail ke alamat itu memulangkan sumber video dengan id-nya. Memuat naik sebagai private dengan tarikh publishAt membiarkan penerbitan diuruskan oleh penjadual YouTube sendiri, jadi tiada apa-apa daripada anda perlu berjalan pada jam itu.
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;
}Bagaimana anda menerima komen dan DM dalam laluan Node.js?
Setiap saluran menghantar ke URL yang anda berikan kepada PUT /channels/{id}/webhook, dan panggilan itu memulangkan signing_secret saluran sekali sahaja. Setiap penghantaran ialah POST yang mengandungi platform, account_id, external_id dan entry, dengan pengepala X-EC-Signature berbentuk t=<unix>,v1=<hex>, di mana v1 ialah HMAC-SHA256 bagi t, titik dan badan mentah. Ambil badan sebagai teks sebelum menghuraikannya, tolak t yang lebih lama daripada lima minit dan bandingkan dengan timingSafeEqual.
Bagi Instagram dan Facebook, entry ialah entri webhook Meta sebagaimana Meta menghantarnya: changes bagi komen dan sebutan, messaging bagi DM. Bagi TikTok ia mengandungi peristiwa comment.update, yang dicetuskan TikTok dalam tempoh lima minit selepas komen, dengan comment_id dan video_id sebagai rentetan supaya JavaScript tidak membundarkan nombor 64-bit tersebut. Hanya satu cubaan bagi setiap peristiwa dan tiada salinan disimpan, jadi balas 204 serta-merta dan proses daripada barisan gilir (queue).
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 });
}Bagaimana anda membalas komen dan DM dari Node.js?
Dengan panggilan credentials yang baharu dan id dalam peristiwa itu. Pada Instagram dan Facebook, balasan DM pergi ke /{account-id}/messages, menggunakan account_id_on_meta, dengan id pengirim sebagai recipient dan dalam tempoh 24 jam dari mesej terakhir mereka; Halaman menambah messaging_type RESPONSE, dan Instagram membenarkan paling banyak 1,000 bait teks. Komen mendapat balasan awam, di /{comment-id}/replies pada Instagram atau /{comment-id}/comments pada Facebook, atau satu balasan peribadi dalam tempoh 7 hari.
Perbualan TikTok kekal awam, kerana tiada DM di TikTok. business/comment/reply/create/, dengan pengepala Access-Token, business_id, video_id dan comment_id, menyiarkan balasan sehingga 1,200 aksara. Baca medan code bagi jawapan, di mana 0 bermaksud berjaya, dan bukannya kod status HTTP. Bertindaklah hanya ke atas comment_action insert dengan comment_type comment, kerana balasan anda sendiri turut tiba sebagai peristiwa.
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 },
});
}
}
}Bagaimana anda menyiarkan ke TikTok dan memberi ejen TypeScript alat-alat ini?
Kedua-duanya melalui pelayan MCP easyCoexistence di https://easycoexistence.com/api/mcp, yang hanya menerima OAuth 2.1: pendaftaran klien dinamik, kod kebenaran dengan PKCE, token akses yang sah selama sejam dan token penyegaran. Dengan @modelcontextprotocol/client, SDK TypeScript rasmi untuk Node 20 dan ke atas, objek OAuthClientProvider memegang klien, token dan verifier PKCE; sambungan pertama menghantar pengguna untuk log masuk dan melontarkan UnauthorizedError, dan finishAuth dengan query panggilan balik melengkapkannya.
Penerbitan TikTok terletak di sini kerana TikTok hanya memuat turun media daripada awalan URL yang disahkan untuk aplikasi pembangun di sebalik token. publish_tiktok_post menerima pautan HTTPS anda dan memberi TikTok alamat yang ditandatangani pada laluan media disahkan easyCoexistence, dan get_tiktok_publish_status menjejak siaran itu. Klien yang sama menyerahkan kepada ejen setiap alat bagi rangkaian akaun; panggil list_social_accounts dahulu, yang account_id-nya ialah id saluran Partner API.
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_statusKesilapan biasa
- Mengira HMAC ke atas JSON yang telah dihuraikan dan disiri semula. Tandatangan meliputi badan mentah bait demi bait, jadi panggil req.text() dahulu dan hurai kemudian, atau setiap penghantaran akan gagal pemeriksaan.
- Menukar id TikTok kepada nombor. Id komen dan video ialah 64-bit dan Number() membundarkannya, jadi kekalkan rentetan yang dibawa peristiwa apabila membalas atau mencari komen.
- Hanya menyimpan channel_id daripada pengalihan semula. Log masuk Facebook atau LinkedIn boleh menambah beberapa Halaman sekaligus, jadi senaraikannya dengan GET /channels?external_ref= dan simpan setiap satu.
- Membalas DM Messenger atau Instagram daripada tugasan kelompok malam. Di luar tempoh 24 jam dari mesej terakhir orang itu, penghantaran gagal, jadi balas daripada pengendali peristiwa semasa tetingkap masih terbuka.
easyCoexistence memberikan backend Node.js dan ejen AI capaian kepada pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, setiap satu melalui API rasmi masing-masing. Sambungkan akaun dengan Partner API, dapatkan token baharu dan peristiwa bertandatangan, dan biarkan ejen TypeScript bertindak melalui pelayan MCP, dengan setiap sambungan dipantau 24/7. US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan percubaan percuma 3 hari.
Soalan lazim
Adakah saya perlukan SDK untuk memanggil API ini dari Node?
Tidak. Partner API dan API rangkaian itu ialah HTTPS biasa, jadi fetch global dalam Node 18 ke atas sudah mencukupi. @modelcontextprotocol/client hanya diperlukan untuk alat MCP, termasuk penerbitan TikTok.
Mengapa penerbitan TikTok melalui pelayan MCP?
TikTok hanya memuat turun video dan foto daripada domain atau awalan URL yang disahkan untuk aplikasi pembangun, dan aplikasi itu ialah milik easyCoexistence. publish_tiktok_post menyajikan fail HTTPS anda daripada alamat yang disahkan itu, jadi domain anda sendiri tidak perlu pengesahan.
Bolehkah satu log masuk menyambungkan beberapa Halaman Facebook atau LinkedIn?
Boleh. Setiap Halaman, dan pada LinkedIn profil ahli itu sendiri, menjadi saluran sendiri dan sambungan sendiri. Pengalihan semula membawa channel_id pertama, dan GET /channels?external_ref= menyenaraikan semuanya.
Berapa kos easyCoexistence untuk Node.js?
US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, menurun apabila anda menambah sambungan, dan sama bagi setiap rangkaian. Partner API dan penyambung MCP disertakan, tanpa caj setiap pengguna, dan percubaan percuma 3 hari.
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