أدوات Instagram وTikTok وWhatsApp لوكيل LangChain
يحصل وكيل LangChain على Instagram وTikTok وWhatsApp وقنوات أخرى كأدوات من خادم MCP الخاص بـ easyCoexistence على https://easycoexistence.com/api/mcp يحمّله MCPAdapter، عميل MCP الخاص بـ LangChain، بينما يتولى FastMCP تسجيل الدخول عبر OAuth. بعدها يستطيع create_agent نشر المنشورات وجدولتها، والرد على التعليقات والرسائل المباشرة، وقراءة الإحصاءات عبر واجهة برمجة التطبيقات (API) الرسمية لكل شبكة، بينما تنقل الأحداث الموقعة التعليقات والرسائل الجديدة إلى مسارك.
تسمية LangChain لمساحة الأسماء langchain.mcp، وتحتاج إلى langchain[mcp] 1.4.0 أو أحدث، وتضم FastMCP.
مكان حفظ FastMCP لرموز الوصول (tokens) الخاصة بـ OAuth ما لم تُحدَّد token_storage كواجهة تخزين، فإعادة التشغيل تعني تسجيل الدخول من جديد.
عنوان loopback الخاص بخادم الاسترجاع المؤقت الذي يشغّله FastMCP لتسجيل الدخول عبر المتصفح، على منفذ حر أو على callback_port.
مدة صلاحية refresh token الخاص بـ easyCoexistence MCP؛ تدوم رموز الوصول ساعة، وكل تحديث يصدر زوجًا جديدًا.
المدة التي ينتظر فيها easyCoexistence رد مسارك على التعليق أو الرسالة المُحالة، وتُرسل مرة واحدة ولا تُعاد أبدًا.
أي أدوات تحصل عليها وكيل LangChain من easyCoexistence؟
أكثر من 35 أداة، كأدوات LangChain عادية يستطيع create_agent استدعاءها. تأخذ أدوات وسائل التواصل account_id، لذا يبدأ الوكيل بـ list_social_accounts ويمرر معرّفاته إلى أدوات النشر والقراءة والرد على التعليقات وإخفائها وقراءة الإحصاءات. تحمل الأدوات الخاصة بشبكة واحدة اسمها، مثل publish_tiktok_post أو upload_youtube_video، ويبدأ رقم WhatsApp من list_numbers الذي يعيد connection_id الذي تأخذه send_message وsend_template. يحمل وصف كل أداة قواعد الشبكة نفسها، فيتعلم النموذج مثلًا أن رد TikTok علني. ويحتاج النشر لاحقًا وسيطًا إضافيًا واحدًا: يضع scheduled_at المنشور في طابور easyCoexistence.
كيف يسجّل الوكيل الدخول إلى easyCoexistence؟
بمساعد OAuth الخاص بـ FastMCP، الذي يستخدمه MCPAdapter للمصادقة. في التشغيل الأول يكتشف خادم التفويض الخاص بـ easyCoexistence، ويسجّل نفسه كعميل، ويفتح المتصفح على شاشة الموافقة حيث يظهر client_name الخاص به، ويستقبل الرمز عبر استرجاع محلي على 127.0.0.1. بعد ذلك تتجدد رموز الوصول دون متصفح. تبقى الرموز في الذاكرة ما لم يحصل المساعد على واجهة تخزين token_storage، لذا يحفظ المثال الرموز على القرص مشفّرة بمفتاح Fernet. صفِّ القائمة قبل أن يراها create_agent: الأدوات تحتفظ بعميل MCP، لذا يظل الوكيل يعمل بعد إغلاق كتلة async with.
import os
from cryptography.fernet import Fernet
from fastmcp import Client
from fastmcp.client.auth import OAuth
from key_value.aio.stores.disk import DiskStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter
URL = "https://easycoexistence.com/api/mcp"
# Kept on disk and encrypted, so the browser sign-in happens once
oauth = OAuth(
client_name="Acme reply agent", # shown on easyCoexistence's consent screen
callback_port=8765,
token_storage=FernetEncryptionWrapper(
key_value=DiskStore(directory="~/.easycoexistence/oauth"),
fernet=Fernet(os.environ["TOKEN_KEY"]),
),
)
REPLY_TOOLS = {"list_social_accounts", "list_social_comments", "reply_to_comment",
"hide_comment", "send_social_dm"}
RULES = (
"You reply to comments and DMs for Acme, on the account_id in the event. "
"TikTok replies are public and need the video ID as post_id. "
"Never reply to the account's own messages or replies."
)
async def build_reply_agent(model: str):
async with MCPAdapter(Client(URL, auth=oauth)) as adapter:
tools = [t for t in await adapter.list_tools() if t.name in REPLY_TOOLS]
return create_agent(model, tools, system_prompt=RULES)كيف تصل التعليقات والرسائل المباشرة إلى وكيل LangChain؟
كطلبات POST موقّعة إلى مسار تملكه، لأن MCP يجيب فقط على الاستدعاءات التي يجريها الوكيل. وجّه كل حساب إلى المسار بواسطة set_social_webhook_destination، ويُطلب من الوكيل مرة واحدة أو يُشغَّل من Claude أو ChatGPT، واحتفظ بـ signing_secret الذي يعيده. ترسل Instagram وFacebook التعليقات والإشارات والرسائل المباشرة، ويرسل TikTok التعليقات؛ ويحمل كل حدث platform وaccount_id وexternal_id والإدخال الخاص بالشبكة. يتحقق المسار من X-EC-Signature، ويستجيب فورًا لأن easyCoexistence ينتظر 8 ثوانٍ ولا يعيد المحاولة، ثم يسلّم الحدث إلى الوكيل في الخلفية. يحفظ checkpointer مع thread_id لكل مرسل رسالة مباشرة سجلّ المحادثة.
import hashlib, hmac, json, time
from fastapi import BackgroundTasks, FastAPI, HTTPException, Request
app = FastAPI() # at startup: app.state.agent = await build_reply_agent("<MODEL>")
SECRETS: dict[str, str] = {} # account_id -> signing_secret, kept in your database
def signed(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")
async def social_event(request: Request, background: BackgroundTasks):
raw = await request.body()
event = json.loads(raw) # platform, account_id, external_id, entry
secret = SECRETS.get(event.get("account_id", ""))
if not secret or not signed(raw, request.headers.get("x-ec-signature", ""), secret):
raise HTTPException(status_code=401)
background.add_task(reply, event) # runs after the response is sent
return {"received": True}
async def reply(event: dict) -> None:
prompt = json.dumps(event) # the agent reads the platform, the account and the entry
await app.state.agent.ainvoke({"messages": [{"role": "user", "content": prompt}]})ما الذي تسمح به كل شبكة للوكيل؟
ما تسمح به API الخاصة بالشبكة للحساب، ويجب أن تذكره تعليمات الوكيل بوضوح:
- رسائل Instagram وMessenger المباشرة: يرد
send_social_dmعلى من راسلوا خلال آخر 24 ساعة، وتحدّ Instagram الرسالة المباشرة بـ 1,000 بايت من UTF-8. - ردود التعليقات: يرد
reply_to_commentعلنًا، أو مع private بقيمة true يرسل رسالة مباشرة واحدة لكل تعليق على Instagram أو Facebook خلال 7 أيام من وقوعه. - TikTok: الردود علنية دائمًا وتحتاج معرّف الفيديو كـ
post_id، ولا توجد رسائل مباشرة على TikTok. - WhatsApp: يعمل
send_messageخلال 24 ساعة من آخر رسالة من العميل، وsend_templateبقالب معتمد خارج هذه المدة. - الوسائط: كل ملف موجود على رابط HTTPS عام؛ تقبل Instagram صور JPEG، وتقبل منشورات الصور في TikTok صيغتي JPEG أو WebP.
متى ينبغي للكود أن يستدعي الشبكات دون الوكيل؟
عندما تحتاج خطوة إلى أن تتم بالطريقة نفسها في كل مرة، أو دون وجود أحد لتسجيل الدخول. يسلّم get_social_credentials الوكيل قاعدة API الخاصة بالحساب، ومعرّفه على الشبكة، وعلى TikTok وYouTube وLinkedIn، رمزًا صالحًا الآن، ويعيد Partner API الشيء نفسه من GET /api/v1/channels/:id?credentials=1 بمفتاح ec_live_، فيستطيع وظيفة Python أن تستدعي TikTok وGoogle وLinkedIn مباشرة. أما الردود التي يجب أن تخرج في أي ساعة دون الوكيل، كنص ثابت لكلمة مفتاحية، فتناسبها قواعد التعليقات والأتمتة التي يشغّلها easyCoexistence بنفسه.
الأخطاء الشائعة
- الرد على أحداث تسببها الحساب نفسه. ترد Instagram على رسائل الحساب المباشرة بقيمة is_echo true، وتعيد ردوده العلنية كتعليقات، فأسقطها قبل أن يراها الوكيل، وإلا رد على نفسه.
- تشغيل الوكيل قبل أن يستجيب المسار. ينتظر easyCoexistence 8 ثوانٍ لاستجابة 2xx ولا يعيد المحاولة أبدًا، فالمعالج الذي ينتظر النموذج يفقد الحدث؛ استجب أولًا، واعمل في الخلفية.
- استدعاء reply_to_comment لتعليق TikTok دون post_id. يسمّي رد TikTok الفيديو والتعليق معًا، فمرِّر video_id الخاص بالحدث بوصفه post_id.
- منح وكيل الرد أدوات النشر. صفِّ القائمة بالاسم قبل create_agent، حتى لا يتسبب تعليق أُسيء فهمه في نشر منشور أو حذفه أو تعديل أتمتة.
يمنح easyCoexistence وكلاء LangChain الوصول إلى العملاء عبر WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى، عبر واجهة API الرسمية لكل منها: خادم MCP واحد خلف تسجيل دخول OAuth، وأحداث موقعة للتعليقات والرسائل المباشرة، وطابور ينشر حتى 90 يومًا مقدمًا، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل مع إضافة الاتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.
الأسئلة الشائعة
هل يحتاج الوكيل إلى تطبيق مطوّر خاص به على Meta أو TikTok أو Google؟
لا. تُربط الحسابات عبر تطبيق easyCoexistence الخاص على كل شبكة، من لوحة التحكم أو عبر رابط الربط في Partner API، ويصل الوكيل إليها جميعًا من خلال تسجيل دخول واحد إلى easyCoexistence.
هل يستطيع الوكيل جدولة المنشورات بدلًا من نشرها فورًا؟
نعم. تأخذ publish_instagram_post وpublish_facebook_post وpublish_tiktok_post وpublish_linkedin_post القيمة scheduled_at، وهي وقت بصيغة ISO 8601 مع منطقة زمنية، من دقيقة واحدة إلى 90 يومًا مقدمًا. وتجدول YouTube أصلًا عبر upload_youtube_video وpublish_at.
ما النماذج التي تستطيع تشغيل الوكيل؟
أي نموذج محادثة يستطيع create_agent استخدامه مع الأدوات. أدوات MCP لا تعتمد على النموذج، ويحاسب مزوّد النموذج على استخدامه هو؛ أما easyCoexistence فيحاسب لكل اتصال، لا لكل استدعاء أداة.
كم تكلّف easyCoexistence لوكيل LangChain؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل مع إضافة الاتصالات، والسعر نفسه على كل شبكة. ويشمل ذلك خادم MCP، والأحداث المحالة، وPartner API، وفترة تجريبية مجانية مدتها 3 أيام.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في