CrewAI क्रू को Instagram, TikTok और WhatsApp के टूल दें
CrewAI क्रू को Instagram, TikTok, WhatsApp और अन्य चैनल टूल के रूप में तभी मिलते हैं जब हर एजेंट की mcps सूची में https://easycoexistence.com/api/mcp के लिए एक MCPServerHTTP हो, जिसके Authorization हेडर में easyCoexistence का OAuth एक्सेस टोकन हो। CrewAI का MCP क्लाइंट लॉग इन नहीं चलाता, बल्कि हेडर भेजता है, इसलिए क्रू हर kickoff पर टोकन रीफ़्रेश करता है। कस्टम टूल चाहें तो इसके बजाय पार्टनर एपीआई कुंजी से पोस्ट एपीआई तक पहुँच सकते हैं।
MCPServerHTTP का वैकल्पिक HTTP हेडर डिक्शनरी, जिसमें CrewAI के दस्तावेज़ Authorization बेयरर टोकन दिखाते हैं।
CrewAI की अनुमति और ब्लॉक सूचियाँ MCP सर्वर के टूल के लिए, जो crewai.mcp.filters से आयात होती हैं।
MCP कनेक्शन के लिए CrewAI का डिफ़ॉल्ट इंतज़ार; जो सर्वर पहुँच में नहीं आता, उसे चेतावनी के रूप में लॉग किया जाता है और एजेंट अपने बाकी टूल के साथ चलता रहता है।
easyCoexistence के MCP एक्सेस टोकन कितने समय चलते हैं; एक रीफ़्रेश टोकन, जो 60 दिन तक वैध रहता है, नई जोड़ी देता है।
easyCoexistence का पोस्ट एपीआई कितना आगे तक पोस्ट शेड्यूल करता है, 1 मिनट से, और कतार में लगते समय मीडिया कॉपी करता है।
CrewAI एजेंट easyCoexistence के टूल कैसे लोड करता है?
mcps फ़ील्ड के ज़रिए, हर एजेंट के लिए एक MCPServerHTTP। यह Streamable HTTP पर कनेक्ट होता है, जो इस क्लास का CrewAI डिफ़ॉल्ट है, और आपके दिए हेडर भेजता है, यहाँ एक Authorization हेडर जिसमें easyCoexistence का एक्सेस टोकन है। create_static_tool_filter से बना स्टैटिक टूल फ़िल्टर हर एजेंट को केवल वही टूल देता है जिनकी उसके टास्क को ज़रूरत है, और 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>"})क्रू का एक्सेस टोकन कहाँ से आता है?
एक बार ब्राउज़र से लॉग इन करके, फिर हर kickoff पर रीफ़्रेश से। easyCoexistence का MCP सर्वर केवल OAuth टोकन लेता है: डायनामिक क्लाइंट रजिस्ट्रेशन, PKCE के साथ ऑथराइज़ेशन कोड, एक घंटे तक चलने वाले एक्सेस टोकन और 60 दिन तक चलने वाले रीफ़्रेश टोकन। ब्राउज़र वाली मशीन पर MCP Python SDK का OAuthClientProvider एक बार चलाएँ और जो रजिस्ट्रेशन व टोकन मिलें उन्हें सहेजें; नीचे का हेल्पर SDK की 1.x लाइन इस्तेमाल करता है, जिसे CrewAI इंस्टॉल करता है। हर kickoff से पहले 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 के पोस्ट एपीआई को कॉल करने वाले कस्टम टूल से, जो शेड्यूलर से शुरू होने वाले और आसपास कोई न होने वाले क्रू के लिए सही है। डैशबोर्ड में पार्टनर एपीआई कुंजी बनाएँ, जो ec_live_ से शुरू होती है, और नीचे का टूल टेक्स्ट, मीडिया लिंक, प्रकार और publish_at के साथ POST /api/v1/channels/:id/posts भेजता है। कतार में लगते समय 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 में, और उसे भेजे जाने से पहले कोई व्यक्ति स्वीकृति देता है।
नेटवर्क क्रू की पोस्ट और जवाबों से क्या चाहते हैं?
हर नेटवर्क के एपीआई के नियम, जो एजेंटों के goals और backstories में होने चाहिए:
- मीडिया: हर फ़ाइल के लिए एक सार्वजनिक HTTPS लिंक। Instagram JPEG इमेज लेता है, TikTok फ़ोटो पोस्ट JPEG या WebP लेते हैं, और Facebook पेज पोस्ट एक फ़ोटो या एक वीडियो लेता है।
- समय: टाइमज़ोन के साथ ISO 8601, जैसे 2026-11-20T09:00:00-03:00, 1 मिनट से 90 दिन आगे तक।
- कमेंट: TikTok के जवाब सार्वजनिक होते हैं और इन्हें
post_idके रूप में वीडियो का ID चाहिए; Instagram या Facebook कमेंट को 7 दिन के भीतर एक निजी जवाब मिल सकता है। - डीएम: Instagram और Messenger के जवाब व्यक्ति के आख़िरी मैसेज के 24 घंटे के भीतर दिए जा सकते हैं; WhatsApp का
send_messageभी इसी समय-सीमा में रहता है, औरsend_templateबाकी सबके लिए है। - इवेंट: कमेंट या डीएम क्रू तक केवल आपके अपने रूट से पहुँचते हैं, जिसे
set_social_webhook_destinationसे सेट किया जाता है; यह इवेंट के साथ crew.kickoff कॉल कर सकता है।
आम गड़बड़ियाँ
- पिछले दिन के टोकन से क्रू शुरू करना। easyCoexistence का एक्सेस टोकन जारी होने के एक घंटे बाद समाप्त हो जाता है, और CrewAI ऐसे सर्वर के बिना आगे बढ़ जाता है जिस तक वह पहुँच नहीं सकता, बस लॉग में चेतावनी के साथ; हर kickoff पर 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 और अन्य चैनल, हर एक उसके आधिकारिक एपीआई के ज़रिए। हर एजेंट की mcps सूची के लिए 35 से अधिक MCP टूल, 90 दिन आगे तक कतार लगाने वाला पोस्ट एपीआई, और कमेंट व डीएम के लिए हस्ताक्षर वाले इवेंट, और हर कनेक्शन 24/7 निगरानी में रहता है। हर कनेक्शन के लिए प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे कनेक्शन जोड़ते हैं वैसे घटता है, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
क्या CrewAI का MCP क्लाइंट OAuth लॉग इन खुद चलाता है?
उसके दस्तावेज़ हेडर, एनवायरनमेंट वेरिएबल और क्वेरी पैरामीटर दिखाते हैं, पर 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 सर्वर, पोस्ट एपीआई और आगे भेजे गए इवेंट शामिल हैं, और पहले 3 दिन मुफ़्त हैं।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित