Δώστε σε ένα CrewAI crew εργαλεία για Instagram, TikTok και WhatsApp
Ένα CrewAI crew αποκτά τα Instagram, TikTok, WhatsApp και άλλα κανάλια ως εργαλεία όταν η λίστα mcps κάθε agent περιέχει ένα MCPServerHTTP για https://easycoexistence.com/api/mcp, με OAuth access token του easyCoexistence στην κεφαλίδα Authorization. Το MCP client του CrewAI στέλνει κεφαλίδες και δεν εκτελεί σύνδεση, οπότε το crew ανανεώνει το token σε κάθε kickoff, ενώ τα προσαρμοσμένα εργαλεία μπορούν να φτάσουν στο posts API με κλειδί.
Το προαιρετικό λεξικό HTTP κεφαλίδων του MCPServerHTTP, με το οποίο η τεκμηρίωση του CrewAI δείχνει ένα Authorization bearer token.
Οι λίστες επιτρεπόμενων και αποκλεισμένων εργαλείων ενός MCP server του CrewAI, εισαγόμενες από το crewai.mcp.filters.
Η προεπιλεγμένη αναμονή του CrewAI για σύνδεση MCP: ένας server που δεν μπορεί να προσεγγιστεί καταγράφεται ως προειδοποίηση και ο agent κρατά τα υπόλοιπα εργαλεία του.
Πόση ώρα ισχύει ένα MCP access token του easyCoexistence· ένα refresh token, με ισχύ 60 ημερών, δίνει νέο ζεύγος.
Πόσο νωρίτερα προγραμματίζει το posts API του easyCoexistence μια ανάρτηση, από 1 λεπτό, αντιγράφοντας τα media όταν μπαίνει στην ουρά.
Πώς φορτώνει ένας CrewAI agent τα εργαλεία του easyCoexistence;
Μέσω του πεδίου mcps, με ένα MCPServerHTTP ανά agent. Συνδέεται μέσω Streamable HTTP, την προεπιλογή του CrewAI για αυτήν την κλάση, και στέλνει τις κεφαλίδες που του δίνετε, εδώ μια κεφαλίδα Authorization με access token του easyCoexistence. Ένα στατικό φίλτρο εργαλείων, φτιαγμένο με create_static_tool_filter, δίνει σε κάθε agent μόνο τα εργαλεία που χρειάζεται η εργασία του, και το cache_tools_list κρατά τη λίστα μετά την πρώτη σύνδεση. Το CrewAI συνδέεται όταν χρειάζεται και, αν ένας server δεν είναι προσβάσιμος, καταγράφει προειδοποίηση και αφήνει τον agent να συνεχίσει με τα υπόλοιπα εργαλεία του, γι' αυτό διαβάστε το log στην πρώτη εκτέλεση. Το access token προέρχεται από τον βοηθό της επόμενης ενότητας.
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 του crew;
Από μία σύνδεση στο πρόγραμμα περιήγησης και μετά από ανανέωση σε κάθε kickoff. Ο MCP server του easyCoexistence δέχεται μόνο OAuth tokens: dynamic client registration, authorization code με PKCE, access tokens που ισχύουν μία ώρα και refresh tokens που ισχύουν 60 ημέρες. Εκτελέστε μία φορά το OAuthClientProvider του MCP Python SDK, σε μηχάνημα με πρόγραμμα περιήγησης, και αποθηκεύστε την εγγραφή και τα tokens που επιστρέφει. Ο βοηθός παρακάτω χρησιμοποιεί τη γραμμή 1.x του SDK, την οποία εγκαθιστά το CrewAI. Πριν από κάθε kickoff, το fresh_token ανταλλάσσει το αποθηκευμένο refresh token στο token endpoint του easyCoexistence με ένα νέο ζεύγος και το αποθηκεύει, έτσι ώστε ένα crew που τρέχει τουλάχιστον μία φορά σε 60 ημέρες να μην χρειάζεται ξανά το πρόγραμμα περιήγησης. Φυλάξτε το αποθηκευμένο αρχείο σε secret store, όχι στο 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())Πώς μπορεί ένα crew να δημοσιεύει χωρίς τον MCP server;
Με ένα προσαρμοσμένο εργαλείο που καλεί το posts API του easyCoexistence, κάτι που ταιριάζει σε crew που ξεκινά ένας scheduler χωρίς κανέναν παρόντα. Δημιουργήστε ένα Partner API key στο dashboard, που ξεκινά με ec_live_, και το παρακάτω εργαλείο στέλνει POST /api/v1/channels/:id/posts με το κείμενο, τον σύνδεσμο και τον τύπο των media και το publish_at. Το easyCoexistence αντιγράφει τα media όταν μπαίνει η ανάρτηση στην ουρά, απορρίπτει σύνδεσμο που επιστρέφει ιστοσελίδα ή λάθος μορφή εκείνη τη στιγμή και δημοσιεύει την ανάρτηση στην ώρα της. Η κεφαλίδα Idempotency-Key εμποδίζει μια επαναλαμβανόμενη κλήση να την βάλει δύο φορές στην ουρά. Το ίδιο κλειδί διαβάζει νέα network tokens από το 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Ποιος agent του crew πρέπει να έχει ποια εργαλεία;
Τα λιγότερα που του επιτρέπουν να ολοκληρώσει την εργασία του, επειδή ένας agent μπορεί να καλέσει οποιοδήποτε εργαλείο κατέχει. Ένα crew που σχεδιάζει και δημοσιεύει μια εβδομάδα περιεχομένου μοιράζει τη δουλειά ώστε η ανάγνωση, η συγγραφή και η δημοσίευση να βρίσκονται σε διαφορετικούς agents, και μόνο ένας από αυτούς να μπορεί να βάλει κάτι ζωντανά. Μην δίνετε στον writer κανένα εργαλείο του easyCoexistence: δουλεύει με τα ευρήματα του analyst και το brief, και οι λεζάντες του φτάνουν στον scheduler ως έξοδος της εργασίας. Τα εργαλεία δημοσίευσης δέχονται scheduled_at, οπότε ο scheduler βάζει τις αναρτήσεις στην ουρά για τις ώρες τους αντί να δημοσιεύει τη στιγμή που τρέχει, και το list_scheduled_posts του επιτρέπει να επιβεβαιώσει τι περιμένει. Οι αναρτήσεις LinkedIn μένουν εκτός crews: ένας agent συντάσσει καθεμία κατ' αίτηση, για παράδειγμα στο Claude ή στο ChatGPT, και ένα άτομο την εγκρίνει πριν βγει.
Ποιους κανόνες έχουν τα δίκτυα για τις αναρτήσεις και τις απαντήσεις του crew;
Οι κανόνες του API κάθε δικτύου, που ανήκουν στους goals και στα backstories των agents:
- Media: ένας δημόσιος σύνδεσμος HTTPS ανά αρχείο. Το Instagram δέχεται εικόνες JPEG, οι φωτογραφικές αναρτήσεις του TikTok δέχονται JPEG ή WebP, και μια ανάρτηση σε Facebook Page δέχεται μία φωτογραφία ή ένα βίντεο.
- Ώρες: ISO 8601 με ζώνη ώρας, όπως 2026-11-20T09:00:00-03:00, από 1 λεπτό έως 90 ημέρες μπροστά.
- Σχόλια: οι απαντήσεις στο TikTok είναι δημόσιες και θέλουν το ID του βίντεο ως
post_id· ένα σχόλιο στο Instagram ή στο Facebook μπορεί να πάρει μία ιδιωτική απάντηση εντός 7 ημερών. - DM: το Instagram και το Messenger δέχονται απαντήσεις εντός 24 ωρών από το τελευταίο μήνυμα του ατόμου· το
send_messageτου WhatsApp τηρεί το ίδιο παράθυρο, ενώ τοsend_templateφτάνει σε όλους τους άλλους. - Γεγονότα: ένα σχόλιο ή DM φτάνει στο crew μόνο μέσω της δικής σας διαδρομής, που ορίζεται με το
set_social_webhook_destinationκαι μπορεί να καλεί το crew.kickoff με το γεγονός.
Συνηθισμένα λάθη
- Εκκίνηση crew με το χθεσινό token. Ένα access token του easyCoexistence λήγει μία ώρα μετά την έκδοσή του, και το CrewAI συνεχίζει χωρίς server που δεν μπορεί να προσεγγίσει, με μόνο μια προειδοποίηση στο log· καλέστε το fresh_token σε κάθε kickoff.
- Να δίνετε σε κάθε agent ολόκληρο τον server. Χωρίς tool_filter, ένας analyst βλέπει και τα εργαλεία δημοσίευσης· περάστε create_static_tool_filter με τα ονόματα που χρειάζεται η εργασία του.
- Να γράφετε publish_at ή scheduled_at χωρίς offset. Το easyCoexistence απορρίπτει ώρα χωρίς ζώνη ώρας, άρα τελειώστε την με Z ή με offset όπως -03:00.
- Να κάνετε commit το αποθηκευμένο αρχείο σύνδεσης. Το refresh token του δίνει σε όποιον το κατέχει τα εργαλεία του λογαριασμού για έως 60 ημέρες, γι' αυτό φυλάξτε το σε secret store.
Το easyCoexistence δίνει στους agents του CrewAI πρόσβαση στους πελάτες σας στο WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn και άλλα κανάλια, το καθένα μέσω του επίσημου API του: 35+ εργαλεία MCP για τη λίστα mcps κάθε agent, ένα posts API που βάζει στην ουρά έως 90 ημέρες μπροστά, και υπογεγραμμένα γεγονότα για σχόλια και DM, με κάθε σύνδεση να παρακολουθείται 24/7. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και οι πρώτες 3 ημέρες δωρεάν.
Συχνές ερωτήσεις
Εκτελεί το ίδιο το MCP client του CrewAI τη σύνδεση OAuth;
Η τεκμηρίωση του CrewAI δείχνει κεφαλίδες, μεταβλητές περιβάλλοντος και παραμέτρους ερωτήματος για έλεγχο ταυτότητας, χωρίς ροή OAuth. Έτσι το crew στέλνει ένα bearer token που ήδη έχει, και αυτό δίνει μία σύνδεση με το MCP Python SDK.
Μπορεί ένα crew να απαντά σε σχόλια με το δικό του πρόγραμμα;
Ναι. Ένας agent διαχείρισης κοινότητας με list_social_posts, list_social_comments και reply_to_comment μπορεί να επεξεργάζεται τα νέα σχόλια σε κάθε εκτέλεση, κάτι που είναι και ο τρόπος ανάγνωσης των σχολίων YouTube και LinkedIn, αφού κανένα από τα δύο δεν προωθεί γεγονότα.
Μπορεί το crew να στέλνει μηνύματα WhatsApp;
Ναι, με list_numbers, send_message και send_template στο φίλτρο εργαλείων ενός agent. Το send_message απαντά σε πελάτες που έγραψαν τις τελευταίες 24 ώρες, ενώ το send_template στέλνει εγκεκριμένο πρότυπο μηνύματος σε όλους τους άλλους.
Πόσο κοστίζει το easyCoexistence για ένα crew του CrewAI;
Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και το ίδιο σε κάθε δίκτυο. Ο MCP server, το posts API και τα προωθημένα γεγονότα περιλαμβάνονται, με τις πρώτες 3 ημέρες δωρεάν.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις