Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Anna CrewAI-tiimille työkalut Instagramiin, TikTokiin ja WhatsAppiin

CrewAI-tiimi saa työkaluina Instagram-, TikTok- ja WhatsApp-kanavat sekä muita kanavia, kun jokaisen agentin mcps-lista sisältää MCPServerHTTP:n osoitteelle https://easycoexistence.com/api/mcp ja easyCoexistencen OAuth-käyttötokenin Authorization-otsakkeessa. CrewAI:n MCP-asiakas lähettää otsakkeita eikä suorita kirjautumista, joten tiimi uusii tokenin jokaisen kickoffin yhteydessä. Omat työkalut voivat sen sijaan käyttää posts API:a avaimella.

headers

MCPServerHTTP:n valinnainen HTTP-otsakkeiden sanakirja, jolla CrewAI:n dokumentaatio kuljettaa Authorization bearer -tokenin.

create_static_tool_filter

CrewAI:n sallinta- ja estolista MCP-palvelimen työkaluille, tuotu crewai.mcp.filters-moduulista.

30 seconds

CrewAI:n oletusaika MCP-yhteyden odottamiseen; palvelin, johon ei saada yhteyttä, kirjataan varoitukseksi ja agentti jatkaa muilla työkaluillaan.

1 hour

Kuinka kauan easyCoexistencen MCP-käyttötoken on voimassa; päivitystoken, joka on voimassa 60 päivää, tuottaa uuden parin.

90 days

Kuinka pitkälle easyCoexistencen posts API ajastaa julkaisun eteenpäin, 1 minuutista alkaen, ja kopioi median jonoon asetettaessa.

Miten CrewAI-agentti lataa easyCoexistencen työkalut?

mcps-kentän kautta, yksi MCPServerHTTP jokaista agenttia kohden. Yhteys muodostetaan Streamable HTTP:llä, joka on CrewAI:n oletus tälle luokalle, ja se lähettää antamasi otsakkeet, tässä Authorization-otsakkeen, joka sisältää easyCoexistencen käyttötokenin. Staattinen työkalusuodatin, joka tehdään create_static_tool_filter-funktiolla, antaa jokaiselle agentille vain sen tehtävän tarvitsemat työkalut, ja cache_tools_list säilyttää listan ensimmäisen yhteyden jälkeen. CrewAI muodostaa yhteyden tarvittaessa, ja jos palvelimeen ei saada yhteyttä, se kirjaa varoituksen ja antaa agentin jatkaa muilla työkaluillaan, joten lue loki ensimmäisellä ajokerralla. Käyttötoken tulee seuraavan osion apufunktiosta.

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

Mistä tiimin käyttötoken tulee?

Yhdestä selaimessa tehdystä kirjautumisesta ja sen jälkeen uusinnasta jokaisen käynnistyksen yhteydessä. easyCoexistencen MCP-palvelin hyväksyy vain OAuth-tokenit: dynaamisen asiakasrekisteröinnin, valtuutuskoodin PKCE:llä sekä käyttötokenit, jotka ovat voimassa tunnin, ja päivitystokenit, jotka ovat voimassa 60 päivää. Aja MCP Python SDK:n OAuthClientProvider kerran koneella, jossa on selain, ja tallenna rekisteröinti ja tokenit, jotka se palauttaa. Alla oleva apufunktio käyttää SDK:n 1.x-linjaa, jonka CrewAI asentaa. Ennen jokaista käynnistystä fresh_token vaihtaa tallennetun päivitystokenin easyCoexistencen token-päätepisteessä uuteen pariin ja tallentaa sen, joten tiimi, joka käynnistyy vähintään kerran 60 päivän aikana, ei koskaan tarvitse selainta uudelleen. Säilytä tallennettu tiedosto salaisuuksien hallinnassa, ei repositoriossa.

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

Miten tiimi voi julkaista ilman MCP-palvelinta?

Omalla työkalulla, joka kutsuu easyCoexistencen posts API:a. Se sopii tiimille, jonka ajastin käynnistää ilman valvojaa. Luo hallintapaneelissa Partner API -avain, jonka alkuosa on ec_live_, ja alla oleva työkalu lähettää POST /api/v1/channels/:id/posts -pyynnön tekstin, median linkin ja tyypin sekä publish_at-ajan kanssa. easyCoexistence kopioi median, kun julkaisu asetetaan jonoon, hylkää linkin, joka palauttaa verkkosivun tai väärän muodon sillä hetkellä, ja julkaisee viestin ajallaan. Idempotency-Key-otsake estää uudelleen yritetyn kutsun jonottamasta julkaisua kahdesti. Sama avain lukee tuoreet verkkotokenit pyynnöstä 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

Mitkä agentit tiimissä saavat mitkäkin työkalut?

Vähiten, joilla se pystyy suorittamaan tehtävänsä, koska agentti voi kutsua mitä tahansa työkalua, jonka se pitää hallussaan. Tiimi, joka suunnittelee ja julkaisee viikon sisällön, jakaa työn niin, että lukeminen, kirjoittaminen ja julkaiseminen ovat eri agenteilla, ja vain yksi heistä voi laittaa mitään julkiseksi. Älä anna kirjoittajalle lainkaan easyCoexistencen työkaluja: se työskentelee analyytikon havaintojen ja briiffin pohjalta, ja sen kuvatekstit siirtyvät ajastimelle tehtävän tulosteena. Julkaisutyökalut ottavat scheduled_at-kentän, joten ajastin jonottaa julkaisut niiden ajankohtiin sen sijaan, että julkaisisi heti ajon alkaessa, ja list_scheduled_posts antaa sille mahdollisuuden varmistaa, mitä odottaa. LinkedIn-julkaisut jätetään tiimien ulkopuolelle: agentti laatii jokaisen pyynnöstä, esimerkiksi Claudessa tai ChatGPT:ssä, ja ihminen hyväksyy sen ennen julkaisua.

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

Mitä verkostot vaativat tiimin julkaisuilta ja vastauksilta?

Kunkin verkoston API:n säännöt, jotka kuuluvat agenttien tavoitteisiin ja taustatarinoihin:

  • Media: julkinen HTTPS-linkki jokaiseen tiedostoon. Instagram hyväksyy JPEG-kuvat, TikTok-kuvajulkaisut JPEG- tai WebP-muodossa, ja Facebook-sivun julkaisu yhden kuvan tai yhden videon.
  • Ajat: ISO 8601 aikavyöhykkeen kanssa, esimerkiksi 2026-11-20T09:00:00-03:00, 1 minuutista 90 päivään eteenpäin.
  • Kommentit: TikTok-vastaukset ovat julkisia ja vaativat videon ID:n post_id-kentässä. Instagram- tai Facebook-kommenttiin voi vastata kerran yksityisesti 7 päivän sisällä.
  • Yksityisviestit: Instagram ja Messenger hyväksyvät vastaukset 24 tunnin sisällä henkilön viimeisimmästä viestistä. WhatsAppin send_message noudattaa samaa ikkunaa, ja send_template tavoittaa kaikki muut.
  • Tapahtumat: kommentti tai yksityisviesti saavuttaa tiimin vain oman reitityksesi kautta, joka asetetaan set_social_webhook_destination-funktiolla ja joka voi kutsua crew.kickoff-funktiota tapahtumalla.

Yleiset virheet

  • Tiimin käynnistys vanhalla tokenilla. easyCoexistencen käyttötoken vanhenee tunnin kuluttua myöntämisestä, ja CrewAI jatkaa ilman palvelinta, johon ei saada yhteyttä, pelkällä varoituksella lokissa. Kutsu fresh_token jokaisen kickoffin yhteydessä.
  • Koko palvelin jokaiselle agentille. Ilman tool_filter-suodatinta analyytikko näkee myös julkaisutyökalut, joten anna create_static_tool_filter sen tehtävän tarvitsemilla nimillä.
  • publish_at- tai scheduled_at-ajan kirjoittaminen ilman siirtymää. easyCoexistence hylkää ajan, jolta puuttuu aikavyöhyke, joten lopeta se merkkiin Z tai siirtymään, kuten -03:00.
  • Tallennetun kirjautumistiedoston commitointi. Sen päivitystoken antaa kenelle tahansa sen haltijalle tilin työkalut jopa 60 päiväksi, joten säilytä tiedosto salaisuuksien hallinnassa.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa CrewAI-agenteillesi yhteyden asiakkaisiin WhatsAppissa, Instagramissa, Facebookissa, TikTokissa, YouTubessa, LinkedInissä ja muissa kanavissa, kukin virallisen API:n kautta: yli 35 MCP-työkalua jokaisen agentin mcps-listalle, posts API, joka jonottaa jopa 90 päivää eteenpäin, sekä allekirjoitetut tapahtumat kommenteille ja yksityisviesteille. Jokainen yhteys valvotaan ympäri vuorokauden. Hinta alkaen US$ 9 ja laskien US$ 0,75:een per yhteys kuukaudessa, kun yhteyksiä lisätään, ja kolmen ensimmäisen päivän ilmainen kokeilu.

Usein kysytyt kysymykset

Suorittaako CrewAI:n MCP-asiakas OAuth-kirjautumisen itse?

Sen dokumentaatio näyttää otsakkeet, ympäristömuuttujat ja kyselyparametrit todennukseen, eikä siinä ole OAuth-virtaa. Tiimi lähettää siis bearer-tokenin, jonka se jo pitää hallussaan, ja sen tuottaa yksi kirjautuminen MCP Python SDK:lla.

Voiko tiimi vastata kommentteihin omalla aikataulullaan?

Kyllä. Yhteisönhoitoagentti, jolla on list_social_posts, list_social_comments ja reply_to_comment, voi käydä läpi uudet kommentit jokaisella ajolla. Näin luetaan myös YouTuben ja LinkedInin kommentit, koska kumpikaan ei lähetä tapahtumia eteenpäin.

Voiko tiimi lähettää WhatsApp-viestejä?

Kyllä, kun agentin suodattimessa ovat list_numbers, send_message ja send_template. send_message vastaa asiakkaille, jotka ovat kirjoittaneet viimeisen 24 tunnin aikana, ja send_template lähettää hyväksytyn viestipohjan kenelle tahansa muulle.

Mitä easyCoexistence maksaa CrewAI-tiimille?

Alkaen US$ 9 ja laskien US$ 0,75:een per yhteys kuukaudessa, kun yhteyksiä lisätään, sama hinta joka verkossa. MCP-palvelin, posts API ja välitetyt tapahtumat sisältyvät hintaan, ja kolmen ensimmäisen päivän ilmainen kokeilu on käytettävissä.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu