امنح طاقم CrewAI أدوات Instagram وTikTok وWhatsApp
يحصل طاقم CrewAI على Instagram وTikTok وWhatsApp وقنوات أخرى كأدوات، عندما تتضمن قائمة mcps لدى كل وكيل خادم MCPServerHTTP يشير إلى https://easycoexistence.com/api/mcp مع رمز الوصول (token) من OAuth الخاص بـ easyCoexistence في ترويسة Authorization. لا يُجري عميل MCP في CrewAI تسجيل دخول، بل يرسل الترويسات فحسب، لذا يجدد الطاقم الرمز عند كل بدء تشغيل، ويمكن للأدوات المخصصة أن تصل إلى واجهة برمجة التطبيقات (API) للمنشورات بمفتاح بدلًا من ذلك.
قاموس اختياري لترويسات HTTP في MCPServerHTTP، وتعرض وثائق CrewAI فيه ترويسة Authorization تحمل رمز Bearer.
قائمتا السماح والمنع لأدوات خادم MCP في CrewAI، ويجري استيرادهما من crewai.mcp.filters.
المهلة الافتراضية لاتصال MCP في CrewAI؛ إذا تعذر الوصول إلى الخادم يُسجَّل تحذير ويحتفظ الوكيل بأدواته الأخرى.
مدة صلاحية رمز وصول MCP من easyCoexistence؛ ويصدر رمز التحديث، الصالح لمدة 60 يومًا، زوجًا جديدًا.
المدة التي تسبق بها واجهة API للمنشورات في easyCoexistence موعد الجدولة، ابتداءً من دقيقة واحدة، وتنسخ الوسائط عند وضع المنشور في الطابور.
كيف يحمّل وكيل CrewAI أدوات easyCoexistence؟
عبر حقل mcps، بخادم MCPServerHTTP واحد لكل وكيل. يتصل الوكيل عبر Streamable HTTP، وهو الافتراضي في CrewAI لهذه الفئة، ويرسل الترويسات التي تحددها، وهنا ترويسة Authorization تحمل رمز الوصول (token) من easyCoexistence. يمنح مرشّح الأدوات الثابت الذي تنشئه create_static_tool_filter كل وكيل الأدوات التي تحتاجها مهمته فقط، ويحتفظ cache_tools_list بالقائمة بعد الاتصال الأول. يتصل CrewAI عند الحاجة، وإذا تعذّر الوصول إلى الخادم يسجّل تحذيرًا ويواصل الوكيل عمله بأدواته الأخرى، لذا اقرأ السجل في التشغيل الأول. يأتي رمز الوصول من المساعد الموجود في القسم التالي.
from crewai import Agent, Crew, Task
from crewai.mcp import MCPServerHTTP
from crewai.mcp.filters import create_static_tool_filter
from easycoexistence_token import fresh_token
TOKEN = fresh_token() # one per kickoff: an access token lasts an hour
def easycoexistence(*tools: str) -> MCPServerHTTP:
return MCPServerHTTP(
url="https://easycoexistence.com/api/mcp",
headers={"Authorization": f"Bearer {TOKEN}"},
streamable=True,
cache_tools_list=True,
tool_filter=create_static_tool_filter(allowed_tool_names=list(tools)),
)
analyst = Agent(
role="Social analyst",
goal="Find which of last week's Instagram and TikTok posts reached the most people",
backstory="You read the numbers before anyone writes a caption.",
mcps=[easycoexistence("list_social_accounts", "list_social_posts", "get_social_insights")],
)
scheduler = Agent(
role="Scheduler",
goal="Queue next week's posts at the times the analyst recommends",
backstory="You post only what the brief approves, always with scheduled_at.",
mcps=[easycoexistence("list_social_accounts", "publish_instagram_post",
"publish_tiktok_post", "list_scheduled_posts")],
)
crew = Crew(
agents=[analyst, scheduler],
tasks=[
Task(description="Rank last week's posts by reach and views.",
expected_output="A ranked list with the best posting times", agent=analyst),
Task(description="Schedule the three posts in {brief} for next week.",
expected_output="The post_id of each queued post", agent=scheduler),
],
)
crew.kickoff(inputs={"brief": "<THE WEEK'S BRIEF>"})من أين يأتي رمز وصول الطاقم؟
من تسجيل دخول واحد عبر المتصفح، ثم تجديد عند كل بدء تشغيل. يقبل خادم MCP في easyCoexistence رموز OAuth فقط: التسجيل الديناميكي للعميل، ورمز تفويض مع PKCE، ورموز وصول صالحة لساعة واحدة، ورموز تحديث صالحة لمدة 60 يومًا. شغّل OAuthClientProvider من MCP Python SDK مرة واحدة على جهاز به متصفح، واحفظ التسجيل والرموز التي يعيدها. يستخدم المساعد أدناه الإصدار 1.x من SDK، وهو الإصدار الذي يثبّته CrewAI. قبل كل بدء تشغيل، تستبدل الدالة fresh_token رمز التحديث المحفوظ برمز جديد عند نقطة النهاية (endpoint) الخاصة بالرموز في easyCoexistence، وتحفظه، لذا لا يحتاج الطاقم الذي يعمل مرة واحدة على الأقل كل 60 يومًا إلى المتصفح مجددًا. احفظ الملف في مخزن أسرار، لا في المستودع.
import asyncio, json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse
import httpx
import requests
from pydantic import AnyUrl
from mcp import ClientSession
from mcp.client.auth import OAuthClientProvider
from mcp.client.streamable_http import streamable_http_client
from mcp.shared.auth import OAuthClientMetadata
URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json") # a secret store in production
class SaveToFile: # the MCP SDK's TokenStorage, writing what the sign-in returns
def __init__(self):
self.saved = {}
async def get_tokens(self): return None
async def get_client_info(self): return None
async def set_tokens(self, tokens): self._put("tokens", tokens)
async def set_client_info(self, info): self._put("client", info)
def _put(self, key, model):
self.saved[key] = model.model_dump(mode="json")
SAVED.write_text(json.dumps(self.saved))
async def open_browser(url: str) -> None:
webbrowser.open(url)
async def code_from_redirect() -> tuple[str, str | None]:
q = parse_qs(urlparse(input("Address after sign-in: ")).query)
return q["code"][0], q.get("state", [None])[0]
async def sign_in_once() -> None:
oauth = OAuthClientProvider(
server_url=URL,
client_metadata=OAuthClientMetadata(
client_name="Acme crew", redirect_uris=[AnyUrl("http://localhost:3030/callback")], scope="mcp"),
storage=SaveToFile(), redirect_handler=open_browser, callback_handler=code_from_redirect,
)
async with httpx.AsyncClient(auth=oauth) as http:
async with streamable_http_client(URL, http_client=http) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize() # completes the sign-in and saves the tokens
def fresh_token() -> str:
"""Trade the saved refresh token for a new pair and return the access token."""
saved = json.loads(SAVED.read_text())
r = requests.post("https://easycoexistence.com/api/oauth/token", data={
"grant_type": "refresh_token",
"refresh_token": saved["tokens"]["refresh_token"],
"client_id": saved["client"]["client_id"],
}, timeout=30)
r.raise_for_status()
saved["tokens"] = r.json() # a new refresh token comes with each refresh
SAVED.write_text(json.dumps(saved))
return saved["tokens"]["access_token"]
if __name__ == "__main__":
asyncio.run(sign_in_once())كيف يمكن للطاقم النشر من دون خادم MCP؟
عبر أداة مخصصة تستدعي واجهة API للمنشورات في easyCoexistence، وهذا مناسب لطاقم يبدأه مجدول دون أن يكون أحد حاضرًا. أنشئ مفتاح API للشريك من لوحة التحكم، ويبدأ بـ ec_live_، وتُرسل الأداة أدناه الطلب POST /api/v1/channels/:id/posts مع النص ورابط الوسائط ونوعها وpublish_at. تنسخ easyCoexistence الوسائط عند وضع المنشور في الطابور، وترفض الرابط إذا أعاد صفحة ويب أو كان بتنسيق خاطئ في تلك اللحظة، وتنشر المنشور في موعده. تمنع الترويسة Idempotency-Key إضافة المنشور إلى الطابور مرتين عند إعادة استدعاء الطلب. ويقرأ المفتاح نفسه الرموز الحالية للشبكة من GET /api/v1/channels/:id?credentials=1.
import hashlib, os
import requests
from crewai.tools import tool
@tool("Schedule a social post")
def schedule_post(account_id: str, text: str, media_url: str, media_type: str, publish_at: str) -> str:
"""Queue one post on a connected Instagram, TikTok or Facebook account.
media_type is image or video; publish_at is ISO 8601 with a timezone, 1 minute to 90 days ahead."""
key = hashlib.sha256(f"{account_id}|{publish_at}|{media_url}".encode()).hexdigest()
r = requests.post(
f"https://easycoexistence.com/api/v1/channels/{account_id}/posts",
headers={"Authorization": f"Bearer {os.environ['EC_API_KEY']}", "Idempotency-Key": key},
json={"text": text, "media": [{"url": media_url, "type": media_type}], "publish_at": publish_at},
timeout=60,
)
return r.text # the queued post, or why it was refusedأي وكيل في الطاقم يحمل أي أدوات؟
أقل عدد يسمح له بإتمام مهمته، لأن الوكيل يستطيع استدعاء أي أداة يحملها. يقسّم الطاقم الذي يخطط لأسبوع من المحتوى وينشره العمل بحيث تكون القراءة والكتابة والنشر لدى وكلاء مختلفين، ولا يستطيع إلا واحد منهم أن يضع شيئًا على الهواء. لا تمنح الكاتب أي أداة من easyCoexistence: يعمل من نتائج المحلل والموجز، وتصل نصوص المنشورات إلى المجدول كمخرج للمهمة. تقبل أدوات النشر الحقل scheduled_at، فيضع المجدول المنشورات في الطابور لأوقاتها بدلًا من نشرها لحظة تشغيله، ويتيح list_scheduled_posts للوكيل التأكد مما ينتظر النشر. لا تدخل منشورات LinkedIn الطواقم: يعدّ الوكيل كل منشور عند الطلب، مثلًا في Claude أو ChatGPT، ويوافق عليه شخص قبل نشره.
ما الذي تشترطه الشبكات على منشورات الطاقم وردوده؟
قواعد واجهة API لكل شبكة، وينبغي أن تكون ضمن أهداف الوكلاء وخلفياتهم:
- الوسائط: رابط HTTPS عام لكل ملف. يقبل Instagram الصور بصيغة JPEG، وتقبل منشورات الصور في TikTok صيغة JPEG أو WebP، ويقبل منشور صفحة Facebook صورة واحدة أو فيديو واحدًا.
- الأوقات: بتنسيق ISO 8601 مع المنطقة الزمنية، مثل 2026-11-20T09:00:00-03:00، من دقيقة واحدة إلى 90 يومًا مقدمًا.
- التعليقات: ردود TikTok عامة وتحتاج معرّف الفيديو بوصفه
post_id، ويمكن إرسال رد خاص واحد على تعليق في Instagram أو Facebook خلال 7 أيام. - الرسائل المباشرة: يقبل Instagram وMessenger الردود خلال 24 ساعة من آخر رسالة من الشخص، وتلتزم
send_messageفي WhatsApp بالنافذة نفسها، أماsend_templateفتصل إلى أي شخص غير ذلك. - الأحداث: لا تصل التعليقات والرسائل المباشرة إلى الطاقم إلا عبر مسار خاص بك يُحدَّد بـ
set_social_webhook_destination، ويمكنه استدعاء crew.kickoff مع الحدث.
الأخطاء الشائعة
- بدء طاقم برمز الأمس. تنتهي صلاحية رمز الوصول من easyCoexistence بعد ساعة من إصداره، ويتابع CrewAI العمل دون خادم لا يستطيع الوصول إليه، ولا يظهر ذلك إلا كتحذير في السجل؛ استدعِ fresh_token عند كل بدء تشغيل.
- منح كل وكيل الخادم كاملًا. من دون tool_filter يرى المحلل أدوات النشر أيضًا؛ مرّر create_static_tool_filter بالأسماء التي تحتاجها مهمته.
- كتابة publish_at أو scheduled_at بدون إزاحة زمنية. ترفض easyCoexistence الوقت بلا منطقة زمنية، لذا أنهِه بالحرف Z أو بإزاحة مثل -03:00.
- حفظ ملف تسجيل الدخول في المستودع. يمنح رمز التحديث فيه أدوات الحساب لمن يحمله حتى 60 يومًا، لذا احفظه في مخزن أسرار.
يمنح easyCoexistence وكلاء CrewAI الوصول إلى العملاء عبر WhatsApp وInstagram وFacebook وTikTok وYouTube وLinkedIn وقنوات أخرى، كلٌّ عبر واجهة API الرسمية الخاصة به: أكثر من 35 أداة MCP لقائمة mcps لدى كل وكيل، وواجهة API للمنشورات تضع المنشورات في الطابور حتى 90 يومًا مقدمًا، وأحداث موقّعة للتعليقات والرسائل المباشرة، مع مراقبة كل اتصال على مدار الساعة. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، مع أول 3 أيام مجانية.
الأسئلة الشائعة
هل يُجري عميل MCP في CrewAI تسجيل الدخول عبر OAuth بنفسه؟
توضح وثائقه الترويسات ومتغيرات البيئة ومعاملات الاستعلام للمصادقة، دون تدفق OAuth. لذا يرسل الطاقم رمز Bearer يملكه أصلًا، وهو ما يوفره تسجيل دخول واحد عبر MCP Python SDK.
هل يستطيع الطاقم الرد على التعليقات وفق جدوله الخاص؟
نعم. يستطيع وكيل مدير المجتمع الذي يملك list_social_posts وlist_social_comments وreply_to_comment أن يعالج التعليقات الجديدة في كل تشغيل، وهذه هي الطريقة التي تُقرأ بها تعليقات YouTube وLinkedIn أيضًا، لأن أيًّا منهما لا يرسل أحداثًا.
هل يستطيع الطاقم إرسال رسائل WhatsApp؟
نعم، مع list_numbers وsend_message وsend_template في مرشّح أدوات الوكيل. تردّ send_message على العملاء الذين كتبوا خلال آخر 24 ساعة، وترسل send_template قالبًا معتمدًا إلى أي شخص غير ذلك.
كم تكلّف easyCoexistence طاقم CrewAI؟
من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ينخفض كلما أضفت اتصالات، والسعر نفسه على كل شبكة. يشمل ذلك خادم MCP وواجهة API للمنشورات والأحداث المُعاد توجيهها، مع أول 3 أيام مجانية.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في