用一個 API 從 Python 發布貼文至 Instagram、TikTok 與 Facebook
透過 easyCoexistence,Python 程式碼可經各平台的官方 API 發布至 Instagram、Facebook、TikTok、YouTube 與 LinkedIn。每個帳戶只需透過託管連結登入一次;之後腳本便以一次 GET 取得 TikTok、YouTube 或 LinkedIn 的最新存取權杖,而 Instagram 及 Facebook 的呼叫則經 easyCoexistence 的 MCP 工具進行,該工具會保管權杖。MCP 工具讓 Python 代理使用同一批帳戶。
透過 API 傳送的單則 Instagram 私訊最多長度,以 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_ 金鑰驗證身分。向 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 credsPython 如何發布至 Instagram 及 Facebook?
Instagram 透過 Meta 的 Graph API 分兩步發布,權杖以 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 及一個介於 10 分鐘至 30 天後的 scheduled_publish_time,Meta 便會在該時間發布,無需你的程式另行運行。兩者皆由 Meta 從公開網址下載媒體,而 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 URNPython 如何讀取及回覆留言與私訊?
先為該渠道開啟轉發,核實每一次送達的事件,再透過該網絡的 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 私訊須在對方最後一則訊息後 24 小時內,傳送至 /{ig-id}/messages,且最多 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)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 私訊則以回聲(echo)形式回傳,因此應略過作者為帳戶本身的事件,否則機械人會自我回覆。
- 以字元數量度量 Instagram 私訊。上限為 1,000 位元組的 UTF-8,因此含表情符號或帶重音字母的文字會更快超出限制;傳送前應按編碼後的長度修剪。
easyCoexistence 讓你的 Python 程式碼及 AI 代理接觸到 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 皆為以 JSON 格式運作的純 HTTPS,因此 requests、httpx 或任何其他 Python HTTP 客戶端都可呼叫。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 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。
- 免費試用 3 天
- 隨時取消
- 只用官方 API
- 24/7 監察
驗證日期