Publică pe Instagram, TikTok și Facebook din Python cu un singur API
Cu easyCoexistence, codul Python publică pe Instagram, Facebook, TikTok, YouTube și LinkedIn prin API-ul oficial al fiecărei rețele. Fiecare cont se conectează o singură dată printr-un link găzduit; scriptul dumneavoastră obține apoi un token proaspăt pentru TikTok, YouTube sau LinkedIn cu un singur GET, în timp ce apelurile Instagram și Facebook trec prin uneltele MCP ale easyCoexistence, care păstrează token-ul. Serverul MCP oferă unui agent Python aceleași conturi.
Cel mai mare text pe care îl poate transporta un DM de Instagram prin API, numărat în UTF-8, deci emoji ocupă mai mult spațiu.
Cât timp rămâne valabil un token de acces TikTok API for Business; token-ul de reîmprospătare rămâne valabil un an.
Cât timp rămâne valabil un token de acces de utilizator Google, tipul pe care îl trimite fiecare apel către YouTube API.
Componenta OAuth din MCP Python SDK, care înregistrează clientul, rulează autentificarea cu PKCE și reînnoiește token-urile.
Evenimentele redirecționate de comentarii, mențiuni și DM-uri sunt livrate o singură dată și nu sunt stocate, deci confirmați fiecare imediat.
Cum obține Python un token pentru Instagram, Facebook, TikTok, YouTube sau LinkedIn?
Printr-o sesiune de conectare pe Partner API-ul easyCoexistence, autentificată cu cheia ec_live_ a dumneavoastră. POST /connect-sessions cu channel setat la instagram, facebook, tiktok, youtube sau linkedin returnează un link găzduit pentru un singur client, valabil o oră. Clientul se autentifică prin propriul login al rețelei și ajunge la redirect_url cu status=connected și un channel_id, pe care backend-ul dumneavoastră îl confirmă cu GET /connect-sessions/{session}, în loc să se bazeze pe query string. Codul dumneavoastră nu are nevoie de o aplicație de dezvoltator proprie la Meta, TikTok, Google sau LinkedIn.
Apoi cereți credențialele la începutul fiecărui job. GET /channels/{id}?credentials=1 returnează baza API a rețelei, id-ul contului pe acea rețea și, pentru TikTok, YouTube și LinkedIn, un token de acces pe care easyCoexistence îl menține reînnoit. Token-ul TikTok rămâne valabil 24 de ore, cel Google o oră, așa că luați-l pentru fiecare job, în loc să-l salvați. Token-urile Instagram și Facebook nu sunt niciodată furnizate; apelurile lor trec prin uneltele 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 credsCum publicați pe Instagram și Facebook din Python?
Instagram publică în doi pași, prin Graph API-ul Meta, cu token-ul trimis ca antet bearer. POST /{ig-id}/media cu image_url și caption creează un container; după ce un GET al status_code-ului arată FINISHED, POST /{ig-id}/media_publish cu containerul ca creation_id îl trimite pe profil. Meta recomandă verificarea aproximativ o dată pe minut, timp de până la cinci minute. Un Reel urmează aceiași pași, trimis cu media_type REELS și cu un video_url în loc de imagine.
O postare pe pagina de Facebook este un singur apel: POST /{page-id}/feed cu message și, dacă doriți, un link. Adăugând published false și un scheduled_publish_time între 10 minute și 30 de zile în viitor, Meta o publică în acel moment, fără ca vreun job al dumneavoastră să ruleze. Meta descarcă media de la un URL public în ambele cazuri, iar Instagram acceptă doar imagini 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"]Cum încărcați pe YouTube și postați pe LinkedIn din Python?
YouTube primește videoclipul ca upload reluabil. Prima cerere merge la endpoint-ul de upload cu uploadType=resumable și part=snippet,status și transportă titlul și statusul ca JSON; antetul Location al răspunsului este adresa sesiunii. Un PUT al fișierului la acea adresă răspunde 201 cu noul videoclip. Dacă setați privacyStatus la private cu un timp publishAt, YouTube publică singur videoclipul în acel moment, iar selfDeclaredMadeForKids înregistrează dacă acesta este destinat copiilor.
LinkedIn primește un singur POST la /rest/posts cu token-ul bearer, antetul LinkedIn-Version și X-Restli-Protocol-Version 2.0.0. Corpul numește autorul, conține textul ca commentary și setează visibility, distribution și lifecycleState. Credențialele furnizează author_urn, un urn:li:organization pentru o pagină de companie sau un urn:li:person pentru un profil, precum și versiunea folosită de easyCoexistence; URN-ul noii postări vine înapoi în antetul 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 URNCum citiți și răspundeți la comentarii și DM-uri în Python?
Activați redirecționarea pentru canal, verificați fiecare livrare, apoi răspundeți prin API-ul rețelei. PUT /channels/{id}/webhook cu url returnează un signing_secret, afișat o singură dată. Comentariile, mențiunile și DM-urile de pe Instagram și Facebook, precum și comentariile de pe TikTok, sosesc apoi ca POST cu platform, account_id, external_id și entry, entry fiind exact cum l-a trimis rețeaua. Antetul X-EC-Signature are forma t=<unix>,v1=<hex>, iar v1 este un HMAC-SHA256 al timestamp-ului, al unui punct și al corpului brut. Fiecare eveniment este trimis o singură dată, fără copie păstrată și fără reîncercare, așa că confirmați mai întâi și lucrați dintr-o coadă.
Un răspuns la un DM de Instagram merge la /{ig-id}/messages în cel mult 24 de ore de la ultimul mesaj al persoanei, în cel mult 1.000 de octeți. Un comentariu primește un răspuns public la /{comment-id}/replies sau un singur răspuns privat în termen de 7 zile. Comentariile de pe TikTok primesc răspunsuri publice prin business/comment/reply/create/, pentru că pe TikTok nu există DM-uri, iar comentariile de pe YouTube și LinkedIn se citesc periodic prin API-urile lor.
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)Cum publicați pe TikTok din Python?
Prin instrumentul MCP publish_tiktok_post al easyCoexistence. API-ul TikTok for Business primește un videoclip ca video_url și, din 16 noiembrie 2023, îl descarcă doar de pe un domeniu sau prefix de URL verificat pentru aplicația de dezvoltator din spatele token-ului, care este cea a easyCoexistence. Instrumentul primește linkul dumneavoastră HTTPS și îi dă TikTok o adresă semnată pe ruta media verificată a easyCoexistence, transmițând fișierul fără să-l stocheze. Postările cu fotografii primesc în schimb image_urls, între 1 și 35 de fișiere JPEG sau WebP, iar get_tiktok_publish_status urmărește postarea cât timp TikTok o procesează.
Din Python, este un singur apel prin SDK-ul MCP oficial, versiunea 2, pe Python 3.10 sau mai nou. Serverul de la https://easycoexistence.com/api/mcp acceptă doar OAuth 2.1, deci OAuthClientProvider din SDK înregistrează clientul dumneavoastră, rulează o singură autentificare în browser cu PKCE și reînnoiește token-urile. Token-urile de acces rămân valabile o oră, iar cele de reîmprospătare 60 de zile; fiecare reînnoire emite o pereche nouă, iar un stocaj care le păstrează menține un backend autentificat.
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())Cum folosește un agent AI din Python aceste conturi?
Prin aceeași sesiune MCP. Serverul listează instrumentele pentru rețelele din contul dumneavoastră, iar orice framework de agenți care acceptă instrumente MCP le poate transmite modelului său: publicare pe fiecare rețea, listarea postărilor, citirea comentariilor și răspunsul la ele, răspunsul la DM-uri pe Instagram și Facebook, setarea regulilor de la comentariu la DM și citirea statisticilor și analizelor. Instrucțiunile serverului și descrierea fiecărui instrument transmit regulile rețelei, astfel încât modelul află că răspunsurile pe TikTok sunt publice și că imaginile Instagram trebuie să fie JPEG.
Porniți agentul cu list_social_accounts, deoarece toate celelalte instrumente sociale primesc un account_id de aici, iar acel id este același channel id returnat de Partner API. Răspunsurile care trebuie trimise la 3 dimineața, fără ca vreun agent să ruleze, țin de regulile de comentarii și de automatizări, care rulează pe easyCoexistence însăși.
Greșeli frecvente
- Salvarea token-ului într-un fișier de configurare. Token-ul TikTok expiră în decurs de 24 de ore, iar cel Google în decurs de o oră, iar easyCoexistence le reînnoiește în fundal, așa că apelați endpoint-ul de credențiale la începutul fiecărui job.
- Oferirea unui link de pe propriul domeniu către TikTok. TikTok descarcă media doar de la prefixele de URL verificate pentru aplicația care deține token-ul, așa că publicați prin publish_tiktok_post, care servește fișierul dumneavoastră de la adresa verificată a easyCoexistence.
- Răspunsul la fiecare eveniment de comentariu, inclusiv la cele proprii. Răspunsurile publice ale dumneavoastră revin ca noi comentarii, iar DM-urile de Instagram ca ecouri, așa că ignorați evenimentele al căror autor este chiar contul, altfel botul ajunge să-și răspundă singur.
- Măsurarea unui DM de Instagram în caractere. Limita este de 1.000 de octeți UTF-8, deci textul cu emoji sau litere cu diacritice se epuizează mai repede; tăiați textul după lungimea codificată înainte de trimitere.
easyCoexistence oferă codului dumneavoastră Python și agenților AI acces la clienți pe WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale, prin API-ul oficial al fiecărei rețele. Partner API conectează conturile și distribuie token-uri proaspete, serverul MCP oferă agenților aceleași conturi ca instrumente, iar fiecare conexiune este monitorizată 24/7. De la US$ 9 la US$ 0.75 pe conexiune pe lună, prețul scăzând pe măsură ce adăugați conexiuni, iar primele 3 zile sunt gratuite.
Întrebări frecvente
Am nevoie de propria aplicație de dezvoltator la Meta, TikTok, Google sau LinkedIn?
Nu. Conturile se conectează prin aplicația proprie a easyCoexistence de pe fiecare rețea, iar apelul de credențiale oferă codului dumneavoastră token-ul contului pe TikTok, YouTube și LinkedIn, gata de folosit în API-ul rețelei.
Ce versiune de Python și ce biblioteci am nevoie?
Partner API și API-urile rețelelor sunt HTTPS simplu cu JSON, deci requests, httpx sau orice alt client HTTP pentru Python le poate apela. MCP Python SDK, versiunea 2, folosit de publicarea pe TikTok și de instrumentele agenților, necesită Python 3.10 sau mai nou.
Ce rețele trimit comentarii și DM-uri către endpoint-ul meu?
Instagram și Facebook redirecționează comentariile, mențiunile și DM-urile, iar TikTok redirecționează comentariile, fiecare semnat cu secretul canalului. YouTube și LinkedIn nu trimit astfel de evenimente, așa că citiți comentariile lor prin API-urile acestora, periodic.
Cât costă easyCoexistence pentru Python?
De la US$ 9 la US$ 0.75 pe conexiune pe lună, prețul scăzând pe măsură ce adăugați conexiuni, același pe fiecare rețea. Partner API și conectorul MCP sunt incluse, fără taxe pe utilizator, iar primele 3 zile sunt gratuite.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la