ВойтиНачать бесплатный пробный период
easyCoexistence Официальные API

Публикация в Instagram, TikTok и Facebook из Node.js одним API

С easyCoexistence бэкенд на Node.js или TypeScript публикует в Instagram, Facebook, TikTok, YouTube и LinkedIn через официальный API каждой сети. Аккаунты подключаются один раз по ссылке на нашем сайте; один вызов fetch затем возвращает свежий токен для каждой задачи в TikTok, YouTube и LinkedIn, а подписанные события передают комментарии и личные сообщения на ваш маршрут. Агенты, построенные на TypeScript MCP SDK, получают те же аккаунты как инструменты.

15 a day

Видео, которые принимает эндпоинт публикации TikTok, на каждый аккаунт, не более шести в минуту.

10 min to 30 days

На сколько вперёд можно запланировать пост на Страницу Facebook с published false и scheduled_publish_time.

x-restli-id

Заголовок ответа, который несёт URN нового поста LinkedIn, при статусе 201.

5 minutes

Через сколько TikTok отправляет событие comment.update после создания или удаления комментария либо изменения его видимости.

1 hour

Как долго ссылка подключения 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 для событий, заданный в вашей панели управления, сообщают приложению, когда аккаунт меняется.

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;
}

Как публиковать в 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 скачивает.

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
  });
}

Как публиковать в 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, поэтому ничего вашего не должно работать в этот час.

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?

Каждый канал пересылает данные на 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 сразу и обрабатывайте событие из очереди.

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?

Свежим вызовом 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, поскольку ваши собственные ответы тоже приходят как события.

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-агенту эти инструменты?

Оба варианта работают через 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.

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

Распространённые ошибки

  • Вычисление HMAC по разобранному и заново сериализованному JSON. Подпись покрывает сырое тело побайтово, поэтому сначала вызовите req.text(), а разбирайте после, иначе каждая доставка не пройдёт проверку.
  • Превращение id TikTok в числа. Id комментариев и видео 64-битные, а Number() их округляет, поэтому сохраняйте строки из события, когда отвечаете или ищете комментарий.
  • Сохранение только channel_id из перенаправления. Вход через Facebook или LinkedIn может добавить сразу несколько Страниц, поэтому получите их список через GET /channels?external_ref= и сохраните каждую.
  • Ответ на личное сообщение Messenger или Instagram из ночного пакетного задания. Вне 24 часов после последнего сообщения человека отправка не проходит, поэтому отвечайте из обработчика событий, пока окно открыто.
Настройка с EasyCoexistence

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 дня бесплатны.

Читайте дальше

Публикация в Instagram, TikTok и Facebook из Python через один APIПубликуйте посты, читайте комментарии и отвечайте на личные сообщения в Instagram, Facebook, TikTok, YouTube и LinkedIn из Python через официальные API.API соцсетей для ИИ-агентов: публикация, планирование, ответы и аналитикаОдин API и MCP-сервер для ИИ-агентов: публикации, планирование, ответы и аналитика в соцсетях через официальные API каждой сети.MCP-сервер для соцсетей: Claude и ChatGPTОдин MCP-коннектор для всех сетей: Claude или ChatGPT публикуют, планируют, отвечают на комментарии и личные сообщения, читают аналитику через официальные API.Токен доступа к странице Facebook: как долго он действует и что его аннулируетКак получить токен доступа к странице Facebook без срока действия, кто может его получить и что заставляет Meta перестать его принимать.TikTok API for Business против Content Posting APIПочему API for Business от TikTok, а не developers.tiktok.com: комментарии и их вебхук, инсайты, какие аккаунты подключаются и как обновляются токены.Вебхук ленты Facebook Страницы: события комментариев, публикаций и реакцийЧто передаёт вебхук ленты Facebook Страницы при комментариях, публикациях и реакциях: поля item и verb, структура тела запроса Meta и подписка Страницы.

Подключите первый канал за две минуты.

Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.

  • 3 дня бесплатно
  • Отмена в любой момент
  • Только официальные API
  • Мониторинг 24/7

Проверено по состоянию на