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

כלים ל-Instagram, ל-TikTok ול-WhatsApp עבור סוכן OpenAI Agents SDK

סוכן OpenAI Agents SDK מקבל את Instagram, TikTok, WhatsApp ועוד ערוצים ככלים, דרך MCPServerStreamableHttp שמופנה אל https://easycoexistence.com/api/mcp, כאשר OAuthClientProvider של MCP Python SDK משמש כמטפל האימות שלו. מסנן כלים מצמצם את 35+ הכלים למשימה, require_approval מחזיק את הפרסום עד שאדם מאשר, וכל קריאה מגיעה לרשת דרך ה-API הרשמי שלה.

httpx2.Auth

מה ש-MCPServerStreamableHttp מקבל ב-params["auth"] עם MCP Python SDK v2; עם v1 הוא מקבל httpx.Auth.

mcp>=1.19.0,<3

טווח הגרסאות של חבילת mcp שעליה נשען Agents SDK, שמכסה את שתי הגרסאות המרכזיות של MCP Python SDK.

interruptions

היכן ריצה מושהית מפרטת את קריאות הכלים הממתינות לאישור, ש-RunState מאשר או דוחה, לפני ש-Runner.run ממשיך.

Per request

באיזו תדירות צריך לשלוח את אסימון ה-OAuth ב-authorization לכלי ה-MCP של Responses API; OpenAI אינו שומר את הערך.

40 a minute

כמות הקריאות ש-TikTok מתירה לכל חשבון מאושר בכל נקודת הקצה של Accounts API, כולל מענה לתגובות.

איך סוכן Agents SDK מתחבר ל-easyCoexistence?

דרך MCPServerStreamableHttp, כש-OAuthClientProvider של MCP Python SDK מוגדר ב-params["auth"]. ה-Agents SDK מעביר את המטפל הזה ללקוח ה-HTTP שהוא בונה, כך שהמטפל מגלה את שרת האימות של easyCoexistence, רושם את הסוכן שלכם כלקוח ציבורי, מריץ כניסה אחת בדפדפן עם PKCE ומרענן את אסימוני הגישה, שתקפים שעה, בעזרת אסימון הרענון. הדוגמה משתמשת ב-MCP Python SDK v2, שבו המטפל חייב להיות httpx2.Auth, וזה מה שהמטפל הוא. אובייקט אחסון שומר את הרישום והאסימונים בין הרצות; הקובץ שלהלן משמש תחליף לכספת סודות. create_static_tool_filter מפרט את הכלים שהסוכן רואה, ו-require_approval מציין אילו מהם ממתינים לאישור של אדם.

The MCP server, signed in over OAuth, with a filter and approvals
import json, webbrowser
from pathlib import Path
from urllib.parse import parse_qs, urlparse

from pydantic import AnyUrl
from mcp.client.auth import AuthorizationCodeResult, OAuthClientProvider
from mcp.shared.auth import OAuthClientInformationFull, OAuthClientMetadata, OAuthToken
from agents.mcp import MCPServerStreamableHttp, create_static_tool_filter

URL = "https://easycoexistence.com/api/mcp"
SAVED = Path("easycoexistence-oauth.json")  # a secret store in production

class SavedSignIn:  # the MCP SDK's TokenStorage: registration and tokens survive restarts
    def _read(self) -> dict:
        return json.loads(SAVED.read_text()) if SAVED.exists() else {}
    def _write(self, key: str, model) -> None:
        data = self._read()
        data[key] = model.model_dump(mode="json")
        SAVED.write_text(json.dumps(data))
    async def get_tokens(self):
        t = self._read().get("tokens")
        return OAuthToken(**t) if t else None
    async def set_tokens(self, tokens): self._write("tokens", tokens)
    async def get_client_info(self):
        c = self._read().get("client")
        return OAuthClientInformationFull(**c) if c else None
    async def set_client_info(self, info): self._write("client", info)

async def open_sign_in(url: str) -> None:
    webbrowser.open(url)

async def code_from_redirect() -> AuthorizationCodeResult:
    q = parse_qs(urlparse(input("Address after sign-in: ")).query)
    return AuthorizationCodeResult(code=q["code"][0], state=q["state"][0])

oauth = OAuthClientProvider(
    server_url=URL,
    client_metadata=OAuthClientMetadata(
        client_name="Social desk agent",  # shown on easyCoexistence's consent screen
        redirect_uris=[AnyUrl("http://localhost:3030/callback")],
        scope="mcp",
    ),
    storage=SavedSignIn(),
    redirect_handler=open_sign_in,
    callback_handler=code_from_redirect,
)

PUBLISH = ["publish_instagram_post", "publish_tiktok_post", "publish_facebook_post"]

def easycoexistence() -> MCPServerStreamableHttp:
    return MCPServerStreamableHttp(
        name="easyCoexistence",
        params={"url": URL, "auth": oauth, "timeout": 60},
        client_session_timeout_seconds=60,  # publishing waits on the network's API
        cache_tools_list=True,
        tool_filter=create_static_tool_filter(allowed_tool_names=[
            "list_social_accounts", "list_social_posts", "list_social_comments",
            "reply_to_comment", "list_scheduled_posts", *PUBLISH,
        ]),
        require_approval={"always": {"tool_names": PUBLISH}},
    )

איך שומרים על פרסום מאחורי אישור של אדם?

באמצעות require_approval בשרת, שמשהה את הריצה לפני שכלי בעל שם מסוים מופעל. הריצה חוזרת אז עם interruptions במקום תשובה סופית: הופכים את התוצאה ל-RunState, מאשרים או דוחים כל קריאה ממתינה, וקוראים שוב ל-Runner.run עם אותו סוכן ואותו מצב. כש-always_approve נשאר False, כל אישור חל על קריאה אחת בלבד, כך שהסוכן לא יכול לעשות שימוש חוזר באישור לפוסט שני. השרת נשאר פתוח לאורך ההשהיה, כי הלולאה רצה בתוך הבלוק async with. לסקירה שנמשכת שעות, ה-SDK יכול לשמור את המצב כ-JSON ולטעון אותו מחדש מאוחר יותר עם RunState.from_json.

Run the agent and resume it after each decision
from agents import Agent, Runner

RULES = "You run Acme's social accounts. Schedule posts with scheduled_at; TikTok replies are public."

async def run(task: str) -> str:
    async with easycoexistence() as server:
        agent = Agent(name="Social desk", instructions=RULES, mcp_servers=[server])
        result = await Runner.run(agent, task)
        while result.interruptions:  # a publish tool is waiting for a decision
            state = result.to_state()
            for item in result.interruptions:
                if await ask_a_person(item):  # your review screen, chat message or queue
                    state.approve(item, always_approve=False)
                else:
                    state.reject(item)
            result = await Runner.run(agent, state)
        return result.final_output

איך תגובה ב-TikTok או הודעת DM ב-Instagram מפעילה ריצה?

דרך נתיב HTTPS משלכם, כי הסוכן שומע רק את מה שהוא מבקש משרת MCP. set_social_webhook_destination מפנה תגובות, אזכורים והודעות DM של חשבון אל הנתיב ומחזיר סוד חתימה פעם אחת בלבד; חשבונות TikTok מעבירים תגובות. הנתיב בודק את X-EC-Signature, HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי, מגיב בתוך 8 שניות של easyCoexistence ומכניס את האירוע לתור. אחר כך עובד ברקע קורא ל-Runner.run עם האירוע כקלט. בהודעות DM, סשן שמפתחו הוא החשבון והשולח שומר על השיחה; תגובה ב-TikTok צריכה רק את התגובה ואת הסרטון שלה, ולכן יכולה לרוץ בלי סשן.

מה כדאי שההוראות של הסוכן יגידו על כל רשת?

הכללים ש-API של כל רשת מחיל על החשבון, כתובים במקום שהמודל קורא אותם:

  • TikTok: reply_to_comment מפרסם בפומבי ודורש את מזהה הסרטון כ-post_id; send_social_dm מסרב לחשבונות TikTok.
  • נפח ב-TikTok: עד 40 קריאות בדקה לחשבון בנקודת המענה, ותשובות רבות כמעט זהות בזמן קצר עלולות להיות מסומנות כספאם ומוסתרות.
  • הודעות DM ב-Instagram: תשובות רק לאנשים שכתבו בתוך 24 השעות האחרונות, עד 1,000 בייט של טקסט UTF-8.
  • WhatsApp: send_message בתוך 24 שעות מההודעה האחרונה של הלקוח, ו-send_template עם תבנית מאושרת בשאר המקרים.
  • תזמון: scheduled_at מקבל ISO 8601 עם אזור זמן, בין דקה אחת לבין 90 ימים קדימה, ו-list_scheduled_posts מציג את התור.

האם הסוכן יכול להשתמש ב-HostedMCPTool, או לרוץ בלי כניסה?

שניהם אפשריים, עם פשרות. HostedMCPTool מעביר את השרת ל-Responses API, שכלי ה-MCP שלו מקבל אסימון גישה של OAuth ב-authorization ודורש אותו בכל בקשה, כי OpenAI אינו שומר אותו; אסימון הגישה של easyCoexistence תקף שעה, לכן הקוד שלכם מרענן אותו לפני כל ריצה. למשימה שאין בה מי שייכנס, מוותרים על MCP: כלי פונקציה שקוראים ל-Partner API עם מפתח ec_live_ יכולים להכניס פוסטים לתור דרך POST /api/v1/channels/:id/posts ולמשוך אסימוני TikTok, YouTube ו-LinkedIn טריים מ-GET /api/v1/channels/:id?credentials=1, בעוד כללי תגובות ואוטומציות עונים ב-easyCoexistence בלי שסוכן כלשהו פועל.

טעויות נפוצות

  • השארת client_session_timeout_seconds על 5 שניות לפרסום. פרסום ממתין ל-API של הרשת, כך שקריאה איטית עלולה לחרוג מהזמן בסוכן אחרי ש-easyCoexistence כבר העביר את הפוסט הלאה; הקציבו דקה, ובדקו את list_scheduled_posts לפני ניסיון נוסף.
  • העברת external_id כ-account_id. הכלים מקבלים account_id, המזהה של החשבון ב-easyCoexistence; external_id הוא המזהה של החשבון עצמו ב-Instagram, TikTok או Facebook.
  • אישור השהיות בלולאה בלי אדם בה. require_approval מגן על הפרסום רק כאשר אדם, או כלל שאתם סומכים עליו, מחליט על כל קריאה ממתינה.
  • הזנת הסוכן בפעילות של החשבון שלו. Instagram מחזיר את ההודעות הישירות של החשבון כהדים עם is_echo true ואת התגובות הציבוריות שלו כתגובות חדשות; סננו את שניהם לפני Runner.run.
עושים את זה עם EasyCoexistence

easyCoexistence נותנת לסוכני OpenAI Agents SDK שלכם גישה ללקוחות ב-WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ועוד ערוצים, כל אחד דרך ה-API הרשמי שלו: שרת MCP שנכנס עם OAuth, אירועים חתומים לתגובות ולהודעות DM, ו-Partner API לעבודות שרצות בלי מפעיל, כאשר כל חיבור מנוטר 24/7. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים. 3 הימים הראשונים בחינם.

שאלות נפוצות

האם הסוכן צריך מפתח API מ-easyCoexistence?

לא עבור MCP. הכניסה דרך OAuth מנפיקה לסוכן אסימונים משלו; מפתח ec_live_ מהלוח בקרה מיועד רק לקוד שקורא ל-Partner API במקום לשרת MCP.

האם אותו סוכן יכול להשיב להודעות WhatsApp?

כן, עם כלי המספר: list_numbers לקבלת connection_id, send_message בתוך 24 שעות מההודעה האחרונה של הלקוח ו-send_template מעבר לכך. המדריך של OpenAI Agents SDK ל-WhatsApp מכסה קבלת ההודעות.

איזה מודל הסוכן משתמש בו?

כלי ה-MCP פועלים אותו דבר, בלי קשר למודל שה-SDK מריץ; השימוש במודל מחויב על ידי הספק שלו, ו-easyCoexistence גובה לפי חיבור.

כמה עולה easyCoexistence לסוכן OpenAI Agents SDK?

US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, זהה בכל רשת. שרת MCP, האירועים המועברים וה-Partner API כלולים במחיר, ו-3 הימים הראשונים הם בחינם.

המשיכו לקרוא

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

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

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

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

נבדק ב-