AccediInizia la prova gratuita
easyCoexistence API ufficiali

Dai a un agente LangChain gli strumenti per Instagram, TikTok e WhatsApp

Un agente LangChain riceve Instagram, TikTok, WhatsApp e altri canali come strumenti dal server MCP di easyCoexistence su https://easycoexistence.com/api/mcp, caricato da MCPAdapter, il client MCP di LangChain, mentre FastMCP gestisce l'accesso OAuth. create_agent può poi pubblicare e programmare post, rispondere a commenti e DM e leggere le statistiche tramite le API ufficiali di ciascuna rete, mentre gli eventi firmati portano al tuo endpoint i nuovi commenti e messaggi.

Beta

L'etichetta di LangChain per il suo namespace langchain.mcp, che richiede langchain[mcp] 1.4.0 o successiva e include FastMCP.

In memory

Dove FastMCP conserva i token OAuth, a meno che token_storage non indichi un backend: un riavvio costringe ad accedere di nuovo.

127.0.0.1

L'indirizzo loopback del server di callback temporaneo che FastMCP avvia per l'accesso dal browser, su una porta libera o su callback_port.

60 days

Quanto dura un refresh token MCP di easyCoexistence; i token di accesso durano un'ora e ogni refresh ne emette una nuova coppia.

8 seconds

Il tempo di attesa di easyCoexistence per la risposta del tuo endpoint a un commento o DM inoltrato; l'evento viene inviato una sola volta e non viene mai ritentato.

Quali strumenti riceve da easyCoexistence un agente LangChain?

Più di 50, come normali strumenti LangChain che create_agent può chiamare. Gli strumenti social richiedono un account_id, quindi l'agente parte da list_social_accounts e passa i suoi ID a publish, read e reply per pubblicare, leggere e rispondere ai commenti, nasconderli e leggere le statistiche. Gli strumenti di una singola rete portano il suo nome, come publish_tiktok_post o upload_youtube_video, e un numero WhatsApp parte da list_numbers, che restituisce il connection_id richiesto da send_message e send_template. La descrizione di ogni strumento contiene le regole della rete, così il modello impara, ad esempio, che una risposta su TikTok è pubblica. Per programmare un post serve un argomento in più: scheduled_at inserisce il post nella coda di easyCoexistence.

Instagrampublish_instagram_post, reply_to_comment, send_social_dm, get_social_insights
TikTokpublish_tiktok_post, get_tiktok_publish_status, reply_to_comment with post_id
WhatsApplist_numbers, send_message, send_template, get_number_health
Facebookpublish_facebook_post, reply_to_comment, send_social_dm for Messenger
YouTube and LinkedInupload_youtube_video, reply_to_youtube_comment, publish_linkedin_post, get_linkedin_stats
The queuelist_scheduled_posts, update_scheduled_post, cancel_scheduled_post, retry_scheduled_post

Come accede l'agente a easyCoexistence?

Con l'helper OAuth di FastMCP, che MCPAdapter usa per l'autenticazione. Alla prima esecuzione individua il server di autorizzazione di easyCoexistence, si registra come client, apre il browser sulla schermata di consenso, dove viene mostrato il suo client_name, e riceve il codice su un callback locale su 127.0.0.1. Da quel momento i token di accesso si rinnovano senza browser. I token restano in memoria, a meno che l'helper non riceva un backend token_storage, quindi l'esempio li salva su disco, cifrati con una chiave Fernet. Filtra la lista prima che create_agent la riceva: gli strumenti tengono il client MCP, così l'agente continua a funzionare dopo la chiusura del blocco async with.

A reply agent's tools, with a sign-in that survives restarts
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)

Come arrivano commenti e DM a un agente LangChain?

Come richieste POST firmate verso un endpoint del tuo server, perché MCP risponde solo alle chiamate che fa l'agente. Collega ogni account all'endpoint con set_social_webhook_destination, da chiedere una volta all'agente oppure eseguito da Claude o ChatGPT, e conserva il signing_secret che restituisce. Instagram e Facebook inoltrano commenti, menzioni e DM, e TikTok inoltra i commenti; ogni evento riporta platform, account_id, external_id e la voce propria della rete. L'endpoint verifica X-EC-Signature, risponde subito, dato che easyCoexistence attende 8 secondi e non ritenta, e passa l'evento all'agente in background. Un checkpointer con un thread_id per ogni mittente di DM conserva la cronologia della conversazione.

A FastAPI route that verifies the event, then runs the agent
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}]})

Cosa consente ciascuna rete all'agente?

Quanto consente l'API della rete all'account. Le istruzioni dell'agente dovrebbero dirlo chiaramente:

  • DM di Instagram e Messenger: send_social_dm risponde alle persone che hanno scritto nelle ultime 24 ore, e Instagram limita un DM a 1.000 byte in UTF-8.
  • Risposte ai commenti: reply_to_comment risponde pubblicamente, oppure con private impostato su true invia un solo DM per ogni commento di Instagram o Facebook entro 7 giorni dal commento.
  • TikTok: le risposte sono sempre pubbliche e richiedono l'ID del video come post_id, e su TikTok non ci sono DM.
  • WhatsApp: send_message funziona entro 24 ore dall'ultimo messaggio del cliente, e send_template con un template approvato al di fuori di quella finestra.
  • Media: ogni file deve trovarsi su un link HTTPS pubblico; Instagram accetta immagini JPEG, e i post di foto su TikTok accettano JPEG o WebP.

Quando il codice deve chiamare le reti senza l'agente?

Quando un passaggio deve avvenire sempre allo stesso modo, o senza nessuno che acceda. get_social_credentials fornisce all'agente la base API di un account, il suo ID sulla rete e, su TikTok, YouTube e LinkedIn, un token valido in quel momento, e la Partner API restituisce lo stesso da GET /api/v1/channels/:id?credentials=1 con una chiave ec_live_, così un job Python può chiamare direttamente TikTok, Google o LinkedIn. Le risposte che devono partire a qualsiasi ora senza l'agente, come un testo fisso per una parola chiave, rientrano nelle regole sui commenti e nelle automazioni, che easyCoexistence gestisce da sé.

Errori comuni

  • Rispondere a eventi causati dall'account. Instagram rimanda i DM dell'account con is_echo impostato su true e restituisce le sue risposte pubbliche come commenti, quindi eliminali prima che l'agente li veda, o finirà per rispondere a se stesso.
  • Eseguire l'agente prima che l'endpoint risponda. easyCoexistence attende 8 secondi un 2xx e non ritenta mai, quindi un handler che aspetta il modello perde l'evento; rispondi per primo, lavora in background.
  • Chiamare reply_to_comment per un commento TikTok senza post_id. La risposta su TikTok indica sia il video sia il commento, quindi passa il video_id dell'evento come post_id.
  • Dare all'agente di risposta gli strumenti di pubblicazione. Filtra la lista per nome prima di create_agent, così un commento frainteso non potrà pubblicare, eliminare un post o modificare un'automazione.
Farlo con EasyCoexistence

easyCoexistence dà ai tuoi agenti LangChain accesso ai clienti su WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e altri canali, ciascuno tramite la sua API ufficiale: un server MCP dietro un unico accesso OAuth, eventi firmati di commenti e DM, e una coda che programma post fino a 90 giorni in anticipo, 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

L'agente ha bisogno di una propria app per sviluppatori di Meta, TikTok o Google?

No. Gli account si collegano tramite l'app di easyCoexistence su ciascuna rete, dalla dashboard o tramite un link di connessione della Partner API, e l'agente raggiunge tutti con un unico accesso a easyCoexistence.

L'agente può programmare i post invece di pubblicarli subito?

Sì. publish_instagram_post, publish_facebook_post, publish_tiktok_post e publish_linkedin_post accettano scheduled_at, un orario ISO 8601 con fuso orario, da 1 minuto a 90 giorni in anticipo. YouTube programma in modo nativo con upload_youtube_video e publish_at.

Quali modelli possono far girare l'agente?

Qualsiasi modello di chat che create_agent può usare con strumenti. Gli strumenti MCP non dipendono dal modello, e il fornitore del modello addebita il proprio consumo; easyCoexistence addebita per connessione, mai per chiamata di strumento.

Quanto costa easyCoexistence per un agente LangChain?

Da US$ 9 a US$ 0,75 per connessione al mese, in calo man mano che aggiungi connessioni, uguale su ciascuna rete. Il server MCP, gli eventi inoltrati e la Partner API sono inclusi, e i primi 3 giorni di prova gratuita sono inclusi.

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