Bigyan ang isang CrewAI crew ng Instagram, TikTok at WhatsApp tools
Nakukuha ng isang CrewAI crew ang Instagram, TikTok, WhatsApp at iba pang channel bilang tools kapag ang mcps list ng bawat agent ay may MCPServerHTTP para sa https://easycoexistence.com/api/mcp na may easyCoexistence OAuth access token sa Authorization header nito. Ang MCP client ng CrewAI ay nagpapadala ng headers sa halip na magsagawa ng sign-in, kaya nire-refresh ng crew ang token sa bawat kickoff, at maaaring maabot ng custom tools ang posts API gamit ang key.
Ang opsyonal na dictionary ng HTTP headers ng MCPServerHTTP, na ipinapakita sa docs ng CrewAI na may Authorization bearer token.
Ang allow at block lists ng CrewAI para sa tools ng isang MCP server, na ini-import mula sa crewai.mcp.filters.
Ang default na paghihintay ng CrewAI para sa koneksyon ng MCP; kapag hindi maabot ang server, naitatala ito bilang warning at nananatili ang agent sa iba pa nitong tools.
Gaano katagal ang easyCoexistence MCP access token; ang refresh token, na tumatagal ng 60 araw, ay nagbibigay ng bagong pares.
Gaano kaaga nakakapag-iskedyul ang posts API ng easyCoexistence ng post, mula 1 minuto, at kinokopya ang media sa pagkakapila nito.
Paano niloload ng CrewAI agent ang easyCoexistence tools?
Sa pamamagitan ng mcps field, na may isang MCPServerHTTP bawat agent. Kumokonekta ito sa Streamable HTTP, ang default ng CrewAI para sa klaseng ito, at ipinapadala ang headers na ibinigay ninyo, dito ay isang Authorization header na may easyCoexistence access token. Ang static tool filter, na ginawa gamit ang create_static_tool_filter, ay nagbibigay sa bawat agent ng tools lamang na kailangan ng task nito, at pinananatili ng cache_tools_list ang listahan pagkatapos ng unang koneksyon. Kumokonekta ang CrewAI kapag kailangan, at kung hindi maabot ang server, naglalagay ito ng warning sa log at hinahayaan ang agent na magpatuloy sa iba pa nitong tools, kaya basahin po ninyo ang log sa unang takbo. Ang access token ay galing sa helper sa susunod na seksyon.
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>"})Saan galing ang access token ng crew?
Mula sa isang browser sign-in, pagkatapos ay i-refresh sa bawat kickoff. Ang MCP server ng easyCoexistence ay tumatanggap lamang ng OAuth tokens: dynamic client registration, authorization code na may PKCE, access tokens na tumatagal ng isang oras, at refresh tokens na tumatagal ng 60 araw. Patakbuhin nang isang beses ang OAuthClientProvider ng MCP Python SDK sa makinang may browser, at i-save ang registration at tokens na ibinabalik nito; ang helper sa ibaba ay gumagamit ng 1.x line ng SDK, na ini-install ng CrewAI. Bago ang bawat kickoff, ipinapalit ng fresh_token ang naka-save na refresh token sa token endpoint ng easyCoexistence para sa bagong pares at iniimbak ito, kaya ang crew na tumatakbo kahit isang beses man lang sa loob ng 60 araw ay hindi na kailangan ng browser. Itago ang naka-save na file sa secret store, hindi sa repository.
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())Paano makakapag-publish ang crew nang walang MCP server?
Gamit ang custom tool na tumatawag sa posts API ng easyCoexistence, na angkop sa crew na sinimulan ng scheduler at walang taong nagbabantay. Gumawa ng Partner API key sa dashboard, na nagsisimula sa ec_live_, at ipinapadala ng tool sa ibaba ang POST /api/v1/channels/:id/posts na may teksto, media link at uri, at publish_at. Kinokopya ng easyCoexistence ang media kapag naka-queue na ang post, tinatanggihan ang link na nagbabalik ng web page o maling format sa sandaling iyon, at ipina-publish ang post sa takdang oras nito; pinipigilan ng Idempotency-Key header na mailagay ito sa pila nang dalawang beses kapag inulit ang tawag. Ang parehong key ay nagbabasa ng bagong network tokens mula sa GET /api/v1/channels/:id?credentials=1.
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 refusedAling agent sa crew ang dapat humawak ng aling tools?
Ang pinakakaunti na magpapahintulot dito na tapusin ang task nito, dahil maaaring tawagin ng agent ang anumang tool na hawak nito. Ang crew na nagpaplano at nagpo-post ng isang linggong content ay naghahati ng trabaho para ang pagbabasa, pagsusulat at pag-publish ay nasa magkakaibang agent, at isa lamang sa kanila ang makapaglalagay ng anuman sa live. Huwag bigyan ang writer ng anumang easyCoexistence tools: gumagana ito gamit ang findings ng analyst at ang brief, at ang mga caption nito ay napupunta sa scheduler bilang task output. Tumatanggap ang publishing tools ng scheduled_at, kaya ipinipila ng scheduler ang mga post para sa kanilang oras sa halip na mag-post sa sandaling tumakbo ito, at nakukumpirma ng list_scheduled_posts kung ano ang naghihintay. Ang LinkedIn posts ay hindi isinasama sa crew: gumagawa ang isang agent ng draft para sa bawat isa kapag hiniling, halimbawa sa Claude o ChatGPT, at inaaprubahan ito ng isang tao bago ilabas.
Ano ang hinihingi ng mga network sa mga post at reply ng crew?
Ang mga patakaran ng API ng bawat network, na dapat nasa goals at backstories ng mga agent:
- Media: isang pampublikong HTTPS link bawat file. Tumatanggap ang Instagram ng JPEG na larawan, ang TikTok photo posts ay tumatanggap ng JPEG o WebP, at ang Facebook Page post ay tumatanggap ng isang larawan o isang video.
- Oras: ISO 8601 na may timezone, gaya ng 2026-11-20T09:00:00-03:00, mula 1 minuto hanggang 90 araw sa hinaharap.
- Komento: ang TikTok replies ay pampubliko at kailangan ng video ID bilang
post_id; ang komento sa Instagram o Facebook ay maaaring makatanggap ng isang pribadong reply sa loob ng 7 araw. - DM: tumatanggap ang Instagram at Messenger ng reply sa loob ng 24 oras mula sa huling mensahe ng tao; sumusunod ang
send_messageng WhatsApp sa parehong window, at naaabot ngsend_templateang sinumang iba pa. - Mga event: naaabot lamang ng komento o DM ang crew sa pamamagitan ng sarili ninyong route, na itinakda gamit ang
set_social_webhook_destination, na maaaring tumawag sa crew.kickoff kasama ang event.
Mga karaniwang pagkakamali
- Pagsisimula ng crew gamit ang token ng kahapon. Nag-e-expire ang easyCoexistence access token makalipas ang isang oras mula nang ma-issue ito, at nagpapatuloy ang CrewAI nang walang server na hindi nito maabot, na may warning lamang sa log; tawagin ang fresh_token sa bawat kickoff.
- Pagbibigay sa bawat agent ng buong server. Kapag walang tool_filter, nakikita ng analyst pati ang publishing tools; ipasa ang create_static_tool_filter na may mga pangalan na kailangan ng task nito.
- Pagsulat ng publish_at o scheduled_at nang walang offset. Tinatanggihan ng easyCoexistence ang oras na walang timezone, kaya tapusin ito sa Z o sa offset gaya ng -03:00.
- Pag-commit ng naka-save na sign-in file. Ang refresh token nito ay nagbibigay sa sinumang may hawak nito ng tools ng account hanggang 60 araw, kaya itago ito sa secret store.
Binibigyan ng easyCoexistence ang inyong CrewAI agent ng abot sa mga customer sa WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn at iba pang channel, bawat isa sa pamamagitan ng opisyal nitong API: 35+ MCP tools para sa mcps list ng bawat agent, posts API na nagsi-schedule hanggang 90 araw nang maaga, at naka-sign na events para sa komento at DM, at bawat koneksyon ay may 24/7 na monitoring. Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, na may unang 3 araw na libre.
Mga madalas itanong
Pinapatakbo ba ng MCP client ng CrewAI ang OAuth sign-in mismo?
Ipinapakita ng dokumentasyon nito ang headers, environment variables at query parameters para sa authentication, nang walang OAuth flow. Kaya ipinapadala ng crew ang bearer token na hawak na nito, na ibinibigay ng isang sign-in gamit ang MCP Python SDK.
Makakasagot ba ang crew sa mga komento sa sarili nitong iskedyul?
Oo. Ang community manager agent na may list_social_posts, list_social_comments at reply_to_comment ay maaaring magproseso ng mga bagong komento sa bawat takbo, na siya ring paraan ng pagbabasa ng komento sa YouTube at LinkedIn, dahil hindi nagpapasa ng events ang alinman sa dalawa.
Makakapagpadala ba ng mensahe sa WhatsApp ang crew?
Oo, gamit ang list_numbers, send_message at send_template sa tool filter ng isang agent. Sumasagot ang send_message sa mga customer na sumulat sa nakaraang 24 oras, at nagpapadala ang send_template ng aprubadong template sa sinumang iba pa.
Magkano ang halaga ng easyCoexistence para sa isang CrewAI crew?
Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon, at pareho sa bawat network. Kasama ang MCP server, ang posts API at ang mga ipinapasang events, na may unang 3 araw na libre.
Magpatuloy sa pagbabasa
I-connect ang inyong unang channel sa loob ng dalawang minuto.
Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.
- 3 araw na libre
- Mag-cancel anumang oras
- Official API lang
- Minomonitor 24/7
Na-verify noong