Prijavite seZapočnite besplatno probno razdoblje
easyCoexistence Službeni API-ji

Dajte CrewAI timu alate za Instagram, TikTok i WhatsApp

Tim CrewAI dobiva Instagram, TikTok, WhatsApp i još kanala kao alate kada polje mcps svakog agenta sadrži MCPServerHTTP za https://easycoexistence.com/api/mcp s OAuth pristupnim tokenom platforme easyCoexistence u zaglavlju Authorization. MCP klijent CrewAI-ja šalje zaglavlja umjesto da provodi prijavu, pa tim osvježava token pri svakom pokretanju, a prilagođeni alati se na API za objave mogu spojiti pomoću ključa.

headers

Opcijski rječnik HTTP zaglavlja u MCPServerHTTP-u, za koji CrewAI-jeva dokumentacija prikazuje Authorization bearer token.

create_static_tool_filter

Popisi za dopuštanje i blokiranje alata MCP poslužitelja, uvezeni iz crewai.mcp.filters.

30 seconds

CrewAI-jev zadani rok čekanja na MCP vezu; poslužitelj kojem se ne može pristupiti bilježi se kao upozorenje, a agent zadržava ostale alate.

1 hour

Koliko dugo traje pristupni token MCP-a platforme easyCoexistence; token za osvježavanje, koji vrijedi 60 dana, izdaje novi par.

90 days

Koliko unaprijed API za objave platforme easyCoexistence zakazuje objavu, od 1 minute, uz kopiranje medija kada se objava stavi u red.

Kako CrewAI agent učitava easyCoexistence alate?

Putem polja mcps, s jednim MCPServerHTTP po agentu. Povezuje se preko Streamable HTTP, zadanog načina CrewAI-ja za ovu klasu, i šalje zaglavlja koja mu zadajete, ovdje zaglavlje Authorization s pristupnim tokenom platforme easyCoexistence. Statički filtar alata, napravljen pomoću create_static_tool_filter, daje svakom agentu samo alate koje njegov zadatak treba, a cache_tools_list čuva popis nakon prve veze. CrewAI se povezuje po potrebi i, ako poslužitelj nije dostupan, bilježi upozorenje i agentu dopušta da radi s ostalim alatima, zato pročitajte dnevnik pri prvom pokretanju. Pristupni token dolazi iz pomoćne funkcije u sljedećem odjeljku.

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

Odakle timu pristupni token?

Iz jedne prijave u pregledniku, a zatim osvježavanja pri svakom pokretanju. Poslužitelj MCP-a platforme easyCoexistence prihvaća samo OAuth tokene: dinamičku registraciju klijenta, autorizacijski kod s PKCE, pristupne tokene koji traju jedan sat i tokene za osvježavanje koji traju 60 dana. Jednom pokrenite OAuthClientProvider iz MCP Python SDK-a na računalu s preglednikom i spremite registraciju i tokene koje vrati; pomoćna funkcija u nastavku koristi 1.x verziju SDK-a, koju CrewAI instalira. Prije svakog pokretanja fresh_token zamjenjuje spremljeni token za osvježavanje na endpointu za tokene easyCoexistence za novi par i ga pohranjuje, pa tim koji se pokrene barem jednom u 60 dana nikada ne mora ponovno otvarati preglednik. Spremljenu datoteku čuvajte u trezoru tajni, a ne u repozitoriju.

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

Kako tim može objavljivati bez MCP poslužitelja?

Prilagođenim alatom koji poziva API za objave platforme easyCoexistence, što odgovara timu koji pokreće planer kad nitko nije prisutan. Na nadzornoj ploči napravite Partner API ključ, koji počinje s ec_live_, a alat u nastavku šalje POST /api/v1/channels/:id/posts s tekstom, poveznicom na medij i vrstom te publish_at. easyCoexistence kopira medij kada se objava stavi u red, odbija poveznicu koja u tom trenutku vraća mrežnu stranicu ili pogrešan format te objavljuje objavu u njezino vrijeme; zaglavlje Idempotency-Key sprječava da ponovljeni poziv objavu stavi u red dvaput. Isti ključ čita svježe tokene za povezivanje s mrežom putem 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

Koji agent u timu treba koje alate?

Najmanje koliko mu treba da završi zadatak, jer agent može pozvati svaki alat koji ima. Tim koji planira i objavljuje tjedan sadržaja dijeli posao tako da čitanje, pisanje i objavljivanje budu kod različitih agenata, a samo jedan od njih može nešto objaviti. Piscu ne dajte nikakve alate platforme easyCoexistence: radi s nalazima analitičara i sažetkom zadatka, a njegovi natpisi stižu planeru kao izlaz zadatka. Alati za objavljivanje primaju scheduled_at, pa planer stavlja objave u red za njihova vremena umjesto da objavljuje čim se pokrene, a list_scheduled_posts omogućuje mu da provjeri što čeka. LinkedIn objave ostaju izvan timova: agent izrađuje svaku na zahtjev, primjerice u Claudeu ili ChatGPT-ju, a osoba je odobri prije nego što izađe.

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

Što mreže traže od objava i odgovora tima?

Pravila API-ja svake mreže, koja treba biti u ciljevima i pozadinama agenata:

  • Mediji: javna HTTPS poveznica za svaku datoteku. Instagram prihvaća JPEG slike, TikTok objave fotografija prihvaćaju JPEG ili WebP, a objava na Facebook stranici prima jednu fotografiju ili jedan video.
  • Vremena: ISO 8601 s vremenskom zonom, primjerice 2026-11-20T09:00:00-03:00, od 1 minute do 90 dana unaprijed.
  • Komentari: odgovori na TikToku javni su i trebaju ID videa kao post_id; Instagram ili Facebook komentar može dobiti jedan privatni odgovor u roku od 7 dana.
  • Izravne poruke: Instagram i Messenger primaju odgovore unutar 24 sata od posljednje poruke osobe; send_message za WhatsApp poštuje isti prozor, a send_template dopire do svih ostalih.
  • Događaji: komentar ili izravna poruka stiže timu samo preko vaše vlastite rute, postavljene pomoću set_social_webhook_destination, koja može pozvati crew.kickoff s događajem.

Uobičajene pogreške

  • Pokretanje tima s jučerašnjim tokenom. Pristupni token platforme easyCoexistence istječe sat vremena nakon izdavanja, a CrewAI nastavlja bez poslužitelja kojem se ne može pristupiti, uz samo upozorenje u dnevniku; pozovite fresh_token pri svakom pokretanju.
  • Davanje svakom agentu cijelog poslužitelja. Bez tool_filter, analitičar vidi i alate za objavljivanje; proslijedite create_static_tool_filter s imenima koja treba njegov zadatak.
  • Pisanje publish_at ili scheduled_at bez pomaka. easyCoexistence odbija vrijeme bez vremenske zone, pa ga završite s Z ili pomakom poput -03:00.
  • Stavljanje spremljene datoteke za prijavu u repozitorij. Njezin token za osvježavanje daje svakome tko ga drži alate računa do 60 dana, pa je čuvajte u trezoru tajni.
Radite ovo uz EasyCoexistence

easyCoexistence daje vašim CrewAI agentima pristup kupcima na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, svakom preko njegova službenog API-ja: više od 35 MCP alata za polje mcps svakog agenta, API za objave koji stavlja u red do 90 dana unaprijed i potpisane događaje za komentare i izravne poruke, uz praćenje svake veze 24 sata dnevno, svih sedam dana u tjednu. US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, s prvih 3 dana besplatno.

Često postavljana pitanja

Pokreće li CrewAI-jev MCP klijent sam OAuth prijavu?

Njegova dokumentacija prikazuje zaglavlja, varijable okoline i parametre upita za autentikaciju, bez OAuth tijeka. Tim zato šalje bearer token koji već ima, a jednu prijavu s MCP Python SDK-om daje upravo ta jedna prijava s MCP Python SDK-om.

Može li tim sam odgovarati na komentare prema vlastitom rasporedu?

Da. Agent za upravljanje zajednicom s alatima list_social_posts, list_social_comments i reply_to_comment može pri svakom pokretanju obraditi nove komentare, što je ujedno način na koji se čitaju komentari na YouTubeu i LinkedInu, jer nijedna od te dvije mreže ne šalje događaje.

Može li tim slati WhatsApp poruke?

Da, s alatima list_numbers, send_message i send_template u filtru alata agenta. send_message odgovara kupcima koji su pisali u posljednja 24 sata, a send_template šalje odobreni predložak svima ostalima.

Koliko košta easyCoexistence za CrewAI tim?

US$ 9 do US$ 0,75 po vezi mjesečno, uz pad kako dodajete veze, isto na svakoj mreži. MCP poslužitelj, API za objave i proslijeđeni događaji uključeni su, a prvih 3 dana je besplatno.

Nastavite čitati

Povežite svoj prvi kanal u dvije minute.

Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.

  • 3 dana besplatno
  • Otkažite bilo kada
  • Samo službeni API-ji
  • Nadzor 24/7

Provjereno na