Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Siarkan ke Instagram, TikTok dan Facebook dari Python dengan satu API

Dengan easyCoexistence, kod Python menyiarkan ke Instagram, Facebook, TikTok, YouTube dan LinkedIn melalui API rasmi setiap rangkaian. Setiap akaun log masuk sekali melalui pautan hos, kemudian skrip anda mendapatkan token TikTok, YouTube atau LinkedIn yang baharu dengan satu GET, manakala panggilan Instagram dan Facebook melalui alat MCP easyCoexistence, yang memastikan token itu sentiasa sah. Alat MCP memberi ejen Python akaun yang sama.

1,000 bytes

Jumlah teks paling banyak yang boleh dibawa oleh satu DM Instagram melalui API, dikira dalam UTF-8, jadi emoji mengambil lebih ruang.

24 hours

Tempoh sah token akses TikTok API for Business; token segarnya kekal sah selama setahun.

1 hour

Tempoh sah token akses pengguna Google, jenis yang dibawa oleh setiap panggilan YouTube API.

OAuthClientProvider

Pengendali OAuth SDK Python MCP, yang mendaftarkan klien, menjalankan log masuk dengan PKCE dan memperbaharui token.

1 attempt

Peristiwa komen, sebutan dan DM yang dimajukan dihantar sekali sahaja dan tidak disimpan, jadi akui setiap satu dengan segera.

Bagaimana Python mendapat token untuk Instagram, Facebook, TikTok, YouTube atau LinkedIn?

Melalui sesi sambungan pada Partner API easyCoexistence, disahkan dengan kunci ec_live_ anda. POST /connect-sessions dengan channel ditetapkan kepada instagram, facebook, tiktok, youtube atau linkedin memulangkan pautan hos untuk satu pelanggan, sah selama sejam. Mereka log masuk dengan log masuk rangkaian itu sendiri dan dihalakan semula ke redirect_url anda dengan status=connected dan channel_id, yang backend anda sahkan dengan GET /connect-sessions/{session} dan bukannya mempercayai rentetan pertanyaan. Kod anda tidak perlukan aplikasi pemaju sendiri di Meta, TikTok, Google atau LinkedIn.

Kemudian minta bukti kelayakan pada permulaan setiap tugasan. GET /channels/{id}?credentials=1 memulangkan asas API rangkaian itu, id akaun pada rangkaian tersebut dan, bagi TikTok, YouTube dan LinkedIn, token akses yang sentiasa diperbaharui oleh easyCoexistence. Token TikTok sah selama 24 jam dan Google selama sejam, jadi dapatkannya setiap tugasan dan jangan simpan. Token Instagram dan Facebook tidak pernah diserahkan; panggilan mereka melalui alat 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

Bagaimana anda menyiarkan ke Instagram dan Facebook dari Python?

Instagram menerbitkan dalam dua langkah pada Graph API Meta, dengan token sebagai pengepala bearer. POST /{ig-id}/media dengan image_url dan caption mencipta bekas; apabila GET status_code-nya membaca FINISHED, POST /{ig-id}/media_publish dengan bekas sebagai creation_id meletakkannya pada profil. Meta mencadangkan semakan kira-kira setiap minit, sehingga lima minit. Reel mengikut langkah yang sama, dihantar dengan media_type REELS dan video_url dan bukannya imej.

Siaran Halaman Facebook ialah satu panggilan: POST /{page-id}/feed dengan message dan, jika mahu, link. Menambah published false dan scheduled_publish_time antara 10 minit dan 30 hari akan membuatkan Meta menerbitkannya pada masa itu, tanpa sebarang tugas anda yang berjalan. Meta memuat turun media daripada URL awam dalam kedua-dua kes, dan Instagram hanya menerima imej 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"]

Bagaimana anda memuat naik ke YouTube dan menyiarkan di LinkedIn dari Python?

YouTube menerima video sebagai muat naik boleh disambung semula. Permintaan pertama pergi ke endpoint muat naik dengan uploadType=resumable dan part=snippet,status dan membawa tajuk serta status dalam JSON; pengepala Location jawapannya ialah alamat sesi. PUT fail ke alamat itu menjawab 201 dengan video baharu. Menetapkan privacyStatus kepada private dengan masa publishAt membolehkan YouTube menerbitkan video dengan sendirinya pada masa itu, dan selfDeclaredMadeForKids mencatatkan sama ada ia dibuat untuk kanak-kanak.

LinkedIn menerima satu POST ke /rest/posts dengan token bearer, pengepala LinkedIn-Version dan X-Restli-Protocol-Version 2.0.0. Badan menamakan pengarang, membawa teks sebagai commentary dan menetapkan visibility, distribution dan lifecycleState. Kelayakan membekalkan author_urn, iaitu urn:li:organization bagi Halaman syarikat atau urn:li:person bagi profil, dan versi yang digunakan oleh easyCoexistence; URN siaran baharu dikembalikan dalam pengepala 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

Bagaimana membaca dan membalas komen dan DM dalam Python?

Hidupkan penghantaran untuk saluran itu, sahkan setiap penghantaran, kemudian balas melalui API rangkaian. PUT /channels/{id}/webhook dengan url memulangkan signing_secret, yang hanya ditunjukkan sekali. Komen, sebutan dan DM pada Instagram dan Facebook, serta komen pada TikTok, kemudian tiba sebagai POST platform, account_id, external_id dan entry, dengan entry tepat seperti yang dihantar oleh rangkaian. Pengepala X-EC-Signature berbunyi t=<unix>,v1=<hex>, dan v1 ialah HMAC-SHA256 bagi cap masa, titik dan badan mentah. Setiap peristiwa dihantar sekali, tanpa salinan disimpan dan tanpa cubaan semula, jadi akui dahulu dan proses daripada barisan gilir.

Balasan kepada DM Instagram pergi ke /{ig-id}/messages dalam tempoh 24 jam selepas mesej terakhir orang itu, sehingga 1,000 bait. Komen mendapat balasan awam di /{comment-id}/replies, atau satu balasan persendirian dalam tempoh 7 hari. Balasan komen TikTok dibuat awam melalui business/comment/reply/create/, kerana TikTok tiada DM, dan komen YouTube serta LinkedIn dibaca melalui API mereka mengikut jadual.

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)

Bagaimana menyiarkan ke TikTok dari Python?

Melalui alat MCP publish_tiktok_post easyCoexistence. API for Business TikTok menerima video sebagai video_url dan, sejak 16 November 2023, hanya memuat turun daripada domain atau awalan URL yang disahkan untuk aplikasi pemaju di sebalik token, iaitu milik easyCoexistence. Alat ini menerima pautan HTTPS anda dan menyerahkan kepada TikTok alamat bertanda tangan pada laluan media easyCoexistence yang disahkan, dengan men-strim fail tanpa menyimpannya. Siaran foto menerima image_urls sebagai ganti, 1 hingga 35 fail JPEG atau WebP, dan get_tiktok_publish_status menjejaki siaran semasa TikTok memprosesnya.

Daripada Python, ia adalah satu panggilan melalui SDK MCP rasmi, versi 2, pada Python 3.10 atau lebih baharu. Pelayan di https://easycoexistence.com/api/mcp hanya menerima OAuth 2.1, jadi OAuthClientProvider SDK mendaftarkan klien anda, menjalankan satu log masuk penyemak imbas dengan PKCE dan memperbaharui token. Token akses sah selama sejam dan token segar selama 60 hari; setiap penyegaran mengeluarkan pasangan baharu, dan storan yang menyimpannya mengekalkan log masuk backend.

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())

Bagaimana ejen AI Python menggunakan akaun ini?

Melalui sesi MCP yang sama. Pelayan menyenaraikan alat bagi rangkaian dalam akaun anda, dan mana-mana rangka kerja ejen yang menerima alat MCP boleh menyerahkannya kepada modelnya: menerbitkan pada setiap rangkaian, menyenaraikan siaran, membaca komen dan membalasnya, membalas DM pada Instagram dan Facebook, menetapkan peraturan komen-ke-DM serta membaca wawasan dan analitik. Arahan pelayan dan perihalan setiap alat membawa peraturan rangkaian itu, jadi model tahu bahawa balasan TikTok bersifat awam dan imej Instagram mesti JPEG.

Mulakan ejen dengan list_social_accounts, kerana setiap alat sosial lain mengambil account_id daripadanya, dan id itu ialah id saluran yang sama yang dipulangkan oleh Partner API. Balasan yang mesti dihantar pada jam 3 pagi tanpa ejen berjalan adalah milik peraturan dan automasi komen, yang berjalan pada easyCoexistence sendiri.

Kesilapan biasa

  • Menyimpan token dalam fail konfigurasi. Token TikTok tamat tempoh dalam masa sehari dan token Google dalam masa sejam, dan easyCoexistence memperbaharuinya di belakang tabir, jadi panggil endpoint kelayakan pada permulaan setiap tugasan.
  • Memberi TikTok pautan pada domain anda sendiri. TikTok memuat turun media hanya daripada awalan URL yang disahkan untuk aplikasi yang memegang token, jadi terbitkan melalui publish_tiktok_post, yang menghidangkan fail anda daripada alamat disahkan easyCoexistence.
  • Membalas setiap peristiwa komen, termasuk komen anda sendiri. Balasan awam anda kembali sebagai komen baharu dan DM Instagram anda sebagai gema, jadi langkau peristiwa yang pengarangnya ialah akaun itu sendiri, atau bot akan membalas dirinya sendiri.
  • Mengukur DM Instagram dengan aksara. Had ialah 1,000 bait UTF-8, jadi teks dengan emoji atau huruf beraksen habis lebih cepat; potong mengikut panjang yang dikodkan sebelum menghantar.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberi kod Python dan ejen AI anda jangkauan kepada pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, melalui API rasmi setiap rangkaian. Partner API menyambungkan akaun dan mengeluarkan token baharu, pelayan MCP memberi ejen akaun yang sama sebagai alat, dan setiap sambungan dipantau 24/7. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah saya perlukan aplikasi pemaju Meta, TikTok, Google atau LinkedIn sendiri?

Tidak. Akaun log masuk melalui aplikasi easyCoexistence sendiri di setiap rangkaian, dan panggilan kelayakan memberi kod anda token akaun itu bagi TikTok, YouTube dan LinkedIn, sedia untuk digunakan terhadap API rangkaian.

Versi Python dan pustaka apa yang saya perlukan?

Partner API dan API rangkaian ialah HTTPS biasa dengan JSON, jadi requests, httpx atau mana-mana klien HTTP Python lain boleh memanggilnya. SDK MCP Python, versi 2, yang digunakan oleh penerbitan TikTok dan alat ejen, memerlukan Python 3.10 atau lebih baharu.

Rangkaian mana yang menghantar komen dan DM ke endpoint saya?

Instagram dan Facebook memajukan komen, sebutan dan DM, dan TikTok memajukan komen, setiap satu ditandatangani dengan rahsia saluran. YouTube dan LinkedIn tidak menghantar peristiwa sedemikian, jadi baca komen mereka melalui API masing-masing mengikut jadual.

Berapakah kos easyCoexistence untuk Python?

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dan sama pada setiap rangkaian. Partner API dan penyambung MCP disertakan, tanpa tempat duduk, dan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada