תנו לצוות CrewAI כלים ל-Instagram, TikTok ו-WhatsApp
צוות CrewAI מקבל את Instagram, TikTok, WhatsApp וערוצים נוספים ככלים, כאשר לשדה mcps של כל סוכן מתווסף MCPServerHTTP לכתובת https://easycoexistence.com/api/mcp עם אסימון גישה של OAuth מ-easyCoexistence בכותרת Authorization. הלקוח של CrewAI שולח כותרות ואינו מבצע כניסה, ולכן הצוות מרענן את האסימון בכל הפעלה (kickoff), וכלים מותאמים אישית יכולים במקום זאת לגשת ל-API של הפוסטים עם מפתח.
האפשרות הרשות של MCPServerHTTP למילון של כותרות HTTP, שהתיעוד של CrewAI מציג כשהוא נושא אסימון bearer בכותרת Authorization.
רשימות ההרשאה והחסימה של CrewAI לכלים של שרת MCP, שמיובאות מהמודול crewai.mcp.filters.
ברירת המחדל של CrewAI להמתנה לחיבור MCP; שרת שאינו נגיש נרשם כאזהרה, והסוכן ממשיך עם שאר הכלים שלו.
משך החיים של אסימון הגישה ל-MCP של easyCoexistence; אסימון רענון, שתקף 60 יום, מביא זוג חדש.
עד כמה מראש מתזמן ה-API של הפוסטים של easyCoexistence פוסט, החל מדקה אחת, ומעתיק את המדיה כשהפוסט נכנס לתור.
איך סוכן CrewAI טוען את הכלים של easyCoexistence?
דרך השדה mcps, עם MCPServerHTTP אחד לכל סוכן. החיבור נעשה ב-Streamable HTTP, ברירת המחדל של CrewAI למחלקה הזו, והוא שולח את הכותרות שנתתם, כאן כותרת Authorization שמחזיקה אסימון גישה של 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 של ה-SDK של MCP בפייתון פעם אחת, על מחשב עם דפדפן, ושומרים את הרישום והאסימונים שהוא מחזיר. העוזר שלהלן משתמש בקו 1.x של ה-SDK, שאותו CrewAI מתקין. לפני כל הפעלה, fresh_token מחליף את אסימון הרענון השמור בזוג חדש בנקודת הקצה לאסימונים של 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 של כל רשת, ששייכים בשדה goal ובשדה backstory של הסוכנים:
- מדיה: קישור 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 יום קדימה, ואירועים חתומים לתגובות והודעות ישירות, עם ניטור של כל חיבור 24/7. US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם הלקוח של CrewAI מבצע בעצמו את הכניסה דרך OAuth?
התיעוד שלו מציג כותרות, משתני סביבה ופרמטרים בכתובת לאימות, בלי זרימת OAuth. לכן הצוות שולח אסימון bearer שכבר יש לו, ואת האסימון הזה מספקת כניסה אחת שמבוצעת עם ה-SDK של MCP בפייתון.
האם צוות יכול להגיב לתגובות לפי לוח הזמנים שלו?
כן. סוכן מנהל קהילה יכול לעבור על תגובות חדשות בכל הרצה, בעזרת הכלים 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 או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-