Публикация в Instagram, TikTok и Facebook из Python через один API
С easyCoexistence код на Python публикует посты в Instagram, Facebook, TikTok, YouTube и LinkedIn через официальный API каждой сети. Каждый аккаунт подключается один раз по готовой ссылке, после чего ваш скрипт одним GET-запросом получает свежий токен TikTok, YouTube или LinkedIn и обращается к сети, чтобы опубликовать пост и ответить на комментарии и личные сообщения, тогда как вызовы Instagram и Facebook идут через инструменты MCP easyCoexistence, которые хранят токен. MCP-инструменты дают Python-агенту те же аккаунты.
Максимальный объём текста одного личного сообщения в Instagram через API, считается в UTF-8, поэтому эмодзи занимают больше места.
Срок жизни токена доступа TikTok API for Business; его refresh-токен действует один год.
Срок жизни пользовательского токена доступа Google, который несёт каждый вызов YouTube API.
OAuth-обработчик MCP Python SDK, который регистрирует клиента, проводит вход с PKCE и обновляет токены.
Пересылаемые события комментариев, упоминаний и личных сообщений доставляются один раз и не сохраняются, поэтому подтверждайте каждое сразу.
Как Python получает токен для Instagram, Facebook, TikTok, YouTube или LinkedIn?
Через сессию подключения в Partner API easyCoexistence, с аутентификацией по вашему ключу ec_live_. POST /connect-sessions с channel, равным instagram, facebook, tiktok, youtube или linkedin, возвращает ссылку для одного клиента, действующую один час. Клиент входит через собственный логин сети и попадает на ваш redirect_url с status=connected и channel_id. Ваш бэкенд подтверждает это запросом GET /connect-sessions/{session}, а не доверяет строке запроса. Вашему коду не нужно собственное приложение разработчика в Meta, TikTok, Google или LinkedIn.
Затем запрашивайте учётные данные в начале каждой задачи. GET /channels/{id}?credentials=1 возвращает базовый адрес API сети, id аккаунта в этой сети и, для TikTok, YouTube и LinkedIn, токен доступа, который easyCoexistence продлевает. Токен TikTok живёт 24 часа, токен Google один час, поэтому получайте его для каждой задачи, а не сохраняйте. Токены Instagram и Facebook не выдаются никогда; их вызовы идут через инструменты MCP.
import os
import requests
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
# A hosted sign-in link for one customer on one network
session = requests.post(f"{EC}/connect-sessions", headers=KEY, json={
"channel": "instagram", # or facebook, tiktok, youtube, linkedin
"redirect_url": "https://app.example.com/connected",
"external_ref": "customer_4821",
}).json()
print(session["url"]) # they come back with ?session=...&status=connected&channel_id=...
def credentials(channel_id: str) -> dict:
"""The network's API base and a token that is valid now. Call it per job."""
r = requests.get(f"{EC}/channels/{channel_id}", headers=KEY, params={"credentials": 1})
r.raise_for_status()
creds = r.json()["credentials"]
if not creds.get("access_token"):
raise RuntimeError(creds.get("note", "This channel is not connected."))
return credsКак опубликовать пост в Instagram и Facebook из Python?
Instagram публикует в два шага через Graph API Meta, токен передаётся заголовком Bearer. POST /{ig-id}/media с image_url и подписью (caption) создаёт контейнер. Когда GET его status_code вернёт FINISHED, POST /{ig-id}/media_publish с контейнером в creation_id помещает пост в профиль. Meta рекомендует проверять статус примерно раз в минуту, до пяти минут. Reel проходит те же шаги, отправляется с media_type REELS и video_url вместо изображения.
Пост на страницу Facebook занимает один вызов: POST /{page-id}/feed с message и, если нужно, link. Если добавить published false и scheduled_publish_time от 10 минут до 30 дней вперёд, Meta опубликует пост в этот момент, и никакая задача с вашей стороны не запущена. В обоих случаях Meta загружает медиа с публичного URL, а Instagram принимает только изображения JPEG.
import time
import requests
def graph(c: dict, path: str, **body) -> dict:
"""Meta's Graph API: a POST when there is a body, a GET when there is none."""
r = requests.request("POST" if body else "GET", f"{c['graph_api_base']}/{path}",
json=body or None, headers={"Authorization": f"Bearer {c['access_token']}"})
r.raise_for_status()
return r.json()
def post_to_instagram(channel_id: str, image_url: str, caption: str) -> str:
c = credentials(channel_id)
ig = c["account_id_on_meta"]
container = graph(c, f"{ig}/media", image_url=image_url, caption=caption)["id"]
for _ in range(5): # Meta: check about once a minute, for up to five minutes
status = graph(c, f"{container}?fields=status_code")["status_code"]
if status == "FINISHED":
return graph(c, f"{ig}/media_publish", creation_id=container)["id"]
if status in ("ERROR", "EXPIRED"):
raise RuntimeError(f"Instagram could not process the media: {status}")
time.sleep(60)
raise TimeoutError("The container is still processing")
def schedule_on_facebook(channel_id: str, message: str, publish_at: int) -> str:
c = credentials(channel_id)
post = graph(c, f"{c['account_id_on_meta']}/feed", message=message,
published=False, scheduled_publish_time=publish_at) # unix seconds
return post["id"]Как загрузить видео на YouTube и опубликовать пост в LinkedIn из Python?
YouTube принимает видео как возобновляемую загрузку. Первый запрос уходит на эндпоинт загрузки с uploadType=resumable и part=snippet,status и несёт название и статус в JSON. Заголовок Location в ответе содержит адрес сессии. PUT файла на этот адрес отвечает 201 и новым видео. Если задать privacyStatus равным private и время publishAt, YouTube опубликует видео сам в этот момент, а selfDeclaredMadeForKids указывает, предназначено ли оно для детей.
LinkedIn принимает один POST на /rest/posts с Bearer-токеном, заголовком LinkedIn-Version и X-Restli-Protocol-Version 2.0.0. В теле указываются автор, текст в поле commentary и значения visibility, distribution и lifecycleState. Учётные данные дают author_urn: urn:li:organization для страницы компании или urn:li:person для профиля, а также версию, которую использует easyCoexistence. URN нового поста возвращается в заголовке x-restli-id.
import requests
def schedule_on_youtube(channel_id: str, path: str, title: str, publish_at: str) -> str:
c = credentials(channel_id)
auth = {"Authorization": f"Bearer {c['access_token']}"}
start = requests.post(
"https://www.googleapis.com/upload/youtube/v3/videos",
params={"uploadType": "resumable", "part": "snippet,status"},
headers={**auth, "X-Upload-Content-Type": "video/mp4"},
json={"snippet": {"title": title},
"status": {"privacyStatus": "private", "publishAt": publish_at, # ISO 8601
"selfDeclaredMadeForKids": False}},
)
start.raise_for_status()
with open(path, "rb") as video: # streamed, not read into memory
done = requests.put(start.headers["Location"], data=video,
headers={**auth, "Content-Type": "video/mp4"})
done.raise_for_status()
return done.json()["id"]
def post_on_linkedin(channel_id: str, text: str) -> str:
c = credentials(channel_id)
r = requests.post(f"{c['api_base']}/posts", headers={
"Authorization": f"Bearer {c['access_token']}",
"LinkedIn-Version": c["required_headers"]["LinkedIn-Version"], # YYYYMM
"X-Restli-Protocol-Version": "2.0.0",
}, json={
"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,
})
r.raise_for_status()
return r.headers["x-restli-id"] # the new post's URNКак читать и отвечать на комментарии и личные сообщения из Python?
Включите пересылку для канала, проверяйте каждую доставку и отвечайте через API сети. PUT /channels/{id}/webhook с url возвращает signing_secret, который показывается только один раз. Комментарии, упоминания и личные сообщения в Instagram и Facebook, а также комментарии в TikTok приходят как POST с platform, account_id, external_id и entry. Поле entry передаётся ровно так, как прислала сеть. Заголовок X-EC-Signature имеет вид t=<unix>,v1=<hex>, где v1 это HMAC-SHA256 от метки времени, точки и исходного тела. Каждое событие отправляется один раз, без сохранённой копии и без повторной отправки, поэтому сначала подтвердите получение и работайте из очереди.
Ответ на личное сообщение в Instagram уходит на /{ig-id}/messages в течение 24 часов после последнего сообщения человека, длиной не более 1 000 байт. Комментарий получает публичный ответ на /{comment-id}/replies или один приватный ответ в течение 7 дней. Ответы на комментарии TikTok публичны и идут через business/comment/reply/create/, потому что личных сообщений в TikTok нет. Комментарии YouTube и LinkedIn читаются через их API по расписанию.
import hashlib, hmac, json, queue, time
import requests
from flask import Flask, abort, request
app = Flask(__name__)
jobs: queue.Queue = queue.Queue() # a worker calls reply_on_instagram() for each event
SECRETS: dict[str, str] = {} # channel_id -> signing_secret; keep them in your database
def forward_events(channel_id: str, url: str) -> None:
r = requests.put(f"{EC}/channels/{channel_id}/webhook", headers=KEY, json={"url": url})
r.raise_for_status()
SECRETS[channel_id] = r.json()["signing_secret"] # returned only this once
def verified(raw: bytes, header: str, secret: str) -> bool:
parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
t, v1 = parts.get("t", ""), parts.get("v1", "")
if not t.isdigit() or abs(time.time() - int(t)) > 300:
return False
mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
return hmac.compare_digest(mac.encode(), v1.encode())
@app.post("/hooks/social")
def social_event():
raw = request.get_data()
event = json.loads(raw) # platform, account_id, external_id, entry
secret = SECRETS.get(event.get("account_id"))
if not secret or not verified(raw, request.headers.get("X-EC-Signature", ""), secret):
abort(401)
jobs.put(event) # sent once and never retried: acknowledge first, work after
return "", 204
def reply_on_instagram(event: dict, text: str) -> None:
c, me = credentials(event["account_id"]), event["external_id"]
for m in event["entry"].get("messaging", []): # DMs, minus echoes of your own
if "message" in m and not m["message"].get("is_echo"):
graph(c, f"{me}/messages", recipient={"id": m["sender"]["id"]}, message={"text": text})
for ch in event["entry"].get("changes", []): # comments, minus your own replies
if ch["field"] == "comments" and ch["value"]["from"]["id"] != me:
graph(c, f"{ch['value']['id']}/replies", message=text)Как опубликовать пост в TikTok из Python?
Через MCP-инструмент easyCoexistence publish_tiktok_post. API for Business от TikTok принимает видео как video_url и с 16 ноября 2023 г. загружает его только с домена или префикса URL, подтверждённого для приложения разработчика, которому принадлежит токен. Это приложение easyCoexistence. Инструмент принимает вашу HTTPS-ссылку и передаёт TikTok подписанный адрес на проверенном маршруте медиа easyCoexistence, отдавая файл потоком без сохранения.
Фото-посты принимают image_urls, от 1 до 35 файлов JPEG или WebP. Инструмент get_tiktok_publish_status отслеживает пост, пока TikTok его обрабатывает. Из Python это один вызов через официальный MCP SDK версии 2, на Python 3.10 или новее. Сервер https://easycoexistence.com/api/mcp принимает только OAuth 2.1, поэтому OAuthClientProvider из SDK регистрирует ваш клиент, проводит один вход в браузере с PKCE и обновляет токены. Токены доступа действуют час, refresh-токены 60 дней. Каждое обновление выдаёт новую пару, а хранилище, которое их сохраняет, поддерживает вход бэкенда.
import asyncio
import os
from urllib.parse import parse_qs, urlparse
import httpx2
from pydantic import AnyUrl
from mcp import Client
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.client.streamable_http import streamable_http_client
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
MCP_URL = "https://easycoexistence.com/api/mcp"
class Storage: # keep both values in a database, so the browser sign-in happens once
tokens: OAuthToken | None = None
client: OAuthClientInformationFull | None = None
async def get_tokens(self): return self.tokens
async def set_tokens(self, tokens): self.tokens = tokens
async def get_client_info(self): return self.client
async def set_client_info(self, info): self.client = info
async def show_sign_in(url: str) -> None:
print("Sign in to easyCoexistence:", url)
async def read_callback() -> AuthorizationCodeResult:
query = parse_qs(urlparse(input("Paste the address you were sent back to: ")).query)
return AuthorizationCodeResult(code=query["code"][0], state=query["state"][0])
oauth = OAuthClientProvider(
server_url=MCP_URL,
client_metadata=OAuthClientMetadata(
client_name="My social agent",
redirect_uris=[AnyUrl("http://localhost:3030/callback")],
scope="mcp",
),
storage=Storage(),
redirect_handler=show_sign_in,
callback_handler=read_callback,
)
async def main() -> None:
timeout = httpx2.Timeout(30.0, read=300.0)
async with httpx2.AsyncClient(auth=oauth, timeout=timeout) as http:
async with Client(streamable_http_client(MCP_URL, http_client=http)) as client:
result = await client.call_tool("publish_tiktok_post", {
"account_id": os.environ["TIKTOK_CHANNEL_ID"], # the Partner API channel id
"video_url": "https://cdn.example.com/launch.mp4",
"caption": "New drop #behindthescenes",
})
print(result.content[0].text) # a share_id for get_tiktok_publish_status
asyncio.run(main())Как ИИ-агент на Python использует эти аккаунты?
Через ту же MCP-сессию. Сервер перечисляет инструменты для сетей вашего аккаунта, и любой фреймворк агентов, принимающий инструменты MCP, может передать их своей модели. Модель публикует в каждой сети, перечисляет посты, читает комментарии и отвечает на них, отвечает на личные сообщения в Instagram и Facebook, настраивает правила перехода от комментария к личному сообщению и читает статистику и аналитику. Инструкции сервера и описание каждого инструмента содержат правила сети, поэтому модель знает, что ответы в TikTok публичны и что изображения для Instagram должны быть в JPEG.
Запустите агента с list_social_accounts, так как каждый другой социальный инструмент принимает из него account_id, а этот id совпадает с channel id, который возвращает Partner API. Ответы, которые должны уйти в 3 часа ночи, когда агент не запущен, относятся к правилам комментариев и автоматизациям, которые работают на самом easyCoexistence.
Распространённые ошибки
- Сохранение токена в конфигурационном файле. Токен TikTok истекает в течение суток, токен Google в течение часа, а easyCoexistence продлевает их в фоне, поэтому вызывайте эндпоинт с учётными данными в начале каждой задачи.
- Передача TikTok ссылки на ваш собственный домен. TikTok загружает медиа только с префиксов URL, подтверждённых для приложения, которое владеет токеном, поэтому публикуйте через инструмент publish_tiktok_post: он отдаёт ваш файл с проверенного адреса easyCoexistence.
- Ответ на каждое событие комментария, включая собственные. Ваши публичные ответы возвращаются как новые комментарии, а личные сообщения в Instagram как эхо, поэтому пропускайте события, где автор это сам аккаунт, иначе бот отвечает сам себе.
- Измерение личного сообщения в Instagram в символах. Лимит составляет 1 000 байт в UTF-8, поэтому текст с эмодзи или буквами с диакритикой заканчивается раньше. Обрезайте текст по закодированной длине перед отправкой.
easyCoexistence даёт вашему Python-коду и вашим ИИ-агентам доступ к клиентам в WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn и других каналах через официальный API каждой сети. Partner API подключает аккаунты и выдаёт свежие токены, MCP-сервер передаёт агентам те же аккаунты как инструменты, а каждое подключение отслеживается круглосуточно. От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений; первые 3 дня бесплатно.
Часто задаваемые вопросы
Нужно ли мне собственное приложение разработчика в Meta, TikTok, Google или LinkedIn?
Нет. Аккаунты входят через собственное приложение easyCoexistence в каждой сети, а вызов учётных данных передаёт вашему коду токен этого аккаунта на TikTok, YouTube и LinkedIn, готовый к использованию с API сети.
Какая версия Python и какие библиотеки нужны?
Partner API и API сетей работают по обычному HTTPS с JSON, поэтому их вызывают requests, httpx или любой другой HTTP-клиент Python. Для MCP Python SDK версии 2, который используют публикация в TikTok и инструменты агентов, нужен Python 3.10 или новее.
Какие сети отправляют комментарии и личные сообщения на мой эндпоинт?
Instagram и Facebook пересылают комментарии, упоминания и личные сообщения, а TikTok пересылает комментарии, и каждое событие подписано секретом канала. YouTube и LinkedIn таких событий не отправляют, поэтому читайте их комментарии через API по расписанию.
Сколько стоит easyCoexistence для Python?
От US$ 9 до US$ 0,75 за подключение в месяц, цена снижается по мере добавления подключений, одинаково для каждой сети. Partner API и MCP-коннектор включены, без оплаты за места, а первые 3 дня бесплатно.
Читайте дальше
Подключите первый канал за две минуты.
Не нужно ждать проверок платформ. Подключите WhatsApp, Instagram, TikTok или другой канал, затем попросите ИИ опубликовать пост, ответить или подготовить отчёт и посмотрите, как он работает.
- 3 дня бесплатно
- Отмена в любой момент
- Только официальные API
- Мониторинг 24/7
Проверено по состоянию на