IngiaAnza kipindi cha majaribio bila malipo
easyCoexistence API rasmi

Ipe timu ya CrewAI zana za Instagram, TikTok na WhatsApp

Timu ya CrewAI hupata Instagram, TikTok, WhatsApp na chaneli nyingine zaidi kama zana, wakati orodha ya mcps ya kila wakala ina MCPServerHTTP ya https://easycoexistence.com/api/mcp yenye access token ya easyCoexistence ya OAuth kwenye kichwa chake cha Authorization. Mteja wa MCP wa CrewAI hutuma vichwa vya HTTP badala ya kufanya kuingia, kwa hiyo timu huonyesha upya token kila inapoanza kazi, na zana maalum zinaweza kufikia posts API kwa kutumia ufunguo badala yake.

headers

Kamusi ya hiari ya vichwa vya HTTP ya MCPServerHTTP, ambayo nyaraka za CrewAI zinaonyesha ikibeba bearer token ya Authorization.

create_static_tool_filter

Orodha za kuruhusu na kuzuia za zana za seva ya MCP ya CrewAI, zilizoingizwa kutoka crewai.mcp.filters.

30 seconds

Muda chaguo-msingi wa CrewAI wa kusubiri muunganisho wa MCP; seva isiyofikiwa huandikwa kama onyo na wakala huendelea na zana zake nyingine.

1 hour

Muda ambao access token ya MCP ya easyCoexistence hudumu; refresh token, halali kwa siku 60, hutoa jozi mpya.

90 days

Umbali wa mbele ambao posts API ya easyCoexistence huratibu chapisho, kuanzia dakika 1, ikinakili media chapisho linapowekwa kwenye foleni.

Wakala wa CrewAI hupakia vipi zana za easyCoexistence?

Kupitia sehemu ya mcps, yenye MCPServerHTTP moja kwa kila wakala. Huunganishwa kupitia Streamable HTTP, chaguo-msingi la CrewAI kwa darasa hili, na hutuma vichwa unavyotoa, hapa kichwa cha Authorization chenye access token ya easyCoexistence. Kichujio tuli cha zana, kilichoundwa na create_static_tool_filter, humpa kila wakala zana zinazohitajika na kazi yake pekee, na cache_tools_list huhifadhi orodha baada ya muunganisho wa kwanza. CrewAI huunganisha inapohitajika, na seva isipofikiwa huandika onyo na kuruhusu wakala aendelee na zana zake nyingine, kwa hiyo soma kumbukumbu ya onyo kwenye jaribio la kwanza. Access token hutoka kwa msaidizi wa sehemu inayofuata.

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

Access token ya timu inatoka wapi?

Kutoka kwa kuingia mara moja kwenye kivinjari, kisha kuonyesha upya kila kazi inapoanza. Seva ya MCP ya easyCoexistence inakubali token za OAuth pekee: usajili wa mteja wa kiotomatiki, msimbo wa idhini wenye PKCE, access token zinazodumu saa moja na refresh token zinazodumu siku 60. Endesha OAuthClientProvider ya MCP Python SDK mara moja, kwenye kompyuta yenye kivinjari, na hifadhi usajili na token zilizorudishwa; msaidizi hapa chini unatumia toleo la 1.x la SDK, ambalo CrewAI husakinisha. Kabla ya kila kuanza kazi, fresh_token hubadilisha refresh token iliyohifadhiwa kwenye kituo cha token cha easyCoexistence kwa jozi mpya na kuihifadhi, kwa hiyo timu inayoendeshwa angalau mara moja ndani ya siku 60 haihitaji kivinjari tena. Weka faili iliyohifadhiwa kwenye hifadhi ya siri, si kwenye hazina ya msimbo.

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

Timu inaweza kuchapisha bila seva ya MCP?

Ndiyo, kwa zana maalum inayopiga posts API ya easyCoexistence, inayofaa timu inayoanzishwa na kipanga ratiba bila mtu karibu. Tengeneza Partner API key kwenye dashibodi, inayoanza na ec_live_, na zana iliyo hapa chini inatuma POST /api/v1/channels/:id/posts yenye maandishi, kiungo cha media, aina yake, pamoja na publish_at. easyCoexistence hunakili media chapisho linapowekwa kwenye foleni, hukataa kiungo kinachorudisha ukurasa wa wavuti au muundo usio sahihi wakati huo, na huchapisha chapisho saa yake; kichwa cha Idempotency-Key huzuia wito uliojaribiwa upya kuliweka kwenye foleni mara mbili. Ufunguo huo huo husoma token mpya za mtandao kutoka 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

Wakala gani katika timu ashikilie zana zipi?

Zile chache zinazomwezesha kumaliza kazi yake, kwa sababu wakala anaweza kuita zana yoyote aliyonayo. Timu inayopanga na kuchapisha maudhui ya wiki nzima hugawa kazi ili kusoma, kuandika na kuchapisha vikae kwa mawakala tofauti, na mmoja pekee ndiye anayeweza kuweka chochote hewani. Mwandishi asipewe zana zozote za easyCoexistence: hufanya kazi kwa matokeo ya mchambuzi na maelekezo, na maandishi yake hufika kwa kipanga ratiba kama matokeo ya kazi. Zana za kuchapisha hupokea scheduled_at, kwa hiyo kipanga ratiba huweka machapisho kwenye foleni kwa nyakati zao badala ya kuchapisha wakati linapoendeshwa, na list_scheduled_posts humwezesha kuthibitisha yaliyo kwenye foleni. Machapisho ya LinkedIn yasiwe kwenye timu: wakala huandaa kila moja kwa ombi, kwa mfano kwenye Claude au ChatGPT, na mtu huidhinisha kabla haijatoka.

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

Mitandao inahitaji nini kwa machapisho na majibu ya timu?

Kanuni za API ya kila mtandao, ambazo zinapaswa kuwemo kwenye malengo na historia za mawakala:

  • Media: kiungo cha HTTPS cha umma kwa kila faili. Instagram inakubali picha za JPEG, machapisho ya picha ya TikTok yanakubali JPEG au WebP, na chapisho la ukurasa wa Facebook linakubali picha moja au video moja.
  • Nyakati: ISO 8601 yenye saa za eneo, kwa mfano 2026-11-20T09:00:00-03:00, kuanzia dakika 1 hadi siku 90 mbele.
  • Maoni: majibu ya TikTok ni ya umma na yanahitaji ID ya video kama post_id; maoni ya Instagram au Facebook yanaweza kupata jibu moja la faragha ndani ya siku 7.
  • Ujumbe wa moja kwa moja: Instagram na Messenger hupokea majibu ndani ya saa 24 tangu ujumbe wa mwisho wa mtu; send_message ya WhatsApp hufuata dirisha lilelile, na send_template hufika kwa mtu mwingine yeyote.
  • Matukio: maoni au ujumbe wa moja kwa moja hufika kwa timu kupitia njia yako mwenyewe, iliyowekwa kwa set_social_webhook_destination, ambayo inaweza kuita crew.kickoff pamoja na tukio.

Makosa ya kawaida

  • Kuanzisha timu kwa token ya jana. Access token ya easyCoexistence huisha saa moja baada ya kutolewa, na CrewAI huendelea bila seva isiyofikiwa, ikiwa na onyo tu kwenye kumbukumbu; iite fresh_token kila kuanza kazi.
  • Kumpa kila wakala seva nzima. Bila tool_filter, mchambuzi huona pia zana za kuchapisha; pitisha create_static_tool_filter yenye majina ambayo kazi yake inahitaji.
  • Kuandika publish_at au scheduled_at bila tofauti ya saa. easyCoexistence hukataa muda usio na eneo la saa, kwa hiyo malizia kwa Z au tofauti kama -03:00.
  • Kuweka faili ya kuingia iliyohifadhiwa kwenye hazina ya msimbo. Refresh token yake humpa mwenye nayo zana za akaunti kwa hadi siku 60, kwa hiyo iweke kwenye hifadhi ya siri.
Kufanya hili ukitumia EasyCoexistence

easyCoexistence huwapa wakala wako wa CrewAI ufikiaji wa wateja kwenye WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn na chaneli nyingine nyingi, kila moja kupitia API yake rasmi: zana 35+ za MCP kwa orodha ya mcps ya kila wakala, posts API inayoweka machapisho kwenye foleni hadi siku 90 mbele, na matukio yaliyosainiwa kwa maoni na ujumbe wa moja kwa moja, huku kila muunganisho ukifuatiliwa saa 24 kwa siku. Kuanzia US$ 9 kwa kila muunganisho kwa mwezi hadi US$ 0.75 kadri unavyoongeza muunganisho, na siku 3 za kwanza bila malipo.

Maswali yanayoulizwa mara kwa mara

Je, mteja wa MCP wa CrewAI huendesha kuingia kwa OAuth yenyewe?

Nyaraka zake zinaonyesha vichwa, vigezo vya mazingira na vigezo vya swali kwa uthibitishaji, bila mtiririko wa OAuth. Kwa hiyo timu hutuma bearer token ambayo tayari inayo, ambayo kuingia mara moja kwa MCP Python SDK hutoa.

Je, timu inaweza kujibu maoni kwa ratiba yake yenyewe?

Ndiyo. Wakala wa meneja wa jamii mwenye list_social_posts, list_social_comments na reply_to_comment anaweza kushughulikia maoni mapya kila mzunguko, ambayo pia ndiyo njia ya kusoma maoni ya YouTube na LinkedIn, kwa kuwa hakuna kati yao hutuma matukio.

Je, timu inaweza kutuma ujumbe wa WhatsApp?

Ndiyo, kwa list_numbers, send_message na send_template kwenye kichujio cha zana cha wakala. send_message hujibu wateja walioandika ndani ya saa 24 zilizopita, na send_template hutuma kiolezo kilichoidhinishwa kwa mtu mwingine yeyote.

easyCoexistence inagharimu kiasi gani kwa timu ya CrewAI?

Kuanzia US$ 9 hadi US$ 0.75 kwa kila muunganisho kwa mwezi, inashuka kadri unavyoongeza muunganisho, na ni sawa kwenye kila mtandao. Seva ya MCP, posts API na matukio yaliyosambazwa vimejumuishwa, na siku 3 za kwanza ni bila malipo.

Endelea kusoma

Unganisha chaneli yako ya kwanza ndani ya dakika mbili.

Hakuna ukaguzi wa majukwaa wa kusubiri. Unganisha WhatsApp, Instagram, TikTok au chaneli nyingine, kisha mwombe AI wako achapishe, ajibu au atoe ripoti, na uone akifanya kazi.

  • Siku 3 bila malipo
  • Ghairi wakati wowote
  • API rasmi pekee
  • Hufuatiliwa saa 24/7

Imethibitishwa kwenye