Unggah ke Instagram, TikTok dan Facebook dari Python dengan satu API
Dengan easyCoexistence, kode Python memublikasikan unggahan ke Instagram, Facebook, TikTok, YouTube dan LinkedIn lewat API resmi tiap jaringan. Setiap akun masuk sekali lewat tautan yang dihosting; lalu skrip Anda mengambil token baru untuk TikTok, YouTube atau LinkedIn dengan satu GET, sementara panggilan Instagram dan Facebook melewati tool MCP easyCoexistence, yang menjaga token tersebut. Tool MCP memberi agen Python akun yang sama.
Jumlah teks terbanyak yang bisa dibawa satu DM Instagram lewat API, dihitung dalam UTF-8, sehingga emoji memakan ruang lebih banyak.
Berapa lama token akses TikTok API for Business berlaku; refresh token-nya tetap valid selama setahun.
Berapa lama token akses pengguna Google berlaku, jenis yang dibawa setiap panggilan YouTube API.
Handler OAuth dari MCP Python SDK, yang mendaftarkan klien, menjalankan proses masuk dengan PKCE dan memperbarui token.
Event komentar, mention dan DM yang diteruskan dikirim sekali dan tidak pernah disimpan, jadi akui setiap event segera.
Bagaimana Python mendapatkan token untuk Instagram, Facebook, TikTok, YouTube atau LinkedIn?
Lewat sesi koneksi di Partner API easyCoexistence, diautentikasi dengan kunci ec_live_ Anda. POST /connect-sessions dengan channel diisi instagram, facebook, tiktok, youtube atau linkedin mengembalikan tautan yang dihosting untuk satu pelanggan, berlaku selama satu jam. Mereka masuk dengan login jaringan itu sendiri dan mendarat di redirect_url Anda dengan status=connected dan channel_id, yang dikonfirmasi backend Anda dengan GET /connect-sessions/{session}, bukan dengan mempercayai query string. Kode Anda tidak pernah membutuhkan aplikasi developer sendiri di Meta, TikTok, Google atau LinkedIn.
Lalu minta kredensial di awal setiap pekerjaan. GET /channels/{id}?credentials=1 mengembalikan base API jaringan, id akun di jaringan itu dan, untuk TikTok, YouTube dan LinkedIn, token akses yang dijaga tetap diperbarui oleh easyCoexistence. Token TikTok berlaku 24 jam dan Google 1 jam, jadi ambil per pekerjaan alih-alih menyimpannya. Token Instagram dan Facebook tidak pernah diberikan; panggilannya lewat tool 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 credsBagaimana cara memposting ke Instagram dan Facebook dari Python?
Instagram memublikasikan dalam dua langkah di Graph API Meta, dengan token sebagai header bearer. POST /{ig-id}/media dengan image_url dan caption membuat container; setelah GET status_code-nya menunjukkan FINISHED, POST /{ig-id}/media_publish dengan container sebagai creation_id menaruhnya di profil. Meta menyarankan pengecekan kira-kira setiap menit, selama maksimal lima menit. Reel mengikuti langkah yang sama, dikirim dengan media_type REELS dan video_url alih-alih gambar.
Unggahan Halaman Facebook hanya satu panggilan: POST /{page-id}/feed dengan message dan, jika diinginkan, link. Menambahkan published false dan scheduled_publish_time antara 10 menit dan 30 hari ke depan membuat Meta memublikasikannya pada waktu itu, tanpa tugas Anda yang berjalan. Meta mengunduh media dari URL publik pada kedua kasus, dan Instagram hanya menerima gambar 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"]Bagaimana cara mengunggah ke YouTube dan memposting di LinkedIn dari Python?
YouTube menerima video sebagai unggahan yang dapat dilanjutkan. Permintaan pertama dikirim ke endpoint unggah dengan uploadType=resumable dan part=snippet,status, dan membawa judul serta status sebagai JSON; header Location dari jawabannya adalah alamat sesi. PUT file ke alamat itu menjawab 201 dengan video baru. Mengatur privacyStatus ke private dengan waktu publishAt membuat YouTube memublikasikan video dengan sendirinya pada waktu tersebut, dan selfDeclaredMadeForKids mencatat apakah video itu dibuat untuk anak-anak.
LinkedIn menerima satu POST ke /rest/posts dengan token bearer, header LinkedIn-Version dan X-Restli-Protocol-Version 2.0.0. Body menyebut author, membawa teks sebagai commentary dan mengatur visibility, distribution dan lifecycleState. Kredensial menyediakan author_urn, berupa urn:li:organization untuk Halaman perusahaan atau urn:li:person untuk profil, serta versi yang dipakai easyCoexistence; URN unggahan baru kembali di header 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 URNBagaimana cara membaca dan membalas komentar serta DM dengan Python?
Aktifkan penerusan untuk saluran, verifikasi setiap pengiriman, lalu balas lewat API jaringan. PUT /channels/{id}/webhook dengan url mengembalikan signing_secret, yang hanya ditampilkan sekali. Komentar, mention dan DM di Instagram dan Facebook, serta komentar di TikTok, kemudian tiba sebagai POST berisi platform, account_id, external_id dan entry, dengan entry persis seperti yang dikirim jaringan. Header X-EC-Signature berbunyi t=<unix>,v1=<hex>, dan v1 adalah HMAC-SHA256 dari timestamp, titik dan body mentah. Setiap event dikirim sekali, tanpa salinan yang disimpan dan tanpa mencoba kembali, jadi akui dulu lalu proses dari antrean.
Balasan untuk DM Instagram dikirim ke /{ig-id}/messages dalam 24 jam sejak pesan terakhir orang tersebut, maksimal 1,000 byte. Komentar mendapat balasan publik di /{comment-id}/replies, atau satu balasan privat dalam 7 hari. Komentar TikTok mendapat balasan publik lewat business/comment/reply/create/, karena TikTok tidak punya DM, dan komentar YouTube serta LinkedIn dibaca lewat API mereka sesuai jadwal.
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 cara memposting ke TikTok dari Python?
Lewat tool MCP easyCoexistence publish_tiktok_post. API for Business TikTok menerima video sebagai video_url dan, sejak 16 November 2023, hanya mengunduhnya dari domain atau awalan URL yang diverifikasi untuk aplikasi developer di balik token, yaitu milik easyCoexistence. Tool ini menerima tautan HTTPS Anda dan memberikan TikTok alamat yang ditandatangani pada rute media terverifikasi easyCoexistence, dengan mengalirkan file tanpa menyimpannya. Unggahan foto menggunakan image_urls, 1 sampai 35 file JPEG atau WebP, dan get_tiktok_publish_status mengikuti unggahan selama TikTok memprosesnya.
Dari Python, ini satu panggilan lewat MCP SDK resmi, versi 2, dengan Python 3.10 atau lebih baru. Server di https://easycoexistence.com/api/mcp hanya menerima OAuth 2.1, jadi OAuthClientProvider dari SDK mendaftarkan klien Anda, menjalankan satu proses masuk di browser dengan PKCE dan memperbarui token. Token akses berlaku satu jam dan refresh token 60 hari, setiap pembaruan menerbitkan pasangan baru, dan penyimpanan yang menyimpan keduanya membuat backend tetap masuk.
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 agen AI Python memakai akun-akun ini?
Lewat sesi MCP yang sama. Server mendaftar tool untuk jaringan di akun Anda, dan framework agen apa pun yang menerima tool MCP dapat menyerahkannya ke modelnya: memublikasikan di tiap jaringan, mendaftar unggahan, membaca dan membalas komentar, membalas DM di Instagram dan Facebook, mengatur aturan komentar-ke-DM serta membaca insight dan analitik. Instruksi server dan deskripsi tiap tool memuat aturan jaringan, sehingga model memahami bahwa balasan TikTok bersifat publik dan gambar Instagram harus JPEG.
Mulai agen dengan list_social_accounts, sebab setiap tool sosial lain membutuhkan account_id darinya, dan id itu sama dengan channel id yang dikembalikan Partner API. Balasan yang harus terkirim pukul 3 pagi tanpa agen yang berjalan termasuk aturan komentar dan otomatisasi, yang berjalan di easyCoexistence sendiri.
Kesalahan umum
- Menyimpan token di file konfigurasi. Token TikTok kedaluwarsa dalam sehari dan token Google dalam satu jam, dan easyCoexistence memperbaruinya di balik layar, jadi panggil endpoint kredensial di awal setiap pekerjaan.
- Memberi TikTok tautan dari domain Anda sendiri. TikTok hanya mengunduh media dari awalan URL yang diverifikasi untuk aplikasi pemegang token, jadi publikasikan lewat publish_tiktok_post, yang menyajikan file Anda dari alamat terverifikasi easyCoexistence.
- Membalas setiap event komentar, termasuk komentar Anda sendiri. Balasan publik Anda kembali sebagai komentar baru dan DM Instagram Anda sebagai echo, jadi lewati event yang penulisnya adalah akun itu sendiri, atau bot membalas dirinya sendiri.
- Mengukur DM Instagram dengan karakter. Batasnya 1,000 byte UTF-8, sehingga teks dengan emoji atau huruf beraksen habis lebih cepat; potong berdasarkan panjang terkodekan sebelum mengirim.
easyCoexistence memberi kode Python dan agen AI Anda akses ke pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, lewat API resmi tiap jaringan. Partner API menghubungkan akun dan memberikan token baru, server MCP memberi agen akun yang sama sebagai tool, dan setiap koneksi dipantau 24/7. US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.
Pertanyaan yang sering diajukan
Apakah saya perlu aplikasi developer Meta, TikTok, Google atau LinkedIn sendiri?
Tidak. Akun masuk lewat aplikasi easyCoexistence sendiri di tiap jaringan, dan panggilan kredensial memberikan kode Anda token akun itu pada TikTok, YouTube dan LinkedIn, siap dipakai terhadap API jaringan.
Versi Python dan library apa yang saya butuhkan?
Partner API dan API jaringan adalah HTTPS biasa dengan JSON, sehingga requests, httpx atau klien HTTP Python lain dapat memanggilnya. MCP Python SDK versi 2, yang dipakai publikasi TikTok dan tool agen, membutuhkan Python 3.10 atau lebih baru.
Jaringan mana yang mengirim komentar dan DM ke endpoint saya?
Instagram dan Facebook meneruskan komentar, mention dan DM, dan TikTok meneruskan komentar, masing-masing ditandatangani dengan secret saluran. YouTube dan LinkedIn tidak mengirim event semacam itu, jadi baca komentar mereka lewat API sesuai jadwal.
Berapa biaya easyCoexistence untuk Python?
US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dan sama di setiap jaringan. Partner API dan konektor MCP termasuk, tanpa kursi, dan 3 hari pertama gratis.
Lanjut membaca
Hubungkan saluran pertama Anda dalam dua menit.
Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.
- Gratis 3 hari
- Batalkan kapan saja
- Hanya API resmi
- Dipantau 24/7
Diverifikasi pada