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

תנו לסוכן LangChain גישה לכלי Instagram, TikTok ו-WhatsApp

סוכן LangChain מקבל את Instagram, TikTok, WhatsApp וערוצים נוספים ככלים משרת MCP של easyCoexistence בכתובת https://easycoexistence.com/api/mcp. את הכלים טוען MCPAdapter, לקוח ה-MCP של LangChain, ו-FastMCP מפעיל את הכניסה דרך OAuth. בעזרת create_agent הסוכן יכול לפרסם ולתזמן פוסטים, להשיב לתגובות ולהודעות ולקרוא נתוני תובנות דרך ה-API הרשמי של כל רשת, ואירועים חתומים מביאים לנתיב שלכם תגובות והודעות חדשות.

Beta

התווית של LangChain למרחב השמות langchain.mcp, שדורש את langchain[mcp] 1.4.0 ומעלה ומביא עמו את FastMCP.

In memory

היכן FastMCP שומר את אסימוני OAuth אם token_storage לא מציין מנגנון אחסון, כך שהפעלה מחדש דורשת להתחבר שוב.

127.0.0.1

כתובת הלופבק של שרת ההחזרה הזמני ש-FastMCP מפעיל לכניסה דרך הדפדפן, בפורט פנוי או בפורט שמציין השדה callback_port.

60 days

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

8 seconds

כמה זמן easyCoexistence ממתין לנתיב שלכם שיענה על תגובה או הודעה שהועברו אליו. האירוע נשלח פעם אחת ואינו נשלח שוב.

אילו כלים סוכן LangChain מקבל מ-easyCoexistence?

יותר מ-50, ככלי 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.

Instagrampublish_instagram_post, reply_to_comment, send_social_dm, get_social_insights
TikTokpublish_tiktok_post, get_tiktok_publish_status, reply_to_comment with post_id
WhatsApplist_numbers, send_message, send_template, get_number_health
Facebookpublish_facebook_post, reply_to_comment, send_social_dm for Messenger
YouTube and LinkedInupload_youtube_video, reply_to_youtube_comment, publish_linkedin_post, get_linkedin_stats
The queuelist_scheduled_posts, update_scheduled_post, cancel_scheduled_post, retry_scheduled_post

איך הסוכן נכנס ל-easyCoexistence?

באמצעות עזר ה-OAuth של FastMCP, שבו MCPAdapter משתמש לאימות. בהרצה הראשונה הוא מאתר את שרת ההרשאה של easyCoexistence, נרשם כלקוח, פותח את הדפדפן במסך ההסכמה, שבו מוצג client_name שלו, ומקבל את הקוד בחזרה משרת מקומי בכתובת 127.0.0.1. לאחר מכן אסימוני הגישה מתרעננים בלי דפדפן. האסימונים נשמרים בזיכרון, אלא אם לעזר יש מנגנון token_storage, ולכן הדוגמה שומרת אותם על הדיסק, מוצפנים במפתח Fernet. מסננים את הרשימה לפני ש-create_agent רואה אותה: הכלים מחזיקים את לקוח ה-MCP, ולכן הסוכן ממשיך לעבוד אחרי שהבלוק async with נסגר.

A reply agent's tools, with a sign-in that survives restarts
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 וה-entry של הרשת עצמה. הנתיב בודק את X-EC-Signature, עונה מיד, כי easyCoexistence ממתין 8 שניות ואינו מנסה שוב, ומעביר את האירוע לסוכן ברקע. נקודת שמירה עם thread_id לכל שולח הודעות DM שומרת את היסטוריית השיחה.

A FastAPI route that verifies the event, then runs the agent
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 של הרשת מאפשר לחשבון, וההוראות לסוכן צריכות לומר זאת במפורש:

  • הודעות DM ב-Instagram וב-Messenger: send_social_dm עונה לאנשים שכתבו ב-24 השעות האחרונות, ו-Instagram מגביל הודעת DM ל-1,000 בייטים ב-UTF-8.
  • תגובות: reply_to_comment משיב בפומבי. אם private מוגדר true, נשלחת הודעת DM אחת לכל תגובה ב-Instagram או ב-Facebook, בתוך 7 ימים ממנה.
  • TikTok: התשובות תמיד ציבוריות ודורשות את מזהה הסרטון בשדה post_id, ואין הודעות DM ב-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

easyCoexistence מעניק לסוכני LangChain שלכם גישה ללקוחות ב-WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn וערוצים נוספים, כל אחד דרך ה-API הרשמי שלו: שרת MCP אחד מאחורי כניסה ב-OAuth, אירועים חתומים של תגובות והודעות, ותור שמפרסם עד 90 ימים קדימה, כשכל חיבור מנוטר 24/7. 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 הימים הראשונים הם תקופת ניסיון.

המשיכו לקרוא

כלים ל-Instagram, ל-TikTok ול-WhatsApp עבור סוכן OpenAI Agents SDKחברו סוכן OpenAI Agents SDK אל שרת MCP של easyCoexistence דרך OAuth, כדי לפרסם, לתזמן ולהשיב ב-Instagram, TikTok, WhatsApp ועוד.שימוש בכלי רשתות חברתיות ב-Vercel AI SDK: Instagram, TikTok ועודהוסיפו את כלי ה-MCP של easyCoexistence ל-Vercel AI SDK עם createMCPClient ו-OAuth, ופרסמו, תזמנו והשיבו ב-Instagram, TikTok ועוד.תנו לצוות CrewAI כלים ל-Instagram, TikTok ו-WhatsAppסוכני CrewAI מפרסמים ומשיבים ב-Instagram, TikTok ו-WhatsApp דרך כלי MCP של easyCoexistence, מחוברים בעזרת MCPServerHTTP עם אסימון OAuth מאובטח.סוכן LangChain עם מספר WhatsApp משלוטוענים את כלי ה-MCP של EasyCoexistence לסוכן LangChain דרך OAuth, ומזינים אותו בהודעות WhatsApp נכנסות מוובהוק ב-Cloud API הרשמי.שרת MCP לרשתות חברתיות עבור Claude ו-ChatGPTמחבר MCP אחד לכל רשת: Claude או ChatGPT מפרסמים, מתזמנים, מגיבים לתגובות ולהודעות DM וקוראים אנליטיקה, דרך ממשקי API רשמיים.פרסום ב-Instagram, ב-TikTok וב-Facebook מ-Python דרך ממשק API אחדפרסום פוסטים, קריאת תגובות ומענה להודעות DM ב-Instagram, Facebook, TikTok, YouTube ו-LinkedIn מ-Python, דרך ה-API הרשמי של כל רשת.

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

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

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

נבדק ב-