CrewAI ekibine Instagram, TikTok ve WhatsApp araçları verin
Bir CrewAI ekibi, her ajanın mcps listesinde Authorization başlığında easyCoexistence OAuth erişim token'ı bulunan https://easycoexistence.com/api/mcp adresine yönelik bir MCPServerHTTP olduğunda Instagram, TikTok, WhatsApp ve daha fazla kanalı araç olarak alır. CrewAI'nin MCP istemcisi oturum açma yapmak yerine başlık gönderir; bu yüzden ekip her kickoff'ta token'ı yeniler. Özel araçlar ise bunun yerine bir anahtarla posts API'sine erişebilir.
MCPServerHTTP'nin isteğe bağlı HTTP başlıkları sözlüğü; CrewAI belgeleri bunun Authorization bearer token taşıdığını gösterir.
CrewAI'nin bir MCP sunucusunun araçları için izin ve engelleme listeleri; crewai.mcp.filters modülünden içe aktarılır.
CrewAI'nin bir MCP bağlantısı için varsayılan bekleme süresi; ulaşılamayan bir sunucu uyarı olarak kaydedilir ve ajan diğer araçlarıyla devam eder.
easyCoexistence MCP erişim token'ının ne kadar süre geçerli olduğu; 60 gün geçerli bir yenileme token'ı yeni bir çift verir.
easyCoexistence gönderi API'sinin bir gönderiyi ne kadar önceden planlayabildiği: 1 dakikadan başlar ve kuyruğa alındığında medyayı kopyalar.
Bir CrewAI ajanı easyCoexistence araçlarını nasıl yükler?
mcps alanı üzerinden, her ajan için bir MCPServerHTTP ile. Bu sınıf için CrewAI'nin varsayılanı olan Streamable HTTP üzerinden bağlanır ve verdiğiniz başlıkları gönderir; burada bir easyCoexistence erişim token'ı tutan bir Authorization başlığı. create_static_tool_filter ile oluşturulan statik bir araç filtresi her ajana yalnızca görevinin ihtiyaç duyduğu araçları verir; cache_tools_list ise ilk bağlantıdan sonra listeyi saklar. CrewAI bağlantıyı gerektiğinde kurar ve bir sunucuya ulaşılamazsa uyarı kaydeder, ajanın diğer araçlarıyla devam etmesine izin verir; bu yüzden ilk çalıştırmada günlüğü okuyun. Erişim token'ı bir sonraki bölümdeki yardımcıdan gelir.
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>"})Ekibin erişim token'ı nereden gelir?
Tek bir tarayıcı oturum açmasından, ardından her kickoff'ta yenilemeden. easyCoexistence'ın MCP sunucusu yalnızca OAuth token'larını kabul eder: dinamik istemci kaydı, PKCE ile bir yetkilendirme kodu, bir saat geçerli erişim token'ları ve 60 gün geçerli yenileme token'ları. MCP Python SDK'nın OAuthClientProvider'ını bir kez, tarayıcısı olan bir makinede çalıştırın ve döndürdüğü kaydı ve token'ları kaydedin; aşağıdaki yardımcı, CrewAI'nin kurduğu SDK'nın 1.x sürümünü kullanır. Her kickoff'tan önce fresh_token, kayıtlı yenileme token'ını easyCoexistence'ın token uç noktasında yeni bir çifte değiştirir ve saklar; böylece 60 gün içinde en az bir kez çalışan bir ekibin bir daha tarayıcıya ihtiyacı olmaz. Kaydedilen dosyayı depoda değil, bir gizli bilgi deposunda tutun.
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())Ekip MCP sunucusu olmadan nasıl yayımlayabilir?
easyCoexistence'ın gönderi API'sini çağıran özel bir araçla; bu, kimsenin başında olmadığı bir zamanlayıcı tarafından başlatılan bir ekibe uygundur. Panelde ec_live_ ile başlayan bir Partner API anahtarı oluşturun; aşağıdaki araç, metni, medya bağlantısını, türünü ve publish_at alanını içeren POST /api/v1/channels/:id/posts isteğini gönderir. easyCoexistence, gönderi kuyruğa alındığında medyayı kopyalar, o anda bir web sayfası döndüren veya yanlış biçimde olan bir bağlantıyı reddeder ve gönderiyi zamanında yayımlar; Idempotency-Key başlığı, yeniden denenen bir çağrının gönderiyi iki kez kuyruğa almasını önler. Aynı anahtar, GET /api/v1/channels/:id?credentials=1 üzerinden taze ağ token'larını okur.
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 refusedEkipteki hangi ajan hangi araçları tutmalı?
Görevini bitirmesine yetecek en az sayıda; çünkü bir ajan elinde tuttuğu herhangi bir aracı çağırabilir. Bir haftalık içerik planlayan ve yayımlayan bir ekip, işi okuma, yazma ve yayımlamanın farklı ajanlara ait olacak şekilde böler ve yalnızca biri bir şeyi canlıya alabilir. Yazar ajana hiçbir easyCoexistence aracı vermeyin: analistin bulgularından ve brifingden çalışır, metinleri ise görev çıktısı olarak zamanlayıcıya iletilir. Yayımlama araçları scheduled_at alır, böylece zamanlayıcı çalıştığı anda değil, zamanı geldiğinde gönderileri kuyruğa alır; list_scheduled_posts ise neyin beklediğini doğrulamaya yarar. LinkedIn gönderileri ekiplerin dışında tutulur: bir ajan her birini istek üzerine, örneğin Claude veya ChatGPT içinde taslak olarak hazırlar ve yayından önce bir kişi onaylar.
Ağlar ekibin gönderilerinden ve yanıtlarından ne ister?
Her ağın API kuralları; bunlar ajanların goal ve backstory alanlarında yer almalıdır:
- Medya: her dosya için herkese açık bir HTTPS bağlantısı. Instagram JPEG görselleri kabul eder, TikTok fotoğraf gönderileri JPEG veya WebP kabul eder ve bir Facebook Sayfa gönderisi tek bir fotoğraf veya tek bir video alır.
- Zamanlar: 2026-11-20T09:00:00-03:00 gibi saat dilimi içeren ISO 8601, 1 dakikadan 90 güne kadar ileri.
- Yorumlar: TikTok yanıtları herkese açıktır ve
post_idolarak videonun ID'sini gerektirir; bir Instagram veya Facebook yorumu 7 gün içinde bir özel yanıt alabilir. - DM'ler: Instagram ve Messenger, kişinin son mesajından itibaren 24 saat içinde yanıtları kabul eder; WhatsApp'ın
send_messagearacı aynı pencereye uyar,send_templateise diğer herkese ulaşır. - Olaylar: Bir yorum veya DM, ekibe yalnızca
set_social_webhook_destinationile ayarladığınız kendi rotanız üzerinden ulaşır; bu rota olayla birlikte crew.kickoff çağırabilir.
Yaygın hatalar
- Ekibi dünkü token'la başlatmak. Bir easyCoexistence erişim token'ı verildikten bir saat sonra sona erer; CrewAI ise ulaşılamayan bir sunucu olmadan devam eder ve günlükte yalnızca bir uyarı kalır. Her kickoff'ta fresh_token çağırın.
- Her ajana tüm sunucuyu vermek. tool_filter olmadan bir analist yayımlama araçlarını da görür; görevinin ihtiyaç duyduğu adları create_static_tool_filter ile geçirin.
- publish_at veya scheduled_at alanını saat dilimi olmadan yazmak. easyCoexistence saat dilimi olmayan bir zamanı reddeder; bu yüzden Z ile veya -03:00 gibi bir ofsetle bitirin.
- Kaydedilen oturum dosyasını commit etmek. Yenileme token'ı, ona sahip olan herkese hesabın araçlarını 60 güne kadar verir; bu yüzden dosyayı bir gizli bilgi deposunda tutun.
easyCoexistence CrewAI ajanlarınıza WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn ve daha fazla kanaldaki müşterilerinize ulaşma imkânı verir; her biri resmi API'si üzerinden çalışır: her ajanın mcps listesi için 35'ten fazla MCP aracı, 90 güne kadar önceden kuyruğa alan bir gönderi API'si ve yorumlar ile DM'ler için imzalı olaylar; her bağlantı 7/24 izlenir. Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bağlantı eklendikçe fiyat düşer. İlk 3 gün ücretsizdir.
Sık sorulan sorular
CrewAI'nin MCP istemcisi OAuth oturum açmasını kendisi yapar mı?
Belgeleri kimlik doğrulama için başlıkları, ortam değişkenlerini ve sorgu parametrelerini gösterir; bir OAuth akışı yoktur. Bu yüzden ekip, zaten sahip olduğu bir bearer token'ı gönderir; bunu da MCP Python SDK ile yapılan tek bir oturum açma sağlar.
Ekip yorumlara kendi zamanlamasıyla yanıt verebilir mi?
Evet. list_social_posts, list_social_comments ve reply_to_comment araçlarına sahip bir topluluk yöneticisi ajanı her çalıştırmada yeni yorumlar üzerinde çalışabilir; bu aynı zamanda YouTube ve LinkedIn yorumlarının okunma yoludur, çünkü ikisi de olay iletmez.
Ekip WhatsApp mesajları gönderebilir mi?
Evet; bir ajanın araç filtresinde list_numbers, send_message ve send_template ile. send_message son 24 saatte yazan müşterilere yanıt verir, send_template ise onaylı bir şablonu diğer herkese gönderir.
easyCoexistence bir CrewAI ekibi için ne kadar tutar?
Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bağlantı eklendikçe düşer ve her ağda aynıdır. MCP sunucusu, gönderi API'si ve iletilen olaylar dahildir; ilk 3 gün ücretsizdir.
Okumaya devam edin
İlk kanalınızı iki dakikada bağlayın.
Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.
- 3 gün ücretsiz
- İstediğiniz zaman iptal
- Yalnızca resmi API'ler
- 7/24 izleniyor
Doğrulama tarihi