התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

תנו לצוות CrewAI כלים ל-Instagram, TikTok ו-WhatsApp

צוות CrewAI מקבל את Instagram, TikTok, WhatsApp וערוצים נוספים ככלים, כאשר לשדה mcps של כל סוכן מתווסף MCPServerHTTP לכתובת https://easycoexistence.com/api/mcp עם אסימון גישה של OAuth מ-easyCoexistence בכותרת Authorization. הלקוח של CrewAI שולח כותרות ואינו מבצע כניסה, ולכן הצוות מרענן את האסימון בכל הפעלה (kickoff), וכלים מותאמים אישית יכולים במקום זאת לגשת ל-API של הפוסטים עם מפתח.

headers

האפשרות הרשות של MCPServerHTTP למילון של כותרות HTTP, שהתיעוד של CrewAI מציג כשהוא נושא אסימון bearer בכותרת Authorization.

create_static_tool_filter

רשימות ההרשאה והחסימה של CrewAI לכלים של שרת MCP, שמיובאות מהמודול crewai.mcp.filters.

30 seconds

ברירת המחדל של CrewAI להמתנה לחיבור MCP; שרת שאינו נגיש נרשם כאזהרה, והסוכן ממשיך עם שאר הכלים שלו.

1 hour

משך החיים של אסימון הגישה ל-MCP של easyCoexistence; אסימון רענון, שתקף 60 יום, מביא זוג חדש.

90 days

עד כמה מראש מתזמן ה-API של הפוסטים של easyCoexistence פוסט, החל מדקה אחת, ומעתיק את המדיה כשהפוסט נכנס לתור.

איך סוכן CrewAI טוען את הכלים של easyCoexistence?

דרך השדה mcps, עם MCPServerHTTP אחד לכל סוכן. החיבור נעשה ב-Streamable HTTP, ברירת המחדל של CrewAI למחלקה הזו, והוא שולח את הכותרות שנתתם, כאן כותרת Authorization שמחזיקה אסימון גישה של easyCoexistence. מסנן כלים סטטי, שנוצר באמצעות create_static_tool_filter, נותן לכל סוכן רק את הכלים שהמשימה שלו צריכה, והאפשרות cache_tools_list שומרת את הרשימה אחרי החיבור הראשון. CrewAI מתחבר לפי דרישה, ואם שרת אינו נגיש הוא רושם אזהרה ומאפשר לסוכן להמשיך עם שאר הכלים שלו, לכן קראו את הלוג בהרצה הראשונה. את אסימון הגישה מביא העוזר בסעיף הבא.

A two-agent crew, each with its own slice of the tools
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 יום לא צריך לחזור לדפדפן לעולם. אחסנו את הקובץ השמור במערכת סודות, לא במאגר הקוד.

easycoexistence_token.py: sign in once, refresh per kickoff
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.

A CrewAI tool that queues a post through the posts API
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, ואדם מאשר אותו לפני שהוא יוצא.

Analystlist_social_accounts, list_social_posts, get_social_insights, get_youtube_analytics
WriterNo easyCoexistence tools; drafts captions from the brief and the analyst's findings
Schedulerpublish_instagram_post, publish_tiktok_post, publish_facebook_post, list_scheduled_posts
Community managerlist_social_comments, reply_to_comment, hide_comment, send_social_dm

מה הרשתות דורשות מפוסטים ותגובות של הצוות?

הכללים של ה-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

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 הימים הראשונים בחינם.

המשיכו לקרוא

תנו לסוכן LangChain גישה לכלי Instagram, TikTok ו-WhatsAppתנו לסוכן LangChain גישה ל-MCP של easyCoexistence מעל OAuth כדי לפרסם ולתזמן ב-Instagram וב-TikTok, להשיב לתגובות שלהן ולענות ב-Instagram וב-WhatsApp להודעות ישירות.כלים ל-Instagram, ל-TikTok ול-WhatsApp עבור סוכן OpenAI Agents SDKחברו סוכן OpenAI Agents SDK אל שרת MCP של easyCoexistence דרך OAuth, כדי לפרסם, לתזמן ולהשיב ב-Instagram, TikTok, WhatsApp ועוד.שליחת Reels ותמונות מ-Google Drive ל-Instagram עם Makeתרחיש Make שמעלה Reels ותמונות מתיקיית Google Drive ל-Instagram דרך ה-posts API של easyCoexistence, מיד או עד 90 ימים קדימה.פרסום ב-Instagram, ב-TikTok וב-Facebook מ-Python דרך ממשק API אחדפרסום פוסטים, קריאת תגובות ומענה להודעות DM ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Python, דרך ה-API הרשמי של כל רשת.תזמון פוסטים לרשתות חברתיות עם AI ב-Claude או ב-ChatGPTבקשו מ-Claude או מ-ChatGPT לתזמן פוסטים ב-Instagram, TikTok, LinkedIn ו-Facebook מתור easyCoexistence, עד 90 ימים קדימה, וב-YouTube באופן מובנה.פרסום ב-Instagram, TikTok, Facebook, YouTube ו-LinkedIn עם ממשק API אחדפרסום ותזמון ב-Instagram, TikTok, Facebook, YouTube ו-LinkedIn מ-Claude, מ-ChatGPT או מהקוד שלכם, בפורמטים של כל רשת.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-