תנו לסוכן LangChain גישה לכלי Instagram, TikTok ו-WhatsApp
סוכן 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 שומר את אסימוני OAuth אם token_storage לא מציין מנגנון אחסון, כך שהפעלה מחדש דורשת להתחבר שוב.
כתובת הלופבק של שרת ההחזרה הזמני ש-FastMCP מפעיל לכניסה דרך הדפדפן, בפורט פנוי או בפורט שמציין השדה callback_port.
משך החיים של אסימון הרענון של MCP ב-easyCoexistence. אסימוני הגישה חיים שעה, וכל רענון מנפיק זוג חדש.
כמה זמן 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.
איך הסוכן נכנס ל-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 וה-entry של הרשת עצמה. הנתיב בודק את X-EC-Signature, עונה מיד, כי easyCoexistence ממתין 8 שניות ואינו מנסה שוב, ומעביר את האירוע לסוכן ברקע. נקודת שמירה עם thread_id לכל שולח הודעות DM שומרת את היסטוריית השיחה.
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 מעניק לסוכני 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 הימים הראשונים הם תקופת ניסיון.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-