Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Daj agentowi LangChain narzędzia do Instagrama, TikToka i WhatsAppa

Agent LangChain otrzymuje Instagram, TikTok, WhatsApp i kolejne kanały jako narzędzia z serwera MCP easyCoexistence pod adresem https://easycoexistence.com/api/mcp. Ładuje je MCPAdapter, klient MCP dla LangChain, a FastMCP przeprowadza logowanie OAuth. Dzięki create_agent agent może publikować i planować posty, odpowiadać na komentarze i DM oraz odczytywać statystyki przez oficjalne API każdej sieci, a podpisane zdarzenia przekazują nowe komentarze i wiadomości na Twoją trasę.

Beta

Nazwa przestrzeni nazw langchain.mcp w LangChain, która wymaga langchain[mcp] 1.4.0 lub nowszego i sprowadza FastMCP.

In memory

Miejsce, w którym FastMCP przechowuje tokeny OAuth, dopóki token_storage nie wskazuje magazynu; po restarcie trzeba zalogować się ponownie.

127.0.0.1

Adres loopback tymczasowego serwera wywołań zwrotnych, który FastMCP uruchamia do logowania w przeglądarce, na wolnym porcie lub na callback_port.

60 days

Czas ważności tokena odświeżania MCP easyCoexistence. Tokeny dostępu są ważne przez godzinę, a każde odświeżenie wydaje nową parę.

8 seconds

Czas, jaki easyCoexistence czeka, aż Twoja trasa odpowie na przekazany komentarz lub DM; zdarzenie wysyłane jest raz i nigdy nie ponawiane.

Jakie narzędzia dostaje agent LangChain od easyCoexistence?

Ponad 50, jako zwykłe narzędzia LangChain, które create_agent może wywołać. Narzędzia społecznościowe przyjmują account_id, więc agent zaczyna od list_social_accounts i przekazuje ich ID do publikacji, odczytu i odpowiedzi na komentarze, ich ukrywania oraz odczytu statystyk. Narzędzia należące do jednej sieci noszą jej nazwę, np. publish_tiktok_post lub upload_youtube_video, a numer WhatsApp zaczyna się od list_numbers, która zwraca connection_id wymagany przez send_message i send_template. Opis każdego narzędzia zawiera zasady danej sieci, więc model uczy się na przykład, że odpowiedź na TikToku jest publiczna. Planowanie posta wymaga jeszcze jednego argumentu: scheduled_at umieszcza post w kolejce easyCoexistence.

Instagrampublish_instagram_post, reply_to_comment, send_social_dm, get_social_insights
TikTokpublish_tiktok_post, get_tiktok_publish_status, reply_to_comment with post_id
WhatsApplist_numbers, send_message, send_template, get_number_health
Facebookpublish_facebook_post, reply_to_comment, send_social_dm for Messenger
YouTube and LinkedInupload_youtube_video, reply_to_youtube_comment, publish_linkedin_post, get_linkedin_stats
The queuelist_scheduled_posts, update_scheduled_post, cancel_scheduled_post, retry_scheduled_post

Jak agent loguje się do easyCoexistence?

Pomocnikiem OAuth z FastMCP, którego MCPAdapter używa do uwierzytelniania. Przy pierwszym uruchomieniu odkrywa serwer autoryzacji easyCoexistence, rejestruje się jako klient, otwiera przeglądarkę z ekranem zgody, na którym widać jego client_name, i odbiera kod na lokalnym wywołaniu zwrotnym pod adresem 127.0.0.1. Później tokeny dostępu odświeżają się bez przeglądarki. Tokeny leżą w pamięci, chyba że pomocnik dostanie magazyn token_storage, więc przykład zapisuje je na dysku, zaszyfrowane kluczem Fernet. Przefiltruj listę, zanim create_agent ją zobaczy: narzędzia trzymają klienta MCP, więc agent działa dalej po zamknięciu bloku async with.

A reply agent's tools, with a sign-in that survives restarts
import os

from cryptography.fernet import Fernet
from fastmcp import Client
from fastmcp.client.auth import OAuth
from key_value.aio.stores.disk import DiskStore
from key_value.aio.wrappers.encryption import FernetEncryptionWrapper
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

URL = "https://easycoexistence.com/api/mcp"

# Kept on disk and encrypted, so the browser sign-in happens once
oauth = OAuth(
    client_name="Acme reply agent",  # shown on easyCoexistence's consent screen
    callback_port=8765,
    token_storage=FernetEncryptionWrapper(
        key_value=DiskStore(directory="~/.easycoexistence/oauth"),
        fernet=Fernet(os.environ["TOKEN_KEY"]),
    ),
)

REPLY_TOOLS = {"list_social_accounts", "list_social_comments", "reply_to_comment",
               "hide_comment", "send_social_dm"}

RULES = (
    "You reply to comments and DMs for Acme, on the account_id in the event. "
    "TikTok replies are public and need the video ID as post_id. "
    "Never reply to the account's own messages or replies."
)

async def build_reply_agent(model: str):
    async with MCPAdapter(Client(URL, auth=oauth)) as adapter:
        tools = [t for t in await adapter.list_tools() if t.name in REPLY_TOOLS]
    return create_agent(model, tools, system_prompt=RULES)

Jak komentarze i DM trafiają do agenta LangChain?

Jako podpisane żądania POST na Twoją trasę, ponieważ MCP odpowiada tylko na wywołania agenta. Ustaw dla każdego konta trasę przez set_social_webhook_destination, wykonaj raz przez agenta albo z Claude lub ChatGPT, i zachowaj zwracany signing_secret. Instagram i Facebook przekazują komentarze, wzmianki i DM, a TikTok przekazuje komentarze; każde zdarzenie zawiera platform, account_id, external_id i wpis właściwy dla danej sieci. Trasa sprawdza X-EC-Signature, od razu odpowiada, ponieważ easyCoexistence czeka 8 sekund i nie ponawia, a zdarzenie przekazuje agentowi w tle. Checkpointer z thread_id dla każdego nadawcy DM zachowuje historię rozmowy.

A FastAPI route that verifies the event, then runs the agent
import hashlib, hmac, json, time

from fastapi import BackgroundTasks, FastAPI, HTTPException, Request

app = FastAPI()  # at startup: app.state.agent = await build_reply_agent("<MODEL>")
SECRETS: dict[str, str] = {}  # account_id -> signing_secret, kept in your database

def signed(raw: bytes, header: str, secret: str) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(",") if "=" in p)
    t, v1 = parts.get("t", ""), parts.get("v1", "")
    if not t.isdigit() or abs(time.time() - int(t)) > 300:
        return False
    mac = hmac.new(secret.encode(), t.encode() + b"." + raw, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac.encode(), v1.encode())

@app.post("/hooks/social")
async def social_event(request: Request, background: BackgroundTasks):
    raw = await request.body()
    event = json.loads(raw)  # platform, account_id, external_id, entry
    secret = SECRETS.get(event.get("account_id", ""))
    if not secret or not signed(raw, request.headers.get("x-ec-signature", ""), secret):
        raise HTTPException(status_code=401)
    background.add_task(reply, event)  # runs after the response is sent
    return {"received": True}

async def reply(event: dict) -> None:
    prompt = json.dumps(event)  # the agent reads the platform, the account and the entry
    await app.state.agent.ainvoke({"messages": [{"role": "user", "content": prompt}]})

Co każda sieć pozwala zrobić agentowi?

To, na co pozwala API sieci danemu kontu. Instrukcje agenta powinny to wyraźnie określać:

  • DM na Instagramie i w Messengerze: send_social_dm odpowiada osobom, które napisały w ciągu ostatnich 24 godzin, a Instagram ogranicza DM do 1 000 bajtów UTF-8.
  • Odpowiedzi na komentarze: reply_to_comment odpowiada publicznie, a z private ustawionym na true wysyła jedną wiadomość DM na komentarz na Instagramie lub Facebooku w ciągu 7 dni od niego.
  • TikTok: odpowiedzi są zawsze publiczne i wymagają ID wideo jako post_id, a na TikToku nie ma DM.
  • WhatsApp: send_message działa w ciągu 24 godzin od ostatniej wiadomości klienta, a send_template z zatwierdzonym szablonem działa poza tym oknem.
  • Media: każdy plik znajduje się pod publicznym linkiem HTTPS; Instagram przyjmuje obrazy JPEG, a posty zdjęciowe TikToka JPEG lub WebP.

Kiedy kod ma wywoływać sieci bez agenta?

Gdy krok musi przebiegać za każdym razem tak samo albo gdy nikt nie może się zalogować. get_social_credentials przekazuje agentowi bazę API konta, jego ID w sieci i, na TikToku, YouTube i LinkedIn, token ważny w tej chwili, a Partner API zwraca to samo z GET /api/v1/channels/:id?credentials=1 kluczem ec_live_, więc zadanie w Pythonie może wywołać bezpośrednio TikTok, Google lub LinkedIn. Odpowiedzi, które muszą wyjść o każdej porze bez agenta, np. stały tekst na słowo kluczowe, pasują do reguł komentarzy i automatyzacji, które easyCoexistence wykonuje samodzielnie.

Typowe błędy

  • Odpowiadanie na zdarzenia wywołane przez konto. Instagram odsyła DM konta z is_echo ustawionym na true i zwraca jego publiczne odpowiedzi jako komentarze, więc usuń je, zanim agent je zobaczy, inaczej odpowie sam sobie.
  • Uruchamianie agenta przed odpowiedzią trasy. easyCoexistence czeka 8 sekund na 2xx i nigdy nie ponawia, więc handler czekający na model traci zdarzenie; najpierw odpowiedz, pracuj w tle.
  • Wywoływanie reply_to_comment dla komentarza na TikToku bez post_id. Odpowiedź na TikToku wskazuje wideo oraz komentarz, więc przekaż video_id zdarzenia jako post_id.
  • Dawanie agentowi odpowiadającemu narzędzi do publikowania. Przefiltruj listę po nazwie, zanim trafi do create_agent, aby źle odczytany komentarz nie mógł opublikować ani usunąć posta, ani zmienić automatyzacji.
Z EasyCoexistence zrobisz to

easyCoexistence daje Twoim agentom LangChain dostęp do klientów na WhatsAppie, Instagramie, Facebooku, TikToku, YouTubie, LinkedInie i kolejnych kanałach, każdym przez oficjalne API: jeden serwer MCP za logowaniem OAuth, podpisane zdarzenia komentarzy i DM oraz kolejkę, która planuje posty z 90-dniowym wyprzedzeniem, a każde połączenie jest objęte monitorowaniem 24/7. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.

Najczęściej zadawane pytania

Czy agent potrzebuje własnej aplikacji developerskiej Meta, TikTok lub Google?

Nie. Konta łączą się przez własną aplikację easyCoexistence w każdej sieci, w panelu lub przez link połączenia Partner API, a agent dociera do wszystkich przez jedno logowanie do easyCoexistence.

Czy agent może planować posty zamiast publikować od razu?

Tak. publish_instagram_post, publish_facebook_post, publish_tiktok_post i publish_linkedin_post przyjmują scheduled_at, czyli czas w formacie ISO 8601 ze strefą czasową, od 1 minuty do 90 dni do przodu. YouTube planuje natywnie przez upload_youtube_video i publish_at.

Jakie modele mogą obsługiwać agenta?

Każdy model czatu, którego create_agent może użyć z narzędziami. Narzędzia MCP nie zależą od modelu, a dostawca modelu rozlicza jego zużycie; easyCoexistence pobiera opłatę za połączenie, nigdy za pojedyncze wywołanie narzędzia.

Ile kosztuje easyCoexistence dla agenta LangChain?

Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, tak samo w każdej sieci. Serwer MCP, przekazywane zdarzenia i Partner API są wliczone, a pierwsze 3 dni są za darmo.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w