AccediInizia la prova gratuita
easyCoexistence API ufficiali

Dai a un crew CrewAI gli strumenti per Instagram, TikTok e WhatsApp

Un crew CrewAI riceve Instagram, TikTok, WhatsApp e altri canali come strumenti quando la lista mcps di ogni agente contiene un MCPServerHTTP per https://easycoexistence.com/api/mcp con un token di accesso OAuth di easyCoexistence nel suo header Authorization. Il client MCP di CrewAI invia header invece di eseguire un accesso, quindi il crew aggiorna il token a ogni kickoff, e gli strumenti personalizzati possono raggiungere l'API dei post con una chiave API.

headers

Il dizionario opzionale di header HTTP di MCPServerHTTP, con cui la documentazione di CrewAI mostra un bearer token nell'header Authorization.

create_static_tool_filter

Le liste consentite e bloccate degli strumenti di un server MCP in CrewAI, importate da crewai.mcp.filters.

30 seconds

L'attesa predefinita di CrewAI per una connessione MCP: un server irraggiungibile viene registrato come avviso e l'agente mantiene gli altri strumenti.

1 hour

Per quanto tempo dura un token di accesso MCP di easyCoexistence; un refresh token, valido 60 giorni, genera una nuova coppia.

90 days

Con quanto anticipo l'API dei post di easyCoexistence programma un post, da 1 minuto, copiando il media quando viene messo in coda.

Come carica un agente CrewAI gli strumenti di easyCoexistence?

Tramite il campo mcps, con un MCPServerHTTP per agente. Si connette via Streamable HTTP, il valore predefinito di CrewAI per questa classe, e invia gli header che gli dai, qui un header Authorization con un token di accesso di easyCoexistence. Un filtro statico sugli strumenti, creato con create_static_tool_filter, dà a ogni agente solo gli strumenti che servono al suo compito, e cache_tools_list conserva l'elenco dopo la prima connessione. CrewAI si connette su richiesta e, se un server non è raggiungibile, registra un avviso e lascia proseguire l'agente con gli altri strumenti, quindi leggi il log alla prima esecuzione. Il token di accesso arriva dall'helper della sezione successiva.

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

Da dove arriva il token di accesso del crew?

Da un solo accesso nel browser, poi da un aggiornamento a ogni kickoff. Il server MCP di easyCoexistence accetta solo token OAuth: registrazione dinamica del client, un codice di autorizzazione con PKCE, token di accesso che durano un'ora e refresh token che durano 60 giorni. Esegui una volta OAuthClientProvider dell'SDK Python MCP su una macchina con browser, e salva la registrazione e i token che restituisce; l'helper sotto usa la linea 1.x dell'SDK, che installa CrewAI. Prima di ogni kickoff, fresh_token scambia il refresh token salvato con l'endpoint dei token di easyCoexistence per una nuova coppia e la memorizza, quindi un crew che gira almeno una volta ogni 60 giorni non ha più bisogno del browser. Conserva il file salvato in un gestore di segreti, non nel repository.

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

Come può un crew pubblicare senza il server MCP?

Con uno strumento personalizzato che chiama l'API dei post di easyCoexistence, adatto a un crew avviato da un pianificatore quando non c'è nessuno. Crea una chiave API Partner nella dashboard, che inizia con ec_live_, e lo strumento sotto invia POST /api/v1/channels/:id/posts con il testo, il link del media, il tipo, publish_at. easyCoexistence copia il media quando il post viene messo in coda, rifiuta un link che in quel momento restituisce una pagina web o il formato sbagliato, e pubblica il post all'orario previsto; l'header Idempotency-Key evita che una chiamata ritentata lo metta in coda due volte. La stessa chiave legge i token di rete aggiornati da 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

Quale agente del crew deve avere quali strumenti?

I meno possibili che gli permettano di finire il suo compito, perché un agente può chiamare qualsiasi strumento che possiede. Un crew che pianifica e pubblica una settimana di contenuti divide il lavoro in modo che lettura, scrittura e pubblicazione siano in mano ad agenti diversi, e solo uno di loro può mettere qualcosa online. Non dare al redattore nessuno strumento di easyCoexistence: lavora con i risultati dell'analista e con il brief, e le sue didascalie arrivano al pianificatore come output del compito. Gli strumenti di pubblicazione accettano scheduled_at, quindi il pianificatore mette in coda i post per i loro orari invece di pubblicare nel momento in cui parte, e list_scheduled_posts gli permette di verificare cosa è in attesa. I post LinkedIn restano fuori dai crew: un agente ne prepara uno su richiesta, per esempio in Claude o ChatGPT, e una persona lo approva prima che esca.

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

Cosa richiedono i social ai post e alle risposte del crew?

Le regole dell'API di ciascun social, che vanno nei goal e nelle backstory degli agenti:

  • Media: un link HTTPS pubblico per ogni file. Instagram accetta immagini JPEG, i post foto di TikTok accettano JPEG o WebP, e un post di una Pagina Facebook accetta una foto o un video.
  • Orari: ISO 8601 con fuso orario, come 2026-11-20T09:00:00-03:00, da 1 minuto a 90 giorni in anticipo.
  • Commenti: le risposte su TikTok sono pubbliche e richiedono l'ID del video come post_id; un commento su Instagram o Facebook può ricevere una sola risposta privata entro 7 giorni.
  • Messaggi diretti (DM): Instagram e Messenger accettano risposte entro 24 ore dall'ultimo messaggio della persona; send_message di WhatsApp rispetta la stessa finestra, e send_template raggiunge chiunque altro.
  • Eventi: un commento o un DM arriva al crew solo tramite una tua rotta, impostata con set_social_webhook_destination, che può chiamare crew.kickoff con l'evento.

Errori comuni

  • Avviare un crew con il token di ieri. Un token di accesso di easyCoexistence scade un'ora dopo l'emissione, e CrewAI prosegue senza un server irraggiungibile, con solo un avviso nel log; chiama fresh_token a ogni kickoff.
  • Dare a ogni agente tutto il server. Senza tool_filter, un analista vede anche gli strumenti di pubblicazione; passa create_static_tool_filter con i nomi di cui il suo compito ha bisogno.
  • Scrivere publish_at o scheduled_at senza offset. easyCoexistence rifiuta un orario senza fuso orario, quindi chiudilo con Z o con un offset come -03:00.
  • Committare il file di accesso salvato. Il suo refresh token dà a chi lo possiede gli strumenti dell'account per fino a 60 giorni, quindi tienilo in un gestore di segreti.
Farlo con EasyCoexistence

easyCoexistence dà ai tuoi agenti CrewAI la possibilità di raggiungere i clienti su WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e altri canali, ciascuno tramite la sua API ufficiale: più di 35 strumenti MCP per la lista mcps di ogni agente, un'API dei post che mette in coda fino a 90 giorni in anticipo, ed eventi firmati per commenti e DM, con ogni connessione monitorata 24/7. Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Il client MCP di CrewAI esegue da solo l'accesso OAuth?

La sua documentazione mostra header, variabili d'ambiente e parametri di query per l'autenticazione, senza alcun flusso OAuth. Quindi il crew invia un bearer token che già possiede, fornito da un accesso con l'SDK Python MCP.

Un crew può rispondere ai commenti secondo il proprio calendario?

Sì. Un agente community manager con list_social_posts, list_social_comments e reply_to_comment può lavorare sui nuovi commenti a ogni esecuzione, ed è anche il modo in cui si leggono i commenti di YouTube e LinkedIn, perché nessuno dei due inoltra eventi.

Il crew può inviare messaggi WhatsApp?

Sì, con list_numbers, send_message e send_template nel filtro strumenti di un agente. send_message risponde ai clienti che hanno scritto nelle ultime 24 ore, e send_template invia un template approvato a chiunque altro.

Quanto costa easyCoexistence per un crew CrewAI?

Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, e lo stesso su ogni social. Il server MCP, l'API dei post e gli eventi inoltrati sono inclusi, con i primi 3 giorni di prova gratuita.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il