Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Oferiți echipei CrewAI instrumente pentru Instagram, TikTok și WhatsApp

O echipă CrewAI primește Instagram, TikTok, WhatsApp și alte canale ca instrumente atunci când lista mcps a fiecărui agent conține un MCPServerHTTP pentru https://easycoexistence.com/api/mcp, cu un token de acces OAuth easyCoexistence în antetul Authorization. Clientul MCP al CrewAI trimite antete și nu rulează o autentificare, așa că echipa reîmprospătează token-ul la fiecare pornire, iar instrumentele personalizate pot ajunge la API-ul de postări cu o cheie.

headers

Dicționarul opțional de antete HTTP al MCPServerHTTP, pe care documentația CrewAI îl arată purtând un token bearer în antetul Authorization.

create_static_tool_filter

Listele de instrumente permise și blocate ale unui server MCP în CrewAI, importate din crewai.mcp.filters.

30 seconds

Timpul implicit de așteptare al CrewAI pentru o conexiune MCP; un server inaccesibil este înregistrat ca avertisment, iar agentul își păstrează celelalte instrumente.

1 hour

Durata de viață a unui token de acces MCP easyCoexistence; un token de reîmprospătare, valabil 60 de zile, aduce o pereche nouă.

90 days

Cât de departe în avans programează API-ul de postări easyCoexistence o postare, începând de la 1 minut, și copiază media în momentul în care postarea intră în coadă.

Cum încarcă un agent CrewAI instrumentele easyCoexistence?

Prin câmpul mcps, cu un MCPServerHTTP pentru fiecare agent. Se conectează prin Streamable HTTP, valoarea implicită a CrewAI pentru această clasă, și trimite antetele pe care le dați, aici un antet Authorization cu un token de acces easyCoexistence. Un filtru static de instrumente, creat cu create_static_tool_filter, îi oferă fiecărui agent doar instrumentele de care are nevoie pentru sarcina lui, iar cache_tools_list păstrează lista după prima conexiune. CrewAI se conectează la cerere și, dacă un server nu poate fi atins, înregistrează un avertisment și lasă agentul să continue cu celelalte instrumente, deci citiți jurnalul la prima rulare. Token-ul de acces vine de la funcția ajutătoare din secțiunea următoare.

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>"})

De unde vine token-ul de acces al echipei?

Dintr-o singură autentificare în browser, apoi dintr-o reîmprospătare la fiecare pornire. Serverul MCP easyCoexistence acceptă doar token-uri OAuth: înregistrare dinamică a clientului, un cod de autorizare cu PKCE, token-uri de acces valabile o oră și token-uri de reîmprospătare valabile 60 de zile. Rulați o dată OAuthClientProvider din SDK-ul Python MCP, pe un calculator cu browser, și salvați înregistrarea și token-urile pe care le returnează; funcția de mai jos folosește linia 1.x a SDK-ului, pe care o instalează CrewAI. Înainte de fiecare pornire, fresh_token schimbă token-ul de reîmprospătare salvat la endpoint-ul de token al easyCoexistence pe o pereche nouă și o stochează, astfel că o echipă care rulează cel puțin o dată la 60 de zile nu mai are nevoie niciodată de browser. Păstrați fișierul salvat într-un depozit securizat de secrete, nu în depozitul de cod.

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())

Cum poate publica o echipă fără serverul MCP?

Cu un instrument personalizat care apelează API-ul de postări al easyCoexistence, potrivit pentru o echipă pornită de un planificator, fără nimeni prin preajmă. Creați o cheie Partner API în panoul de control, care începe cu ec_live_, iar instrumentul de mai jos trimite POST /api/v1/channels/:id/posts cu textul, linkul media, tipul și publish_at. easyCoexistence copiază media când postarea intră în coadă, refuză un link care întoarce o pagină web sau un format greșit în acel moment și publică postarea la ora ei; antetul Idempotency-Key împiedică ca un apel reluat să pună postarea în coadă de două ori. Aceeași cheie citește token-urile proaspete ale rețelelor din 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

Ce agent din echipă ar trebui să aibă ce instrumente?

Cele mai puține instrumente care îi permit să-și termine sarcina, pentru că un agent poate apela orice instrument pe care îl are. O echipă care planifică și postează o săptămână de conținut împarte munca astfel încât citirea, scrierea și publicarea să stea la agenți diferiți, iar doar unul dintre ei poate publica ceva live. Nu dați scriitorului niciun instrument easyCoexistence: lucrează din constatările analistului și din brief, iar textele postărilor ajung la planificator ca rezultat al sarcinii. Instrumentele de publicare acceptă scheduled_at, deci planificatorul pune postările în coadă la ora lor, în loc să posteze în momentul rulării, iar list_scheduled_posts îl lasă să confirme ce așteaptă. Postările LinkedIn rămân în afara echipelor: un agent redactează fiecare postare la cerere, de exemplu în Claude sau ChatGPT, iar o persoană o aprobă înainte să plece.

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

Ce cer rețelele de la postările și răspunsurile echipei?

Regulile API-ului fiecărei rețele, care trebuie să apară în obiectivele și poveștile de fundal ale agenților:

  • Media: un link HTTPS public pentru fiecare fișier. Instagram acceptă imagini JPEG, postările foto de pe TikTok acceptă JPEG sau WebP, iar o postare pe Pagina de Facebook acceptă o fotografie sau un videoclip.
  • Ora: format ISO 8601 cu fus orar, de exemplu 2026-11-20T09:00:00-03:00, de la 1 minut până la 90 de zile în avans.
  • Comentarii: răspunsurile TikTok sunt publice și necesită ID-ul videoclipului ca post_id; un comentariu pe Instagram sau Facebook poate primi un singur răspuns privat, în 7 zile.
  • DM-uri: Instagram și Messenger acceptă răspunsuri în 24 de ore de la ultimul mesaj al persoanei; send_message respectă aceeași fereastră, iar send_template ajunge la oricine altcineva.
  • Evenimente: un comentariu sau un DM ajunge la echipă doar prin propria rută, setată cu set_social_webhook_destination, care poate apela crew.kickoff cu evenimentul.

Greșeli frecvente

  • Pornirea unei echipe cu token-ul de ieri. Un token de acces easyCoexistence expiră la o oră după emitere, iar CrewAI merge mai departe fără un server la care nu poate ajunge, cu doar un avertisment în jurnal; apelați fresh_token la fiecare pornire.
  • Acordarea întregului server fiecărui agent. Fără tool_filter, un analist vede și instrumentele de publicare; transmiteți create_static_tool_filter cu numele pe care le cere sarcina lui.
  • Scrierea publish_at sau scheduled_at fără decalaj. easyCoexistence refuză o oră fără fus orar, deci terminați-o cu Z sau cu un decalaj precum -03:00.
  • Comiterea fișierului salvat de autentificare. Token-ul lui de reîmprospătare oferă oricui îl deține instrumentele contului timp de până la 60 de zile, deci păstrați-l într-un depozit securizat de secrete.
Faceți acest lucru cu EasyCoexistence

easyCoexistence oferă agenților dumneavoastră CrewAI acces la clienți pe WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn și alte canale, fiecare prin API-ul său oficial: peste 35 de instrumente MCP pentru lista mcps a fiecărui agent, un API de postări care programează până la 90 de zile în avans și evenimente semnate pentru comentarii și DM-uri, cu fiecare conexiune monitorizată 24/7. De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu o perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Clientul MCP din CrewAI rulează singur autentificarea OAuth?

Documentația lui arată antete, variabile de mediu și parametri de interogare pentru autentificare, fără niciun flux OAuth. Așadar echipa trimite un token bearer pe care îl deține deja, pe care îl oferă o singură autentificare cu SDK-ul Python MCP.

Poate echipa să răspundă singură la comentarii, după propriul program?

Da. Un agent de community management cu list_social_posts, list_social_comments și reply_to_comment poate parcurge comentariile noi la fiecare rulare, ceea ce este și modul în care se citesc comentariile de pe YouTube și LinkedIn, fiindcă niciuna dintre rețele nu trimite evenimente mai departe.

Poate echipa să trimită mesaje WhatsApp?

Da, cu list_numbers, send_message și send_template în filtrul de instrumente al unui agent. send_message răspunde clienților care au scris în ultimele 24 de ore, iar send_template trimite un șablon aprobat oricui altcuiva.

Cât costă easyCoexistence pentru o echipă CrewAI?

De la US$ 9 până la US$ 0,75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, și același preț pe fiecare rețea. Serverul MCP, API-ul de postări și evenimentele transmise sunt incluse, cu o perioadă de probă gratuită de 3 zile.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la