النشر على Instagram وTikTok وFacebook من Python عبر واجهة برمجة تطبيقات واحدة (API)
مع easyCoexistence، ينشر كود Python على Instagram وFacebook وTikTok وYouTube وLinkedIn عبر واجهة كل شبكة الرسمية. يسجّل كل حساب الدخول مرة واحدة عبر رابط مستضاف، ثم يجلب السكربت رمز الوصول (token) جديدًا من TikTok أو YouTube أو LinkedIn بطلب GET واحد، بينما تمر استدعاءات Instagram وFacebook عبر أدوات MCP في easyCoexistence، التي تحتفظ بالرمز. تمنح أدوات MCP وكيل Python الحسابات نفسها.
أقصى نص تحمله رسالة مباشرة واحدة على Instagram عبر API، محسوبًا بترميز UTF-8، فتأخذ الرموز التعبيرية حيزًا أكبر.
مدة صلاحية رمز وصول TikTok API for Business؛ ويبقى رمز التحديث صالحًا لمدة سنة.
مدة صلاحية رمز وصول مستخدم Google، وهو النوع الذي تحمله كل استدعاءات YouTube API.
معالج OAuth في MCP Python SDK، الذي يسجّل العميل، ويشغّل تسجيل الدخول بـ PKCE، ويجدد الرموز.
أحداث التعليقات والإشارات والرسائل المباشرة المُعاد توجيهها تُسلَّم مرة واحدة ولا تُخزَّن، لذا أقرّ بكل حدث فورًا.
كيف يحصل Python على رمز وصول لـ Instagram أو Facebook أو TikTok أو YouTube أو LinkedIn؟
عبر جلسة ربط في Partner API الخاصة بـ easyCoexistence، مع المصادقة بمفتاحك 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 الخاص بالشبكة، ومعرّف الحساب فيها، وعلى 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 credsكيف تنشر على Instagram وFacebook من Python؟
ينشر Instagram على مرحلتين عبر Graph API من Meta، مع الرمز في ترويسة Bearer. يُنشئ الطلب POST /{ig-id}/media مع image_url وcaption حاوية؛ وبعد أن يقرأ GET لحالتها status_code القيمة FINISHED، يضع الطلب POST /{ig-id}/media_publish مع creation_id الحاوية على الملف الشخصي. تنصح Meta بالفحص نحو مرة كل دقيقة، لمدة تصل إلى خمس دقائق. تتبع الريل الخطوات نفسها، مع media_type بقيمة REELS وvideo_url بدلًا من الصورة.
منشور صفحة Facebook طلب واحد: POST /{page-id}/feed مع message، ورابطًا اختياريًا عبر link. وإضافة published بالقيمة false مع scheduled_publish_time بين 10 دقائق و30 يومًا قادمة تجعل 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"]كيف ترفع إلى YouTube وتنشر على LinkedIn من Python؟
يُرفع الفيديو على YouTube كرفع قابل للاستئناف. يذهب الطلب الأول إلى نقطة الرفع مع uploadType=resumable وpart=snippet,status، ويحمل العنوان والحالة بصيغة JSON، وترويسة Location في الرد هي عنوان الجلسة. يُرسل الملف بطلب PUT إلى ذلك العنوان، فيجيب برمز الحالة 201 مع الفيديو الجديد. ضبط privacyStatus على private مع وقت publishAt يجعل YouTube ينشر الفيديو بنفسه في تلك اللحظة، ويسجّل selfDeclaredMadeForKids إن كان الفيديو موجّهًا للأطفال.
ينشر LinkedIn بطلب POST واحد إلى /rest/posts مع رمز 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 URNكيف تقرأ التعليقات والرسائل المباشرة وترد عليها من Python؟
فعّل إعادة التوجيه للقناة، وتحقق من كل تسليم، ثم ردّ عبر واجهة الشبكة. يعيد الطلب 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 المباشرة إلى /{ig-id}/messages خلال 24 ساعة من آخر رسالة للشخص، بحد أقصى 1,000 بايت. يحصل التعليق على رد عام عبر /{comment-id}/replies، أو على رد خاص واحد خلال 7 أيام. تُرد تعليقات TikTok علنًا عبر business/comment/reply/create/، لأنه لا توجد رسائل مباشرة على TikTok، وتُقرأ تعليقات YouTube وLinkedIn عبر واجهاتهما وفق جدول زمني.
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)كيف تنشر على TikTok من Python؟
عبر أداة MCP الخاصة بـ easyCoexistence، publish_tiktok_post. تأخذ TikTok API for Business الفيديو عبر video_url، ومنذ 16 نوفمبر 2023 تنزّله فقط من نطاق أو بادئة عنوان مُتحقَّق منها لتطبيق المطوّر الذي يقف خلف الرمز، وهو تطبيق easyCoexistence. تقبل الأداة رابط 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 فقط، لذا يسجّل OAuthClientProvider في SDK عميلك، ويشغّل تسجيل دخول واحدًا عبر المتصفح بـ 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 الذكي هذه الحسابات؟
عبر جلسة MCP نفسها. يسرد الخادم الأدوات الخاصة بالشبكات في حسابك، ويمكن لأي إطار عمل وكلاء يقبل أدوات MCP أن يمررها لنموذجه: النشر على كل شبكة، وعرض المنشورات، وقراءة التعليقات والرد عليها، والرد على الرسائل المباشرة على Instagram وFacebook، وضبط قواعد التحويل من تعليق إلى رسالة مباشرة، وقراءة الإحصاءات والتحليلات. تحمل تعليمات الخادم ووصف كل أداة قواعد الشبكة، فيتعلّم النموذج أن ردود TikTok علنية، وأن صور Instagram يجب أن تكون JPEG.
ابدأ الوكيل بـ list_social_accounts، لأن كل أداة اجتماعية أخرى تأخذ account_id منها، وهذا المعرف هو نفسه channel id الذي تعيده Partner API. أما الردود التي يجب أن تخرج في الساعة 3 فجرًا دون أن يعمل وكيل، فتنتمي إلى قواعد التعليقات والأتمتة، التي تعمل على easyCoexistence نفسه.
الأخطاء الشائعة
- حفظ الرمز في ملف إعدادات. تنتهي صلاحية رمز TikTok خلال يوم، ورمز Google خلال ساعة، ويجدّدها easyCoexistence في الخلفية، لذا استدعِ نقطة بيانات الاعتماد في بداية كل مهمة.
- إعطاء TikTok رابطًا من نطاقك الخاص. لا ينزّل TikTok الوسائط إلا من بادئات عناوين مُتحقَّق منها للتطبيق الذي يحمل الرمز، لذا انشر عبر publish_tiktok_post، فتُقدَّم ملفك من عنوان easyCoexistence المُتحقَّق.
- الرد على كل حدث تعليق، بما فيه تعليقاتك أنت. تعود ردودك العلنية كتعليقات جديدة، وتعود رسائلك المباشرة على Instagram كأصداء، فتجاهل الأحداث التي يكون مؤلفها الحساب نفسه، وإلا رد البوت على نفسه.
- قياس رسالة Instagram المباشرة بالحروف. الحد 1,000 بايت بترميز UTF-8، فيستهلك النص الذي يحوي رموزًا تعبيرية أو حروفًا مُعلَّمة المساحة أسرع؛ اقتطعه بحسب الطول المرمّز قبل الإرسال.
يمنح easyCoexistence كود Python الخاص بك ووكلاءك الذكيين وصولًا إلى العملاء على WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn ومزيد من القنوات، عبر واجهة كل شبكة الرسمية. تربط Partner API الحسابات وتوزّع رموز وصول جديدة، ويمنح خادم MCP الوكلاء الحسابات نفسها كأدوات، وتُراقب كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، وتتوفر فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل أحتاج إلى تطبيق مطوّر خاص بي لدى Meta أو TikTok أو Google أو LinkedIn؟
لا. يسجّل أصحاب الحسابات الدخول عبر تطبيق easyCoexistence الخاص على كل شبكة، وتمنح نقطة بيانات الاعتماد كودك رمز ذلك الحساب على TikTok وYouTube وLinkedIn، جاهزًا للاستخدام مع واجهة الشبكة.
أي إصدار من Python والمكتبات أحتاج؟
واجهتا Partner API وواجهات الشبكات بروتوكول HTTPS عادي مع JSON، فتستدعيهما requests أو httpx أو أي عميل HTTP آخر في Python. يحتاج MCP Python SDK، الإصدار 2، الذي تستخدمه أدوات النشر على TikTok وأدوات الوكلاء، إلى Python 3.10 أو أحدث.
أي الشبكات ترسل التعليقات والرسائل المباشرة إلى نقطة النهاية (endpoint) الخاصة بي؟
ترسل Instagram وFacebook التعليقات والإشارات والرسائل المباشرة، وTikTok التعليقات، وكلها موقّعة بسر القناة. لا ترسل YouTube وLinkedIn مثل هذه الأحداث، لذا اقرأ تعليقاتهما عبر واجهاتهما وفق جدول زمني.
كم تكلّف easyCoexistence لـ Python؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، وبالسعر نفسه على كل شبكة. تشمل Partner API وموصّل MCP دون مقاعد، وتتوفر فترة تجريبية مجانية مدتها 3 أيام.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في