Публикация в Instagram, TikTok и Facebook из Node.js одним API
С easyCoexistence бэкенд на Node.js или TypeScript публикует в Instagram, Facebook, TikTok, YouTube и LinkedIn через официальный API каждой сети. Аккаунты подключаются один раз по ссылке на нашем сайте; один вызов fetch затем возвращает свежий токен для каждой задачи в TikTok, YouTube и LinkedIn, а подписанные события передают комментарии и личные сообщения на ваш маршрут. Агенты, построенные на TypeScript MCP SDK, получают те же аккаунты как инструменты.
Видео, которые принимает эндпоинт публикации TikTok, на каждый аккаунт, не более шести в минуту.
На сколько вперёд можно запланировать пост на Страницу Facebook с published false и scheduled_publish_time.
Заголовок ответа, который несёт URN нового поста LinkedIn, при статусе 201.
Через сколько TikTok отправляет событие comment.update после создания или удаления комментария либо изменения его видимости.
Как долго ссылка подключения Partner API остаётся открытой до истечения сессии.
Как бэкенд на Node.js подключает аккаунты и получает их токены?
Ваш бэкенд открывает сессию подключения, а владелец аккаунта завершает её в браузере. POST на /connect-sessions с вашим ключом ec_live_ в качестве bearer-токена, каналом, например tiktok или linkedin, redirect_url и external_ref для вашего клиента возвращает url на easycoexistence.com. Там владелец входит через собственный экран согласия сети и возвращается на ваш redirect_url с status=connected и channel_id. Отменённую попытку можно повторить по той же ссылке до истечения срока, то есть через час после создания.
Каждая задача затем начинается с GET /channels/{id}?credentials=1. Ответ содержит токен, действующий сейчас (не для Instagram и Facebook, чьи токены никогда не выдаются), и поля, которые нужны каждой сети: graph_api_base и account_id_on_meta для Instagram и Facebook, api_base и business_id для TikTok, channel_id для YouTube, author_urn и required_headers для LinkedIn. Подписанные события 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;
}Как публиковать в Instagram и Facebook из Node.js?
Instagram публикует через контейнер. Для Reel создайте его с media_type REELS, video_url и caption, опрашивайте status_code, пока он не станет FINISHED, и затем вызовите media_publish с id контейнера как creation_id. Meta рекомендует опрашивать примерно раз в минуту и прекращать через пять минут. Статус 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, а медиа должно лежать по публичному URL, который 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
});
}Как публиковать в LinkedIn и загружать на YouTube из Node.js?
LinkedIn требует при каждом вызове два заголовка помимо bearer-токена: LinkedIn-Version со значением YYYYMM, которое easyCoexistence возвращает в required_headers, и X-Restli-Protocol-Version со значением 2.0.0. Публикация выполняется POST-запросом на /rest/posts с author URN, текстом в поле commentary, видимостью PUBLIC, основной лентой в distribution и lifecycleState PUBLISHED. LinkedIn отвечает 201 и помещает URN нового поста в заголовок x-restli-id, а любой URN в пути URL должен быть URL-закодирован.
YouTube требует два запроса. POST на эндпоинт загрузки с uploadType=resumable и part=snippet,status отправляет метаданные и возвращает адрес сессии в заголовке Location. PUT байтов файла на этот адрес возвращает ресурс видео с его id. Загрузка как private с датой 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?
Каждый канал пересылает данные на URL, который вы укажете в PUT /channels/{id}/webhook, и этот вызов один раз возвращает signing_secret канала. Каждая доставка представляет собой POST с полями platform, account_id, external_id и entry и заголовком X-EC-Signature вида t=<unix>,v1=<hex>, где v1 это HMAC-SHA256 от t, точки и сырого тела. Берите тело как текст до разбора, отклоняйте t старше пяти минут и сравнивайте через timingSafeEqual.
Для Instagram и Facebook entry это запись вебхука Meta в том виде, в каком её прислала Meta: changes для комментариев и упоминаний, messaging для личных сообщений. Для TikTok там лежит событие comment.update, которое TikTok отправляет в течение пяти минут после комментария, с 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 и идентификаторами из события. В Instagram и Facebook ответ на личное сообщение идёт на /{account-id}/messages с account_id_on_meta, id отправителя как recipient и в пределах 24 часов после его последнего сообщения. Страница добавляет messaging_type RESPONSE, а Instagram допускает не более 1 000 байт текста. Комментарий получает публичный ответ: /{comment-id}/replies в Instagram или /{comment-id}/comments в Facebook, либо один приватный ответ в течение 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-агенту эти инструменты?
Оба варианта работают через MCP-сервер easyCoexistence по адресу https://easycoexistence.com/api/mcp, который принимает только OAuth 2.1: динамическую регистрацию клиента, код авторизации с PKCE, токены доступа на один час и токены обновления. С @modelcontextprotocol/client, официальным TypeScript SDK для Node 20 и новее, OAuthClientProvider хранит клиента, токены и верификатор PKCE. Первое подключение отправляет пользователя на вход и выбрасывает UnauthorizedError, а finishAuth с query из callback завершает процесс.
Публикация в TikTok находится здесь, потому что TikTok скачивает медиа только по префиксам URL, подтверждённым для приложения разработчика, которому принадлежит токен. publish_tiktok_post принимает ваш ссылку HTTPS и передаёт TikTok подписанный адрес на проверенном маршруте медиа easyCoexistence, а get_tiktok_publish_status отслеживает пост. Тот же клиент передаёт агенту все инструменты для сетей аккаунта. Сначала вызовите list_social_accounts: его account_id это channel id из 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_statusРаспространённые ошибки
- Вычисление HMAC по разобранному и заново сериализованному JSON. Подпись покрывает сырое тело побайтово, поэтому сначала вызовите req.text(), а разбирайте после, иначе каждая доставка не пройдёт проверку.
- Превращение id TikTok в числа. Id комментариев и видео 64-битные, а Number() их округляет, поэтому сохраняйте строки из события, когда отвечаете или ищете комментарий.
- Сохранение только channel_id из перенаправления. Вход через Facebook или LinkedIn может добавить сразу несколько Страниц, поэтому получите их список через GET /channels?external_ref= и сохраните каждую.
- Ответ на личное сообщение Messenger или Instagram из ночного пакетного задания. Вне 24 часов после последнего сообщения человека отправка не проходит, поэтому отвечайте из обработчика событий, пока окно открыто.
easyCoexistence даёт бэкендам на Node.js и ИИ-агентам доступ к клиентам в WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналах, каждый через официальный API. Подключайте аккаунты через Partner API, получайте свежие токены и подписанные события, а агенты на TypeScript действуют через MCP-сервер, при этом мониторинг 24/7 работает для каждого подключения. От US$ 9 до US$ 0,75 за подключение в месяц, с уменьшением по мере добавления подключений, и с бесплатным пробным периодом в 3 дня.
Часто задаваемые вопросы
Нужен ли SDK, чтобы вызывать эти API из Node?
Нет. Partner API и API сетей работают по обычному HTTPS, поэтому глобального fetch в Node 18 и новее достаточно. @modelcontextprotocol/client нужен только для инструментов MCP, среди которых публикация в TikTok.
Почему публикация в 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 или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на