用 Python 通过一个 API 发布到 Instagram、TikTok 和 Facebook
借助 easyCoexistence,Python 代码可通过各平台的官方 API 发布到 Instagram、Facebook、TikTok、YouTube 和 LinkedIn。每个账户只需通过托管链接登录一次;之后脚本只需一次 GET 请求即可获取新的 TikTok、YouTube 或 LinkedIn 访问令牌,而 Instagram 和 Facebook 的调用则经由 easyCoexistence 的 MCP 工具完成,这些工具负责保管令牌。MCP 工具可让 Python 智能体使用同样的账户。
一条 Instagram 私信通过 API 能承载的最长文本,按 UTF-8 计算,因此表情符号占用更多空间。
TikTok API for Business 访问令牌的有效期;其刷新令牌有效期为一年。
Google 用户访问令牌的有效期,每次 YouTube API 调用都会携带这种令牌。
MCP Python SDK 的 OAuth 处理程序,负责注册客户端、通过 PKCE 完成登录并刷新令牌。
转发的评论、提及和私信事件只投递一次且不会存储,因此请立即确认每个事件。
Python 如何获取 Instagram、Facebook、TikTok、YouTube 或 LinkedIn 的访问令牌?
通过 easyCoexistence 的 Partner API 创建连接会话,使用您的 ec_live_ 密钥完成身份验证。以 channel 设为 instagram、facebook、tiktok、youtube 或 linkedin 调用 POST /connect-sessions,会为一位客户返回一个托管链接,有效期一小时。对方使用平台自己的登录方式登录后,会跳转到您的 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如何用 Python 发布到 Instagram 和 Facebook?
Instagram 通过 Meta 的 Graph API 分两步发布,访问令牌以 Bearer 请求头传递。向 /{ig-id}/media 发送 POST,携带 image_url 和 caption,即可创建一个容器;当对其 status_code 的 GET 结果为 FINISHED 后,再向 /{ig-id}/media_publish 发送 POST,并以 creation_id 指定该容器,即可将其发布到主页。Meta 建议每分钟检查一次,最多检查五分钟。Reel 的步骤相同,只需以 media_type REELS 发送,并用 video_url 替代图片。
Facebook 主页帖子只需一次调用:向 /{page-id}/feed 发送 POST,携带 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"]如何用 Python 上传到 YouTube 并在 LinkedIn 发帖?
YouTube 以可续传上传的方式接收视频。第一个请求发送到上传端点,带上 uploadType=resumable 和 part=snippet,status,并以 JSON 携带标题和状态;响应头中的 Location 即为上传会话地址。将文件以 PUT 发送到该地址,返回 201 即表示新视频已上传。将 privacyStatus 设为 private 并附带 publishAt 时间,YouTube 便会在该时刻自动发布视频;selfDeclaredMadeForKids 则用于记录视频是否面向儿童。
LinkedIn 只需向 /rest/posts 发送一次 POST,携带 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 回复。以 url 调用 PUT /channels/{id}/webhook,会返回一个 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/ 发送;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)如何用 Python 发布到 TikTok?
通过 easyCoexistence 的 MCP 工具 publish_tiktok_post。TikTok 的 API for Business 以 video_url 接收视频,并且自 2023 年 11 月 16 日起,仅从与令牌所属开发者应用(即 easyCoexistence 的应用)已验证的域名或 URL 前缀下载视频。该工具接收您的 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,因此 SDK 的 OAuthClientProvider 会注册您的客户端,通过 PKCE 完成一次浏览器登录,并刷新令牌。访问令牌有效期为一小时,刷新令牌为 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 的 AI 智能体如何使用这些账户?
通过同一个 MCP 会话。服务器会列出您账户所连接各平台的工具,任何支持 MCP 工具的智能体框架都可将这些工具交给其模型使用:在各平台发布内容、列出帖子、读取评论并回复、回复 Instagram 和 Facebook 的私信、设置评论转私信的规则,以及读取洞察与分析数据。服务器的说明及每个工具的描述包含各平台的规则,因此模型能够了解:TikTok 的回复是公开的,Instagram 图片必须为 JPEG。
智能体启动时应先调用 list_social_accounts,因为其他所有社交工具都需要从中获取 account_id,而该 ID 与 Partner API 返回的渠道 ID 相同。需要在凌晨 3 点发送、且没有智能体运行的回复,应交由评论规则和自动化功能处理,这些功能运行于 easyCoexistence 本身。
常见错误
- 将令牌保存在配置文件中。TikTok 的令牌在一天内过期,Google 的令牌在一小时内过期;easyCoexistence 会在后台为其续期,因此应在每个任务开始时调用凭证端点。
- 使用自有域名向 TikTok 提供链接。TikTok 只会从与持有令牌的应用已验证的 URL 前缀下载媒体,因此应通过 publish_tiktok_post 发布,由它从 easyCoexistence 已验证的地址提供您的文件。
- 对每个评论事件都进行回复,包括您自己的评论。您的公开回复会作为新评论返回,您的 Instagram 私信则以回声事件的形式返回,因此应跳过作者为账户本身的事件,否则机器人会自己回复自己。
- 按字符数衡量 Instagram 私信。上限为 1,000 字节的 UTF-8,因此包含表情符号或重音字母的文本会更快超出;发送前应按编码后的长度截断。
easyCoexistence 让您的 Python 代码和 AI 智能体能够通过各平台的官方 API 触达 WhatsApp、Instagram、Facebook、TikTok、YouTube、LinkedIn 等客户,并会持续增加更多渠道。Partner API 负责连接账户并分发新鲜令牌,MCP 服务器将同样的账户以工具形式提供给智能体,且每个连接全天候 24/7 受到监控。每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,前 3 天免费。
常见问题
我需要自己在 Meta、TikTok、Google 或 LinkedIn 上创建开发者应用吗?
不需要。账户通过 easyCoexistence 在各平台上的应用完成登录,凭证接口会为您的代码返回该账户在 TikTok、YouTube 和 LinkedIn 上的令牌,可直接用于调用平台 API。
需要哪个 Python 版本和哪些库?
Partner API 和各平台的 API 都是基于 JSON 的普通 HTTPS 接口,因此 requests、httpx 或其他任何 Python HTTP 客户端均可调用。TikTok 发布和智能体工具所使用的 MCP Python SDK(第 2 版)要求 Python 3.10 或更高版本。
哪些平台会将评论和私信发送到您的端点?
Instagram 和 Facebook 会转发评论、提及和私信,TikTok 会转发评论,且均以该渠道的密钥签名。YouTube 和 LinkedIn 不会发送此类事件,因此需按计划通过其 API 读取评论。
easyCoexistence 用于 Python 的费用是多少?
每个连接每月 US$ 9 起,连接越多越便宜,最低降至 US$ 0.75,且在所有平台上价格相同。Partner API 和 MCP 连接器均已包含在内,不按席位收费,前 3 天免费。
继续阅读
两分钟连接您的第一个渠道。
无需等待平台审核。连接 WhatsApp、Instagram、TikTok 或其他渠道,然后让您的 AI 发布、回复或生成报告,看它如何运作。
- 免费试用 3 天
- 随时取消
- 仅使用官方 API
- 全天候 24/7 监控
验证时间