Iniciar sesiónEmpezar prueba gratis
easyCoexistence APIs oficiales

Dale a un crew de CrewAI herramientas para Instagram, TikTok y WhatsApp

Un crew de CrewAI recibe Instagram, TikTok, WhatsApp y más canales como herramientas cuando la lista mcps de cada agente incluye un MCPServerHTTP para https://easycoexistence.com/api/mcp con un token de acceso OAuth de easyCoexistence en su cabecera Authorization. El cliente MCP de CrewAI envía cabeceras en lugar de iniciar sesión, así que el crew renueva el token en cada kickoff, y las herramientas personalizadas pueden llegar a la API de publicaciones con una clave en su lugar.

headers

El diccionario opcional de cabeceras HTTP de MCPServerHTTP, que la documentación de CrewAI muestra con un token bearer en Authorization.

create_static_tool_filter

Las listas de permitidos y bloqueados de CrewAI para las herramientas de un servidor MCP, importadas desde crewai.mcp.filters.

30 seconds

La espera predeterminada de CrewAI para una conexión MCP; un servidor inalcanzable se registra como advertencia y el agente conserva sus demás herramientas.

1 hour

Cuánto dura un token de acceso del MCP de easyCoexistence; un token de actualización, válido 60 días, entrega un nuevo par.

90 days

Con cuánta antelación la API de publicaciones de easyCoexistence programa una publicación, desde 1 minuto, copiando el contenido multimedia al ponerla en cola.

¿Cómo carga un agente de CrewAI las herramientas de easyCoexistence?

A través del campo mcps, con un MCPServerHTTP por agente. Se conecta mediante Streamable HTTP, el valor predeterminado de CrewAI para esta clase, y envía las cabeceras que le indiques, aquí una cabecera Authorization con un token de acceso de easyCoexistence. Un filtro de herramientas estático, creado con create_static_tool_filter, da a cada agente solo las herramientas que necesita su tarea, y cache_tools_list conserva la lista tras la primera conexión. CrewAI se conecta bajo demanda y, si un servidor no responde, registra una advertencia y deja que el agente siga con sus demás herramientas, así que revisa el registro en la primera ejecución. El token de acceso sale del asistente de la siguiente sección.

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 dónde sale el token de acceso del crew?

De un solo inicio de sesión en el navegador y luego una renovación en cada kickoff. El servidor MCP de easyCoexistence acepta solo tokens OAuth: registro dinámico de cliente, código de autorización con PKCE, tokens de acceso que duran una hora y tokens de actualización que duran 60 días. Ejecuta una vez OAuthClientProvider del SDK de Python de MCP, en una máquina con navegador, y guarda el registro y los tokens que devuelve; el asistente de abajo usa la línea 1.x del SDK, que CrewAI instala. Antes de cada kickoff, fresh_token cambia el token de actualización guardado por un nuevo par en el endpoint de tokens de easyCoexistence y lo almacena, así que un crew que se ejecuta al menos una vez cada 60 días nunca vuelve a necesitar el navegador. Guarda el archivo en un almacén de secretos, no en el repositorio.

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

¿Cómo puede un crew publicar sin el servidor MCP?

Con una herramienta personalizada que llama a la API de publicaciones de easyCoexistence, lo que encaja con un crew iniciado por un programador sin nadie presente. Crea una clave de API de socio en el panel, que empieza por ec_live_, y la herramienta de abajo envía POST /api/v1/channels/:id/posts con el texto, el enlace del contenido multimedia, su tipo y publish_at. easyCoexistence copia el contenido multimedia al poner la publicación en cola, rechaza en ese momento un enlace que devuelva una página web o un formato incorrecto, y publica la publicación a su hora; la cabecera Idempotency-Key evita que una llamada reintentada la ponga en cola dos veces. La misma clave lee credenciales de red actualizadas desde 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

¿Qué agente del crew debe tener qué herramientas?

Las menos que le permitan terminar su tarea, porque un agente puede llamar a cualquier herramienta que tenga. Un crew que planifica y publica una semana de contenido reparte el trabajo para que leer, escribir y publicar estén en agentes distintos, y solo uno de ellos puede dejar algo publicado. No des al redactor ninguna herramienta de easyCoexistence: trabaja a partir de los hallazgos del analista y del brief, y sus textos llegan al programador como salida de la tarea. Las herramientas de publicación aceptan scheduled_at, así que el programador pone las publicaciones en cola para sus horas en lugar de publicar en el momento en que se ejecuta, y list_scheduled_posts le permite confirmar qué está pendiente. Las publicaciones de LinkedIn quedan fuera de los crews: un agente redacta cada una a petición, por ejemplo en Claude o ChatGPT, y una persona la aprueba antes de que salga.

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

¿Qué exigen las redes a las publicaciones y respuestas del crew?

Las reglas de la API de cada red, que van en los goals y backstories de los agentes:

  • Contenido multimedia: un enlace HTTPS público por archivo. Instagram acepta imágenes JPEG, las publicaciones de foto de TikTok aceptan JPEG o WebP, y una publicación en una Página de Facebook admite una foto o un vídeo.
  • Horarios: ISO 8601 con zona horaria, como 2026-11-20T09:00:00-03:00, desde 1 minuto hasta 90 días de antelación.
  • Comentarios: las respuestas en TikTok son públicas y necesitan el ID del vídeo como post_id; un comentario en Instagram o Facebook puede recibir una respuesta privada dentro de 7 días.
  • Mensajes directos (DM): Instagram y Messenger aceptan respuestas dentro de las 24 horas del último mensaje de la persona; send_message de WhatsApp respeta la misma ventana de atención, y send_template llega a cualquier otra persona.
  • Eventos: un comentario o mensaje directo llega al crew solo por tu propia ruta, configurada con set_social_webhook_destination, que puede llamar a crew.kickoff con el evento.

Errores comunes

  • Iniciar un crew con el token de ayer. Un token de acceso de easyCoexistence caduca una hora después de emitirse, y CrewAI sigue sin un servidor al que no puede llegar, con solo una advertencia en el registro; llama a fresh_token en cada kickoff.
  • Dar a cada agente el servidor completo. Sin tool_filter, un analista también ve las herramientas de publicación; pasa create_static_tool_filter con los nombres que necesita su tarea.
  • Escribir publish_at o scheduled_at sin desfase horario. easyCoexistence rechaza una hora sin zona horaria, así que termínala en Z o en un desfase como -03:00.
  • Confirmar en el repositorio el archivo de inicio de sesión guardado. Su token de actualización da a quien lo tenga las herramientas de la cuenta durante hasta 60 días, así que guárdalo en un almacén de secretos.
Hacerlo con EasyCoexistence

easyCoexistence da a tus agentes de CrewAI alcance a clientes en WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn y más canales, cada uno a través de su API oficial: más de 35 herramientas MCP para la lista mcps de cada agente, una API de publicaciones que pone en cola hasta 90 días de antelación, y eventos firmados para comentarios y mensajes directos, con cada conexión supervisada las 24 horas. De US$ 9 a US$ 0.75 por conexión al mes, con descuento al añadir conexiones, y con los primeros 3 días gratis.

Preguntas frecuentes

¿El cliente MCP de CrewAI ejecuta por sí mismo el inicio de sesión OAuth?

Su documentación muestra cabeceras, variables de entorno y parámetros de consulta para la autenticación, sin ningún flujo OAuth. Por eso el crew envía un token bearer que ya tiene, que proporciona un inicio de sesión con el SDK de Python de MCP.

¿Puede un crew responder a los comentarios según su propio calendario?

Sí. Un agente de gestión de comunidad con list_social_posts, list_social_comments y reply_to_comment puede revisar los comentarios nuevos en cada ejecución, que es también como se leen los comentarios de YouTube y LinkedIn, ya que ninguno de los dos reenvía eventos.

¿Puede el crew enviar mensajes de WhatsApp?

Sí, con list_numbers, send_message y send_template en el filtro de herramientas de un agente. send_message responde a los clientes que escribieron en las últimas 24 horas, y send_template envía una plantilla aprobada a cualquier otra persona.

¿Cuánto cuesta easyCoexistence para un crew de CrewAI?

De US$ 9 a US$ 0.75 por conexión al mes, con descuento al añadir conexiones, y lo mismo en cada red. El servidor MCP, la API de publicaciones y los eventos reenviados están incluidos, con los primeros 3 días 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