Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Beri pasukan CrewAI alat Instagram, TikTok dan WhatsApp

Pasukan CrewAI mendapat Instagram, TikTok, WhatsApp dan lebih banyak saluran sebagai alat apabila senarai mcps setiap ejen mengandungi MCPServerHTTP untuk https://easycoexistence.com/api/mcp dengan token akses OAuth easyCoexistence dalam header Authorization. Klien MCP CrewAI menghantar header dan tidak menjalankan log masuk, maka pasukan memuat semula token pada setiap kickoff, dan alat tersuai boleh mencapai API siaran dengan kunci sebaliknya.

headers

Kamus pilihan bagi pengepala HTTP MCPServerHTTP, yang dalam dokumentasi CrewAI membawa token pembawa Authorization.

create_static_tool_filter

Senarai benarkan dan sekat CrewAI untuk alat pelayan MCP, diimport dari crewai.mcp.filters.

30 seconds

Tempoh tunggu lalai CrewAI untuk sambungan MCP; pelayan yang tidak dapat dicapai dicatat sebagai amaran dan ejen terus menggunakan alat lain.

1 hour

Tempoh token akses MCP easyCoexistence; refresh token, yang sah 60 hari, membawa pasangan baharu.

90 days

Jarak masa ke hadapan API siaran easyCoexistence menjadualkan siaran, dari 1 minit, dengan media disalin apabila ia dimasukkan dalam giliran.

Bagaimana ejen CrewAI memuatkan alat easyCoexistence?

Melalui medan mcps, dengan satu MCPServerHTTP bagi setiap ejen. Ia bersambung melalui Streamable HTTP, lalai CrewAI untuk kelas ini, dan menghantar header yang anda berikan, di sini header Authorization yang mengandungi token akses easyCoexistence. Penapis alat statik, dibuat dengan create_static_tool_filter, memberi setiap ejen hanya alat yang diperlukan tugasnya, dan cache_tools_list menyimpan senarai itu selepas sambungan pertama. CrewAI bersambung atas permintaan dan, jika pelayan tidak dapat dicapai, mencatat amaran dan membenarkan ejen meneruskan kerja dengan alat lain, jadi baca log pada larian pertama. Token akses datang daripada pembantu di bahagian seterusnya.

A two-agent crew, each with its own slice of the tools
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>"})

Dari mana token akses pasukan datang?

Daripada satu log masuk melalui pelayar, kemudian dimuat semula pada setiap kickoff. Pelayan MCP easyCoexistence hanya menerima token OAuth: pendaftaran klien dinamik, kod kebenaran dengan PKCE, token akses yang sah selama satu jam dan refresh token yang sah 60 hari. Jalankan OAuthClientProvider SDK Python MCP sekali, pada mesin yang mempunyai pelayar web, dan simpan pendaftaran serta token yang dipulangkannya; pembantu di bawah menggunakan versi 1.x SDK, yang dipasang oleh CrewAI. Sebelum setiap kickoff, fresh_token menukar refresh token yang disimpan di endpoint token easyCoexistence dengan pasangan baharu dan menyimpannya, jadi pasukan yang berjalan sekurang-kurangnya sekali dalam 60 hari tidak perlu pelayar lagi. Simpan fail itu dalam storan rahsia, bukan dalam repositori.

easycoexistence_token.py: sign in once, refresh per kickoff
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())

Bagaimana pasukan boleh menyiarkan tanpa pelayan MCP?

Dengan alat tersuai yang memanggil API siaran easyCoexistence, sesuai untuk pasukan yang dimulakan oleh penjadual tanpa sesiapa di situ. Cipta Partner API key dalam dashboard, yang bermula dengan ec_live_, dan alat di bawah menghantar POST /api/v1/channels/:id/posts dengan teks, pautan dan jenis media serta publish_at. easyCoexistence menyalin media apabila siaran dimasukkan dalam giliran, menolak pautan yang memulangkan halaman web atau format yang salah pada ketika itu, dan menyiarkan siaran pada masanya; pengepala Idempotency-Key menghalang panggilan yang diulang daripada memasukkannya dua kali ke dalam giliran. Kunci yang sama membaca token rangkaian baharu daripada GET /api/v1/channels/:id?credentials=1.

A CrewAI tool that queues a post through the posts API
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

Ejen mana dalam pasukan patut memegang alat yang mana?

Yang paling sedikit yang membolehkannya menyelesaikan tugas, kerana ejen boleh memanggil mana-mana alat yang dipegangnya. Pasukan yang merancang dan menyiarkan kandungan seminggu membahagikan kerja supaya pembacaan, penulisan dan penyiaran berada pada ejen yang berbeza, dan hanya seorang daripada mereka boleh meletakkan sesuatu secara langsung. Jangan beri penulis sebarang alat easyCoexistence: ia bekerja daripada dapatan penganalisis dan taklimat, dan kapsyen beliau sampai ke penjadual sebagai output tugas. Alat penerbitan menerima scheduled_at, jadi penjadual menjadualkan siaran pada masanya dan bukan menyiarkannya sebaik sahaja berjalan, dan list_scheduled_posts membolehkannya mengesahkan apa yang sedang menunggu. Siaran LinkedIn tidak dimasukkan dalam pasukan: ejen menyediakan draf setiap satu atas permintaan, contohnya dalam Claude atau ChatGPT, dan seseorang meluluskannya sebelum ia keluar.

Analystlist_social_accounts, list_social_posts, get_social_insights, get_youtube_analytics
WriterNo easyCoexistence tools; drafts captions from the brief and the analyst's findings
Schedulerpublish_instagram_post, publish_tiktok_post, publish_facebook_post, list_scheduled_posts
Community managerlist_social_comments, reply_to_comment, hide_comment, send_social_dm

Apakah keperluan rangkaian bagi siaran dan balasan pasukan?

Peraturan API setiap rangkaian, yang patut dimasukkan dalam matlamat dan latar belakang ejen:

  • Media: pautan HTTPS awam bagi setiap fail. Instagram menerima imej JPEG, siaran foto TikTok menerima JPEG atau WebP, dan siaran Halaman Facebook menerima satu foto atau satu video.
  • Masa: ISO 8601 dengan zon waktu, seperti 2026-11-20T09:00:00-03:00, dari 1 minit hingga 90 hari ke hadapan.
  • Komen: balasan TikTok bersifat awam dan memerlukan ID video sebagai post_id; komen Instagram atau Facebook boleh menerima satu balasan peribadi dalam masa 7 hari.
  • DM: Instagram dan Messenger menerima balasan dalam masa 24 jam daripada mesej terakhir orang itu; send_message WhatsApp mengikut tetingkap yang sama, dan send_template menjangkau orang lain.
  • Peristiwa: komen atau DM sampai kepada pasukan hanya melalui laluan anda sendiri, ditetapkan dengan set_social_webhook_destination, yang boleh memanggil crew.kickoff dengan peristiwa itu.

Kesilapan biasa

  • Memulakan pasukan dengan token semalam. Token akses easyCoexistence tamat sejam selepas dikeluarkan, dan CrewAI meneruskan tanpa pelayan yang tidak dapat dicapai, dengan hanya amaran dalam log; panggil fresh_token pada setiap kickoff.
  • Memberi setiap ejen seluruh pelayan. Tanpa tool_filter, penganalisis juga melihat alat penerbitan; hantar create_static_tool_filter dengan nama yang diperlukan tugasnya.
  • Menulis publish_at atau scheduled_at tanpa offset. easyCoexistence menolak masa tanpa zon waktu, jadi akhiri dengan Z atau offset seperti -03:00.
  • Melakukan commit fail log masuk yang disimpan. Refresh tokennya memberi sesiapa yang memegangnya alat akaun itu sehingga 60 hari, jadi simpan dalam storan rahsia.
Menggunakan EasyCoexistence untuk ini

easyCoexistence memberi ejen CrewAI anda capaian kepada pelanggan di WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn dan lebih banyak saluran, setiap satu melalui API rasminya: 35+ alat MCP untuk senarai mcps setiap ejen, API siaran yang menjadualkan sehingga 90 hari ke hadapan, dan peristiwa bertandatangan untuk komen dan DM, dengan setiap sambungan dipantau 24/7. US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Adakah klien MCP CrewAI menjalankan log masuk OAuth sendiri?

Dokumentasinya menunjukkan header, pembolehubah persekitaran dan parameter pertanyaan untuk pengesahan, tanpa aliran OAuth. Jadi pasukan menghantar token pembawa yang sudah dipegangnya, yang disediakan oleh satu log masuk dengan SDK Python MCP.

Bolehkah pasukan membalas komen mengikut jadualnya sendiri?

Boleh. Ejen pengurus komuniti dengan list_social_posts, list_social_comments dan reply_to_comment boleh memproses komen baharu pada setiap larian, yang juga cara komen YouTube dan LinkedIn dibaca, kerana kedua-duanya tidak menghantar peristiwa.

Bolehkah pasukan menghantar mesej WhatsApp?

Boleh, dengan list_numbers, send_message dan send_template dalam penapis alat ejen. send_message membalas pelanggan yang menulis dalam 24 jam terakhir, dan send_template menghantar templat yang diluluskan kepada orang lain.

Berapakah kos easyCoexistence untuk pasukan CrewAI?

US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dan sama bagi setiap rangkaian. Pelayan MCP, API siaran dan peristiwa yang dimajukan termasuk, dengan 3 hari pertama percuma.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada