登入開始免費試用
easyCoexistence 官方 API

用一個 API 從 Python 發布貼文至 Instagram、TikTok 與 Facebook

透過 easyCoexistence,Python 程式碼可經各平台的官方 API 發布至 Instagram、Facebook、TikTok、YouTube 與 LinkedIn。每個帳戶只需透過託管連結登入一次;之後腳本便以一次 GET 取得 TikTok、YouTube 或 LinkedIn 的最新存取權杖,而 Instagram 及 Facebook 的呼叫則經 easyCoexistence 的 MCP 工具進行,該工具會保管權杖。MCP 工具讓 Python 代理使用同一批帳戶。

1,000 bytes

透過 API 傳送的單則 Instagram 私訊最多長度,以 UTF-8 計算,因此表情符號佔用的空間較多。

24 hours

TikTok API for Business 存取權杖的有效時長;其更新權杖有效一年。

1 hour

Google 使用者存取權杖的有效時長。每個 YouTube API 呼叫都會攜帶此權杖。

OAuthClientProvider

MCP Python SDK 的 OAuth 處理程式,負責註冊客戶端、以 PKCE 執行登入並更新權杖。

1 attempt

轉發的留言、提及及私訊事件僅會送達一次,且不會儲存,因此須立即確認收到每一則事件。

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 工具進行。

Connect an account, then fetch its credentials per job
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 標頭傳送。向 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 圖片。

Publish a photo on Instagram and schedule a Page post
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 標頭中回傳。

Schedule a YouTube upload and publish a LinkedIn post
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 私訊須在對方最後一則訊息後 24 小時內,傳送至 /{ig-id}/messages,且最多 1,000 位元組。留言可於 /{comment-id}/replies 作公開回覆,或在 7 天內作一次私人回覆。TikTok 留言的公開回覆透過 business/comment/reply/create/ 進行,因為 TikTok 沒有私訊功能;YouTube 與 LinkedIn 的留言則需按排程透過其 API 讀取。

Verify forwarded events and reply to Instagram DMs and comments
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 天,每次更新都會發出一組新權杖;能保存這些權杖的儲存方式,可讓後端保持登入狀態。

Publish a TikTok video through the MCP server
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 完成這項設定

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 監察

驗證日期