CrewAI کریو کو Instagram، TikTok اور WhatsApp کے ٹولز فراہم کریں
جب ہر ایجنٹ کی mcps فہرست میں easyCoexistence کے MCP سرور https://easycoexistence.com/api/mcp کے لیے MCPServerHTTP ہو اور اس کے Authorization ہیڈر میں easyCoexistence کا OAuth ایکسیس ٹوکن ہو، تو CrewAI کریو کو Instagram، TikTok، WhatsApp اور مزید چینلز بطور ٹول ملتے ہیں۔ CrewAI کا MCP کلائنٹ ہیڈرز بھیجتا ہے، سائن ان نہیں چلاتا، اس لیے کریو ہر کک آف پر ٹوکن ریفریش کرتا ہے۔ کسٹم ٹولز اس کے بجائے کلید کے ساتھ posts API تک پہنچ سکتے ہیں۔
MCPServerHTTP کا اختیاری HTTP ہیڈرز کا ڈکشنری، جس میں CrewAI کی دستاویزات کے مطابق Authorization بیئر ٹوکن جاتا ہے۔
crewai.mcp.filters سے درآمد شدہ، MCP سرور کے ٹولز کی CrewAI کی allow اور block فہرستیں۔
MCP کنکشن کے لیے CrewAI کا ڈیفالٹ انتظار؛ جس سرور تک رسائی نہ ہو، اس کا وارننگ لاگ ہوتا ہے اور ایجنٹ اپنے باقی ٹولز کے ساتھ چلتا رہتا ہے۔
easyCoexistence کے MCP ایکسیس ٹوکن کی مدت؛ ریفریش ٹوکن، جو 60 دن تک کام کرتا ہے، نیا جوڑا دیتا ہے۔
easyCoexistence کا posts API پوسٹ کو 1 منٹ سے لے کر کتنا پہلے شیڈول کر سکتا ہے، اور قطار میں لگنے پر میڈیا کاپی ہوتا ہے۔
CrewAI ایجنٹ easyCoexistence کے ٹولز کیسے لوڈ کرتا ہے؟
mcps فیلڈ کے ذریعے، ہر ایجنٹ کے لیے ایک MCPServerHTTP۔ یہ Streamable HTTP پر کنیکٹ ہوتا ہے، جو اس کلاس کا CrewAI ڈیفالٹ ہے، اور وہ ہیڈرز بھیجتا ہے جو آپ دیں، یہاں ایک Authorization ہیڈر جس میں easyCoexistence کا ایکسیس ٹوکن ہو۔ create_static_tool_filter سے بنایا گیا static ٹول فلٹر ہر ایجنٹ کو صرف وہی ٹول دیتا ہے جن کی اس کے ٹاسک کو ضرورت ہو، اور cache_tools_list پہلے کنکشن کے بعد فہرست محفوظ رکھتا ہے۔ CrewAI ضرورت پر کنیکٹ کرتا ہے اور اگر کوئی سرور تک نہ پہنچ سکے تو وارننگ لاگ کرتا ہے اور ایجنٹ اپنے باقی ٹولز کے ساتھ کام جاری رکھتا ہے، اس لیے پہلے رن پر لاگ ضرور دیکھیں۔ ایکسیس ٹوکن اگلے سیکشن کے ہیلپر سے آتا ہے۔
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>"})کریو کا ایکسیس ٹوکن کہاں سے آتا ہے؟
ایک بار براؤزر سائن ان سے، اور پھر ہر کک آف پر ریفریش سے۔ easyCoexistence کا MCP سرور صرف OAuth ٹوکن قبول کرتا ہے: ڈائنامک کلائنٹ رجسٹریشن، PKCE کے ساتھ اتھارائزیشن کوڈ، ایک گھنٹہ چلنے والے ایکسیس ٹوکن اور 60 دن چلنے والے ریفریش ٹوکن۔ MCP Python SDK کا OAuthClientProvider ایک بار ایسی مشین پر چلائیں جس میں براؤزر ہو، اور جو رجسٹریشن اور ٹوکن واپس دے، انہیں محفوظ کریں؛ نیچے کا ہیلپر SDK کی 1.x لائن استعمال کرتا ہے، جو CrewAI انسٹال کرتا ہے۔ ہر کک آف سے پہلے fresh_token محفوظ شدہ ریفریش ٹوکن کو easyCoexistence کے ٹوکن اینڈ پوائنٹ پر بھیج کر نیا جوڑا لیتا ہے اور اسے محفوظ کرتا ہے، اس لیے جو کریو 60 دن میں کم از کم ایک بار چلے اسے دوبارہ براؤزر کی ضرورت نہیں پڑتی۔ محفوظ فائل کو ریپوزیٹری میں نہیں، سیکرٹ اسٹور میں رکھیں۔
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())کریو MCP سرور کے بغیر کیسے پبلش کر سکتا ہے؟
ایک کسٹم ٹول کے ذریعے جو easyCoexistence کے posts API کو کال کرے، جو اس کریو کے لیے موزوں ہے جسے شیڈیولر کسی کی موجودگی کے بغیر شروع کرے۔ ڈیش بورڈ میں ایک Partner API کلید بنائیں، جو ec_live_ سے شروع ہوتی ہے، اور نیچے کا ٹول POST /api/v1/channels/:id/posts کو متن، میڈیا لنک، قسم اور publish_at کے ساتھ بھیجتا ہے۔ easyCoexistence پوسٹ قطار میں لگتے وقت میڈیا کاپی کرتا ہے، اسی لمحے ایسا لنک رد کرتا ہے جو ویب پیج لوٹائے یا غلط فارمیٹ میں ہو، اور پوسٹ اپنے وقت پر شائع کرتا ہے؛ Idempotency-Key ہیڈر دوبارہ بھیجی گئی کال کو دو بار قطار میں لگنے سے روکتا ہے۔ وہی کلید 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 refusedکریو میں کون سا ایجنٹ کون سے ٹول رکھے؟
وہ کم سے کم ٹول جن سے وہ اپنا ٹاسک مکمل کر سکے، کیونکہ ایجنٹ اپنے پاس موجود کسی بھی ٹول کو کال کر سکتا ہے۔ جو کریو ایک ہفتے کا مواد منصوبہ بنا کر پوسٹ کرتا ہے، وہ کام یوں تقسیم کرتا ہے کہ پڑھنا، لکھنا اور پبلش کرنا الگ الگ ایجنٹوں کے پاس ہوں، اور ان میں سے صرف ایک ہی کچھ بھی لائیو کر سکے۔ لکھنے والے کو easyCoexistence کا کوئی ٹول نہ دیں: وہ تجزیہ کار کے نتائج اور بریف پر کام کرتا ہے، اور اس کے کیپشن ٹاسک آؤٹ پٹ کے طور پر شیڈیولر تک پہنچتے ہیں۔ پبلشنگ ٹولز scheduled_at لیتے ہیں، اس لیے شیڈیولر جس وقت چلتا ہے اسی لمحے پوسٹ کرنے کے بجائے پوسٹس کو ان کے وقت کے لیے قطار میں لگاتا ہے، اور list_scheduled_posts سے وہ تصدیق کر سکتا ہے کہ کیا انتظار میں ہے۔ LinkedIn پوسٹس کریو سے باہر رکھیں: ایک ایجنٹ درخواست پر ہر پوسٹ کا مسودہ بناتا ہے، مثلاً Claude یا ChatGPT میں، اور بھیجے جانے سے پہلے کوئی شخص اسے منظور کرتا ہے۔
نیٹ ورکس کریو کی پوسٹس اور جوابات سے کیا تقاضا کرتے ہیں؟
ہر نیٹ ورک کے API کے قواعد، جو ایجنٹس کے goals اور backstories میں جانے چاہییں:
- میڈیا: ہر فائل کے لیے ایک عوامی HTTPS لنک۔ Instagram JPEG تصاویر لیتا ہے، TikTok فوٹو پوسٹس JPEG یا WebP لیتی ہیں، اور Facebook Page پوسٹ ایک تصویر یا ایک ویڈیو لیتی ہے۔
- اوقات: ٹائم زون کے ساتھ ISO 8601، جیسے 2026-11-20T09:00:00-03:00، جو 1 منٹ سے 90 دن آگے تک ہو سکتے ہیں۔
- کمنٹس: TikTok کے جوابات عوامی ہیں اور
post_idکے طور پر ویڈیو کا ID درکار ہے؛ Instagram یا Facebook کمنٹ کا 7 دن کے اندر ایک نجی جواب دیا جا سکتا ہے۔ - DMs: Instagram اور Messenger جواب شخص کے آخری میسج کے 24 گھنٹے کے اندر لیتے ہیں؛ WhatsApp کا
send_messageاسی ونڈو تک محدود ہے، اورsend_templateباقی سب تک پہنچتا ہے۔ - ایونٹس: کمنٹ یا DM کریو تک صرف آپ کے اپنے راستے کے ذریعے پہنچتا ہے، جو
set_social_webhook_destinationسے سیٹ ہوتا ہے، اور یہ ایونٹ کے ساتھ crew.kickoff کو کال کر سکتا ہے۔
عام غلطیاں
- کل کے ٹوکن سے کریو شروع کرنا۔ easyCoexistence کا ایکسیس ٹوکن جاری ہونے کے ایک گھنٹے بعد ختم ہو جاتا ہے، اور CrewAI ایسے سرور کے بغیر چلتا رہتا ہے جس تک وہ پہنچ نہ سکے، لاگ میں صرف وارننگ کے ساتھ؛ ہر کک آف پر fresh_token کو کال کریں۔
- ہر ایجنٹ کو پورا سرور دینا۔ tool_filter کے بغیر تجزیہ کار کو پبلشنگ ٹولز بھی نظر آتے ہیں؛ اس کے ٹاسک کے ناموں کے ساتھ create_static_tool_filter دیں۔
- publish_at یا scheduled_at کو بغیر آفسیٹ کے لکھنا۔ easyCoexistence بغیر ٹائم زون کے وقت کو رد کرتا ہے، اس لیے اسے Z یا -03:00 جیسے آفسیٹ پر ختم کریں۔
- محفوظ کیا ہوا سائن ان فائل کمٹ کرنا۔ اس کا ریفریش ٹوکن اسے رکھنے والے کو 60 دن تک اکاؤنٹ کے ٹولز دیتا ہے، اس لیے اسے سیکرٹ اسٹور میں رکھیں۔
easyCoexistence آپ کے CrewAI ایجنٹس کو WhatsApp، Instagram، Facebook، TikTok، YouTube، LinkedIn اور مزید چینلز تک رسائی دیتا ہے، ہر ایک اپنے سرکاری API کے ذریعے: ہر ایجنٹ کی mcps فہرست کے لیے 50 سے زائد MCP ٹولز، ایک posts API جو 90 دن آگے تک قطار میں لگاتا ہے، اور کمنٹس اور DMs کے دستخط شدہ ایونٹس، جن میں ہر کنکشن 24/7 مانیٹر ہوتا ہے۔ فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشن بڑھاتے ہیں قیمت کم ہوتی ہے، اور پہلے 3 دن مفت ہیں۔
اکثر پوچھے جانے والے سوالات
کیا CrewAI کا MCP کلائنٹ OAuth سائن ان خود چلاتا ہے؟
اس کی دستاویزات میں ہیڈرز، environment variables اور کوئری پیرامیٹرز دکھائے گئے ہیں، لیکن OAuth فلو نہیں۔ اس لیے کریو ایک بیئر ٹوکن بھیجتا ہے جو اس کے پاس پہلے سے ہے، اور یہ ٹوکن MCP Python SDK کے ساتھ ایک بار کے سائن ان سے ملتا ہے۔
کیا کریو اپنے شیڈول پر کمنٹس کا جواب دے سکتا ہے؟
ہاں۔ ایک کمیونٹی مینیجر ایجنٹ جس کے پاس list_social_posts، list_social_comments اور reply_to_comment ہوں، ہر رن پر نئے کمنٹس نمٹا سکتا ہے، اور YouTube اور LinkedIn کے کمنٹس بھی اسی طرح پڑھے جاتے ہیں، کیونکہ ان دونوں کے ایونٹس فارورڈ نہیں ہوتے۔
کیا کریو WhatsApp میسج بھیج سکتا ہے؟
ہاں، ایجنٹ کے ٹول فلٹر میں list_numbers، send_message اور send_template کے ساتھ۔ send_message پچھلے 24 گھنٹوں میں لکھنے والے گاہکوں کو جواب دیتا ہے، اور send_template منظور شدہ ٹیمپلیٹ کسی بھی دوسرے شخص کو بھیجتا ہے۔
CrewAI کریو کے لیے easyCoexistence کتنے کا ہے؟
فی کنکشن ماہانہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، اور ہر نیٹ ورک پر یہی قیمت ہے۔ MCP سرور، posts API اور فارورڈ ہونے والے ایونٹس شامل ہیں، اور پہلے 3 دن مفت ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ