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ę.
Nazwa przestrzeni nazw langchain.mcp w LangChain, która wymaga langchain[mcp] 1.4.0 lub nowszego i sprowadza FastMCP.
Miejsce, w którym FastMCP przechowuje tokeny OAuth, dopóki token_storage nie wskazuje magazynu; po restarcie trzeba zalogować się ponownie.
Adres loopback tymczasowego serwera wywołań zwrotnych, który FastMCP uruchamia do logowania w przeglądarce, na wolnym porcie lub na callback_port.
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ę.
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.
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.
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.
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_dmodpowiada 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_commentodpowiada 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_messagedziała w ciągu 24 godzin od ostatniej wiadomości klienta, asend_templatez 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.
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