Dale a un agente de LangChain herramientas para Instagram, TikTok y WhatsApp
Un agente de LangChain recibe Instagram, TikTok, WhatsApp y más canales como herramientas desde el servidor MCP de easyCoexistence en https://easycoexistence.com/api/mcp, cargadas por MCPAdapter, el cliente MCP de LangChain, y FastMCP ejecuta el inicio de sesión OAuth. Así, create_agent puede publicar y programar publicaciones, responder comentarios y DMs y leer métricas mediante la API oficial de cada red, mientras los eventos firmados llevan a tu ruta los nuevos comentarios y mensajes.
La etiqueta de LangChain para su espacio de nombres langchain.mcp, que requiere langchain[mcp] 1.4.0 o posterior e incluye FastMCP.
Dónde guarda FastMCP los tokens OAuth si token_storage no indica un backend, así que reiniciar implica volver a iniciar sesión.
La dirección de loopback del servidor de callback temporal que FastMCP inicia para el inicio de sesión en el navegador, en un puerto libre o en callback_port.
Cuánto dura un refresh token de MCP de easyCoexistence; los access tokens duran una hora y cada renovación emite un nuevo par.
Cuánto espera easyCoexistence a que tu ruta responda a un comentario o DM reenviado; se envía una vez y nunca se reintenta.
¿Qué herramientas recibe un agente de LangChain de easyCoexistence?
Más de 50, como herramientas habituales de LangChain que create_agent puede invocar. Las herramientas sociales reciben un account_id, así que el agente empieza con list_social_accounts y pasa sus IDs a publicar, leer, responder comentarios, ocultarlos y leer métricas. Las herramientas de una sola red llevan su nombre, como publish_tiktok_post o upload_youtube_video, y un número de WhatsApp empieza en list_numbers, que devuelve el connection_id que usan send_message y send_template. La descripción de cada herramienta incluye las reglas de la red, así que el modelo aprende, por ejemplo, que una respuesta en TikTok es pública. Publicar después requiere un argumento más: scheduled_at pone la publicación en la cola de easyCoexistence.
¿Cómo inicia sesión el agente en easyCoexistence?
Con el asistente OAuth de FastMCP, que MCPAdapter usa para la autenticación. En la primera ejecución descubre el servidor de autorización de easyCoexistence, se registra como cliente, abre el navegador en la pantalla de consentimiento, donde se muestra su client_name, y recibe el código en un callback local en 127.0.0.1. Después, los access tokens se renuevan sin navegador. Los tokens quedan en memoria salvo que el asistente reciba un backend token_storage, así que el ejemplo los guarda en disco, cifrados con una clave Fernet. Filtra la lista antes de que create_agent la vea: las herramientas mantienen el cliente MCP, así que el agente sigue funcionando después de cerrar el bloque async with.
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)¿Cómo llegan los comentarios y DMs a un agente de LangChain?
Como peticiones POST firmadas a una ruta tuya, porque MCP solo responde a las llamadas que hace el agente. Asigna la ruta a cada cuenta con set_social_webhook_destination, que se pide al agente una vez o se ejecuta desde Claude o ChatGPT, y guarda el signing_secret que devuelve. Instagram y Facebook reenvían comentarios, menciones y DMs, y TikTok reenvía comentarios; cada evento incluye platform, account_id, external_id y la entrada propia de la red. La ruta verifica X-EC-Signature, responde de inmediato, ya que easyCoexistence espera 8 segundos y no reintenta, y entrega el evento al agente en segundo plano. Un checkpointer con un thread_id por remitente de DM conserva el historial de cada conversación.
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}]})¿Qué permite cada red al agente?
Lo que permite la API de la red a la cuenta; las instrucciones del agente deberían indicarlo con claridad:
- DMs de Instagram y Messenger:
send_social_dmresponde a personas que escribieron en las últimas 24 horas, y Instagram limita un DM a 1,000 bytes en UTF-8. - Respuestas a comentarios:
reply_to_commentresponde en público, o con private en true envía un DM por comentario de Instagram o Facebook dentro de los 7 días posteriores a este. - TikTok: las respuestas son siempre públicas y requieren el ID del video como
post_id, y TikTok no tiene DMs. - WhatsApp:
send_messagefunciona dentro de las 24 horas posteriores al último mensaje del cliente, ysend_templatecon una plantilla aprobada fuera de ese plazo. - Medios: cada archivo debe estar en un enlace HTTPS público; Instagram acepta imágenes JPEG, y las publicaciones de foto de TikTok aceptan JPEG o WebP.
¿Cuándo debe el código llamar a las redes sin el agente?
Cuando un paso debe ocurrir siempre igual, o sin nadie presente para iniciar sesión. get_social_credentials entrega al agente la base de la API de una cuenta, su ID en la red y, en TikTok, YouTube y LinkedIn, un token válido en este momento, y la Partner API devuelve lo mismo desde GET /api/v1/channels/:id?credentials=1 con una clave ec_live_, así que un trabajo en Python puede llamar directamente a TikTok, Google o LinkedIn. Las respuestas que deben salir a cualquier hora sin el agente, como un texto fijo para una palabra clave, encajan en las reglas de comentarios y automatizaciones, que easyCoexistence ejecuta por sí mismo.
Errores comunes
- Responder a eventos que causa la propia cuenta. Instagram repite los DMs de la cuenta con is_echo en true y devuelve sus respuestas públicas como comentarios, así que elimínalos antes de que los vea el agente, o acabará respondiéndose a sí mismo.
- Ejecutar el agente antes de que la ruta responda. easyCoexistence espera 8 segundos un 2xx y nunca reintenta, así que un manejador que espera al modelo pierde el evento; responde primero y trabaja en segundo plano.
- Llamar a reply_to_comment para un comentario de TikTok sin post_id. La respuesta de TikTok nombra también el video, así que pasa el video_id del evento como post_id.
- Dar al agente de respuestas las herramientas de publicación. Filtra la lista por nombre antes de create_agent, para que un comentario mal interpretado no pueda publicar, borrar una publicación ni cambiar una automatización.
easyCoexistence da a tus agentes de LangChain alcance hacia clientes en WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn y más canales, cada uno a través de su API oficial: un servidor MCP tras un inicio de sesión OAuth, eventos firmados de comentarios y DMs, y una cola que programa publicaciones con hasta 90 días de antelación, con cada conexión monitoreada 24/7. De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, con los primeros 3 días gratis.
Preguntas frecuentes
¿El agente necesita su propia app de desarrollador de Meta, TikTok o Google?
No. Las cuentas se conectan mediante la app propia de easyCoexistence en cada red, desde el panel o con un enlace de conexión de la Partner API, y el agente accede a todas con un único inicio de sesión de easyCoexistence.
¿El agente puede programar publicaciones en vez de publicar al momento?
Sí. publish_instagram_post, publish_facebook_post, publish_tiktok_post y publish_linkedin_post reciben scheduled_at, una hora ISO 8601 con zona horaria, desde 1 minuto y con hasta 90 días de antelación. YouTube programa de forma nativa con upload_youtube_video y publish_at.
¿Qué modelos pueden ejecutar el agente?
Cualquier modelo de chat que create_agent pueda usar con herramientas. Las herramientas MCP no dependen del modelo, y el proveedor del modelo cobra su propio uso; easyCoexistence cobra por conexión, nunca por llamada a herramienta.
¿Cuánto cuesta easyCoexistence para un agente de LangChain?
De US$ 9 a US$ 0.75 por conexión al mes, bajando a medida que añades conexiones, y lo mismo en cada red. El servidor MCP, los eventos reenviados y la Partner API están incluidos, y los primeros 3 días son gratis.
Sigue leyendo
Conecta tu primer canal en dos minutos.
Sin esperar revisiones de las plataformas. Conecta WhatsApp, Instagram, TikTok u otro canal, pídele a tu IA que publique, responda o te haga un informe, y míralo trabajar.
- 3 días gratis
- Cancela cuando quieras
- Solo APIs oficiales
- Monitorizado 24/7
Verificado el