ΣύνδεσηΞεκινήστε δωρεάν δοκιμή
easyCoexistence Επίσημα API

Δώστε σε ένα agent του OpenAI Agents SDK tools για Instagram, TikTok και WhatsApp

Ένα agent του OpenAI Agents SDK αποκτά κανάλια Instagram, TikTok, WhatsApp και άλλα ως tools μέσω του MCPServerStreamableHttp, με προορισμό το https://easycoexistence.com/api/mcp και με τον OAuthClientProvider του MCP Python SDK ως handler ελέγχου ταυτότητας. Ένα φίλτρο tools περιορίζει τα 35+ tools στη δουλειά, το 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

Πού εμφανίζει μια εκτέλεση σε παύση τις κλήσεις tools που περιμένουν έγκριση, τις οποίες ένα RunState εγκρίνει ή απορρίπτει πριν συνεχίσει το Runner.run.

Per request

Πόσο συχνά πρέπει να αποστέλλεται στο authorization το OAuth token στο MCP tool του Responses API· το OpenAI δεν αποθηκεύει την τιμή.

40 a minute

Πόσες κλήσεις επιτρέπει το TikTok ανά εξουσιοδοτημένο λογαριασμό σε κάθε endpoint του Accounts API, συμπεριλαμβανομένων των απαντήσεων σε σχόλια.

Πώς ένα agent του Agents SDK συνδέεται με το easyCoexistence;

Μέσω του MCPServerStreamableHttp, με τον OAuthClientProvider του MCP Python SDK στο params["auth"]. Το Agents SDK περνά αυτόν τον handler στον HTTP client που δημιουργεί, οπότε ο provider εντοπίζει τον authorization server του easyCoexistence, καταχωρίζει το agent σας ως public client, εκτελεί μία είσοδο στον browser με PKCE και ανανεώνει τα access tokens διάρκειας μίας ώρας με το refresh token. Το παράδειγμα χρησιμοποιεί το MCP Python SDK v2, όπου ο handler πρέπει να είναι httpx2.Auth, και αυτό είναι ο provider. Ένα αντικείμενο αποθήκευσης κρατά την καταχώριση και τα tokens μεταξύ των εκτελέσεων· το αρχείο παρακάτω υποκαθιστά ένα secret store. Το create_static_tool_filter ορίζει ποια tools βλέπει το agent, και το 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 στον server, που σταματά την εκτέλεση πριν εκτελεστεί ένα ονομασμένο tool. Η εκτέλεση επιστρέφει τότε με interruptions αντί για τελική απάντηση: μετατρέψτε το αποτέλεσμα σε RunState, εγκρίνετε ή απορρίψτε κάθε εκκρεμή κλήση και καλέστε ξανά το Runner.run με το ίδιο agent και την ίδια κατάσταση. Με το always_approve στο False, κάθε «ναι» καλύπτει μία κλήση, οπότε το agent δεν μπορεί να επαναχρησιμοποιήσει μια έγκριση για δεύτερη ανάρτηση. Ο server μένει ανοιχτός κατά τη διακοπή, επειδή ο βρόχος τρέχει μέσα στο async with block του. Για έλεγχο που διαρκεί ώρες, το 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 route, αφού το agent ακούει μόνο όσα ζητά από τον MCP server. Το set_social_webhook_destination στοχεύει τα σχόλια, τις αναφορές και τα DMs ενός λογαριασμού προς το route και επιστρέφει ένα μυστικό υπογραφής μία φορά· οι λογαριασμοί TikTok προωθούν σχόλια. Το route ελέγχει το X-EC-Signature, ένα HMAC-SHA256 του timestamp, μιας τελείας και του ακατέργαστου body, απαντά εντός των 8 δευτερολέπτων του easyCoexistence και βάζει το γεγονός σε ουρά. Ένας worker καλεί έπειτα το Runner.run με το γεγονός ως input. Για τα DMs, μια συνεδρία με κλειδί τον λογαριασμό και τον αποστολέα κρατά τη συνομιλία σε εξέλιξη· ένα σχόλιο TikTok χρειάζεται μόνο το σχόλιο και το βίντεό του, οπότε μπορεί να τρέξει χωρίς αυτό.

Τι πρέπει να λένε οι οδηγίες του agent για κάθε δίκτυο;

Οι κανόνες που εφαρμόζει το API κάθε δικτύου στον λογαριασμό, γραμμένοι εκεί όπου τους διαβάζει το μοντέλο:

  • TikTok: το reply_to_comment δημοσιεύει δημόσια και θέλει το ID του βίντεο ως post_id· το send_social_dm απορρίπτει λογαριασμούς TikTok.
  • Όγκος στο TikTok: έως 40 κλήσεις το λεπτό ανά λογαριασμό στο endpoint απαντήσεων, και πολλές σχεδόν πανομοιότυπες απαντήσεις σε σύντομο χρονικό διάστημα μπορεί να κρυφτούν ως spam.
  • DMs στο Instagram: απαντήσεις μόνο σε όσους έγραψαν τις τελευταίες 24 ώρες, σε το πολύ 1.000 bytes κειμένου UTF-8.
  • WhatsApp: send_message εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη, και send_template με εγκεκριμένο template διαφορετικά.
  • Χρονισμός: το scheduled_at δέχεται ISO 8601 με ζώνη ώρας, από 1 λεπτό έως 90 ημέρες μπροστά, και το list_scheduled_posts δείχνει την ουρά.

Μπορεί το agent να χρησιμοποιεί το HostedMCPTool ή να τρέχει χωρίς είσοδο;

Και τα δύο, με αντισταθμίσεις. Το HostedMCPTool παραδίδει τον server στο Responses API, του οποίου το MCP tool δέχεται ένα OAuth access token στο authorization και το θέλει σε κάθε αίτημα, αφού το OpenAI δεν το αποθηκεύει· ένα access token του easyCoexistence ισχύει μία ώρα, οπότε ο κώδικάς σας ανανεώνει ένα πριν από κάθε εκτέλεση. Για δουλειά χωρίς κάποιον να συνδεθεί, παραλείψτε το MCP: τα function tools που καλούν το Partner API με ένα κλειδί ec_live_ μπορούν να βάζουν σε ουρά αναρτήσεις μέσω του POST /api/v1/channels/:id/posts και να λαμβάνουν φρέσκα tokens του TikTok, του YouTube και του LinkedIn από το GET /api/v1/channels/:id?credentials=1, ενώ οι κανόνες σχολίων και τα automations απαντούν στο easyCoexistence χωρίς να τρέχει κανένα agent.

Συνηθισμένα λάθη

  • Το να κρατάτε το client_session_timeout_seconds στα 5 δευτερόλεπτα για τη δημοσίευση. Η δημοσίευση περιμένει το API του δικτύου, οπότε μια αργή κλήση μπορεί να λήξει στο agent αφού το easyCoexistence έχει ήδη προωθήσει την ανάρτηση· δώστε ένα λεπτό και ελέγξτε το list_scheduled_posts πριν δοκιμάσετε ξανά.
  • Η αποστολή του external_id ως account_id. Τα tools παίρνουν το account_id, δηλαδή το ID του λογαριασμού στο easyCoexistence· το external_id είναι το δικό του ID του λογαριασμού στο Instagram, TikTok ή Facebook.
  • Η έγκριση διακοπών σε βρόχο χωρίς άνθρωπο μέσα. Το require_approval προστατεύει τη δημοσίευση μόνο όταν ένας άνθρωπος, ή ένας κανόνας που εμπιστεύεστε, αποφασίζει για κάθε εκκρεμή κλήση.
  • Η τροφοδότηση του agent με τη δραστηριότητα του ίδιου του λογαριασμού. Το Instagram επιστρέφει τα DMs του λογαριασμού ως echoes με is_echo true και τις δημόσιες απαντήσεις του ως νέα σχόλια· φιλτράρετε και τα δύο πριν το Runner.run.
Κάντε το με EasyCoexistence

Το easyCoexistence δίνει στα agents σας του OpenAI Agents SDK πρόσβαση σε πελάτες μέσω WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn και άλλα κανάλια, το καθένα μέσω του επίσημου API του: έναν MCP server που συνδέεται με OAuth, υπογεγραμμένα γεγονότα για σχόλια και DMs και ένα Partner API για δουλειές που τρέχουν χωρίς επίβλεψη, με κάθε σύνδεση να παρακολουθείται 24/7. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.

Συχνές ερωτήσεις

Χρειάζεται το agent κλειδί API από το easyCoexistence;

Όχι για το MCP. Η είσοδος με OAuth εκδίδει στο agent τα δικά του tokens· ένα κλειδί ec_live_ από το dashboard προορίζεται μόνο για κώδικα που καλεί το Partner API αντί για τον MCP server.

Μπορεί το ίδιο agent να απαντά σε μηνύματα WhatsApp;

Ναι, με τα tools του αριθμού: το list_numbers για το connection_id, το send_message εντός 24 ωρών από το τελευταίο μήνυμα του πελάτη και το send_template έξω από αυτό το διάστημα. Ο οδηγός του OpenAI Agents SDK για WhatsApp καλύπτει τη λήψη των μηνυμάτων.

Ποιο μοντέλο χρησιμοποιεί το agent;

Αυτό που δίνετε στο Agent. Τα MCP tools λειτουργούν το ίδιο όποιο μοντέλο κι αν τρέχει το SDK, η χρήση του μοντέλου χρεώνεται από τον πάροχό του, και το easyCoexistence χρεώνει ανά σύνδεση.

Πόσο κοστίζει το easyCoexistence για ένα agent του OpenAI Agents SDK;

Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση καθώς προσθέτετε συνδέσεις, το ίδιο σε κάθε δίκτυο. Ο MCP server, τα προωθούμενα γεγονότα και το Partner API περιλαμβάνονται, και οι πρώτες 3 ημέρες είναι δωρεάν.

Συνεχίστε την ανάγνωση

Δώστε σε έναν agent του LangChain εργαλεία για Instagram, TikTok και WhatsAppΔώστε σε agent LangChain τα εργαλεία MCP του easyCoexistence με OAuth για ανάρτηση, προγραμματισμό σε Instagram και TikTok, σχόλια και DM σε Instagram, WhatsApp.Δώστε σε ένα CrewAI crew εργαλεία για Instagram, TikTok και WhatsAppΟι agents του CrewAI παίρνουν τα εργαλεία MCP του easyCoexistence μέσω MCPServerHTTP και OAuth bearer token, για δημοσιεύσεις σε Instagram, TikTok και WhatsApp.Εργαλεία social media στο Vercel AI SDK: Instagram, TikTok και άλλαΣυνδέστε τα εργαλεία MCP του easyCoexistence στο Vercel AI SDK με createMCPClient και OAuth και δημοσιεύστε στο Instagram, TikTok και άλλα.Απάντηση σε σχόλια TikTok με AI στο n8nΡοή n8n που απαντά σε σχόλια TikTok με AI: υπογεγραμμένα συμβάντα του easyCoexistence, μοντέλο συνομιλίας και δημόσια απάντηση μέσω του API του TikTok.Βάλτε έναν agent του OpenAI Agents SDK στο WhatsAppΤρέξτε έναν agent του OpenAI Agents SDK σε αριθμό WhatsApp μέσω του επίσημου Cloud API της Meta, με μία συνεδρία ανά πελάτη.API κοινωνικών δικτύων για AI agents: δημοσίευση, προγραμματισμός, απαντήσεις και μέτρησηΈνα API και MCP server για AI agents: δημοσίευση, προγραμματισμός, απαντήσεις και αναλυτικά σε κοινωνικά δίκτυα μέσω επίσημων API.

Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.

Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.

  • 3 ημέρες δωρεάν
  • Ακύρωση ανά πάσα στιγμή
  • Μόνο επίσημα API
  • Παρακολούθηση 24/7

Επαληθεύτηκε στις