Dajte LangChain agentu Instagram, TikTok i WhatsApp alate
LangChain agent dobiva Instagram, TikTok, WhatsApp i druge kanale kao alate s easyCoexistence MCP poslužitelja na https://easycoexistence.com/api/mcp, koje učitava MCPAdapter, LangChainov MCP klijent, a prijavu putem OAuth-a vodi FastMCP. create_agent zatim može objavljivati i zakazivati objave, odgovarati na komentare i DM-ove te čitati uvide kroz službeni API svake mreže, dok potpisani događaji dovode nove komentare i poruke na vašu rutu.
LangChainova oznaka za njegov prostor imena langchain.mcp, za koji je potreban langchain[mcp] 1.4.0 ili noviji i koji uvodi FastMCP.
Mjesto na kojem FastMCP čuva OAuth tokene ako token_storage ne navede pozadinsku pohranu, pa ponovno pokretanje znači ponovnu prijavu.
Povratna adresa privremenog poslužitelja za povratni poziv koji FastMCP pokreće za prijavu u pregledniku, na slobodnom priključku ili callback_port.
Koliko dugo traje refresh token easyCoexistence MCP-a; pristupni tokeni traju sat vremena, a svako osvježavanje izdaje novi par.
Koliko dugo easyCoexistence čeka da vaša ruta odgovori na proslijeđeni komentar ili DM; šalje se jednom i nikad se ne ponavlja.
Koje alate LangChain agent dobiva od easyCoexistencea?
Više od 50, kao obični LangChain alati koje create_agent može pozvati. Društveni alati uzimaju account_id, pa agent počinje s list_social_accounts i prosljeđuje njegove ID-ove alatima za objavu, čitanje i odgovaranje na komentare, njihovo skrivanje i čitanje uvida. Alati vezani uz jednu mrežu nose njezin naziv, kao publish_tiktok_post ili upload_youtube_video, a WhatsApp broj kreće s list_numbers, koji vraća connection_id što preuzimaju send_message i send_template. Opis svakog alata nosi pravila te mreže, pa model uči, primjerice, da je odgovor na TikToku uvijek javan. Objava kasnije uzima još jedan argument: scheduled_at stavlja objavu u red čekanja easyCoexistencea.
Kako se agent prijavljuje u easyCoexistence?
Pomoćnikom za OAuth iz FastMCP-a, koji MCPAdapter koristi za autentifikaciju. Pri prvom pokretanju otkriva easyCoexistenceov autorizacijski poslužitelj, registrira se kao klijent, otvara preglednik na zaslonu za pristanak, gdje se prikazuje njegov client_name, i prima kod na lokalnom povratnom pozivu na 127.0.0.1. Nakon toga se pristupni tokeni osvježavaju bez preglednika. Tokeni ostaju u memoriji osim ako pomoćnik ne dobije pozadinsku pohranu token_storage, pa primjer čuva tokene na disku, šifrirane Fernet ključem. Filtrirajte popis prije nego create_agent to vidi: alati drže MCP klijenta, pa agent radi i nakon što se blok async with zatvori.
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)Kako komentari i DM-ovi stižu do LangChain agenta?
Kao potpisani POST zahtjevi na vašu rutu, jer MCP odgovara samo na pozive koje agent sam šalje. Svaki račun usmjerite na rutu pomoću set_social_webhook_destination, što agentu zatražite jednom ili pokrenete iz Claudea ili ChatGPT-ja, i čuvajte signing_secret koji vrati. Instagram i Facebook proslijeđuju komentare, spominjanja i DM-ove, a TikTok proslijeđuje komentare; svaki događaj nosi platform, account_id, external_id i unos te mreže. Ruta provjerava X-EC-Signature, odmah odgovara, jer easyCoexistence čeka 8 sekundi i ne ponavlja, te događaj predaje agentu u pozadini. Checkpointer s thread_id-em po pošiljatelju DM-a čuva povijest razgovora.
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}]})Što svaka mreža dopušta agentu?
Ono što API mreže dopušta računu. Upute agenta to trebaju jasno navesti:
- Instagram i Messenger DM-ovi:
send_social_dmodgovara osobama koje su pisale u posljednja 24 sata, a Instagram ograničava DM na 1.000 bajtova UTF-8. - Odgovori na komentare:
reply_to_commentodgovara javno, a s private postavljenim na true šalje jednu DM poruku po komentaru na Instagramu ili Facebooku, unutar 7 dana od njega. - TikTok: odgovori su uvijek javni i trebaju ID videa kao
post_id, a na TikToku nema DM-ova. - WhatsApp:
send_messageradi unutar 24 sata od posljednje poruke korisnika, asend_templates odobrenim predloškom izvan tog roka. - Medijske datoteke: svaka datoteka nalazi se na javnoj HTTPS poveznici; Instagram prihvaća JPEG slike, a TikTok fotoobjave JPEG ili WebP.
Kada kod treba zvati mreže bez agenta?
Kada se korak mora odvijati uvijek na isti način ili kada nitko nije tu da se prijavi. get_social_credentials agentu predaje osnovnu adresu API-ja računa, njegov ID na mreži i, na TikToku, YouTubeu i LinkedInu, token koji vrijedi upravo sada, a Partner API vraća isto s GET /api/v1/channels/:id?credentials=1 uz ključ ec_live_, pa Python posao može izravno pozivati TikTok, Google ili LinkedIn. Odgovori koji moraju otići u bilo koje doba bez agenta, poput fiksnog teksta za ključnu riječ, pripadaju pravilima za komentare i automatizacijama, koje easyCoexistence pokreće sam.
Uobičajene pogreške
- Odgovaranje na događaje koje je račun sam izazvao. Instagram vraća DM-ove računa s is_echo postavljenim na true i javne odgovore kao komentare, pa ih izbacite prije nego ih agent vidi, inače će odgovarati sam sebi.
- Pokretanje agenta prije nego ruta odgovori. easyCoexistence čeka 8 sekundi na 2xx i nikad ne ponavlja, pa rukovatelj koji čeka model gubi događaj; prvo odgovorite, zatim radite u pozadini.
- Pozivanje reply_to_comment za TikTok komentar bez post_id. TikTokov odgovor imenuje i video i komentar, pa predajte video_id događaja kao post_id.
- Davanje agentu za odgovore alata za objavljivanje. Filtrirajte popis po imenu prije create_agent, da pogrešno pročitan komentar ne može objaviti, obrisati objavu ili promijeniti automatizaciju.
easyCoexistence vašim LangChain agentima daje doseg do kupaca na WhatsAppu, Instagramu, Facebooku, TikToku, YouTubeu, LinkedInu i još kanala, svaki kroz službeni API: jedan MCP poslužitelj iza OAuth prijave, potpisani događaji za komentare i DM-ove te red čekanja koji objavljuje do 90 dana unaprijed, uz praćenje svake veze 24/7. Od US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, s besplatnim probnim razdobljem od 3 dana.
Često postavljana pitanja
Treba li agentu vlastita razvojna aplikacija za Meta, TikTok ili Google?
Ne. Računi se povezuju kroz easyCoexistenceovu vlastitu aplikaciju na svakoj mreži, u nadzornoj ploči ili putem poveznice za povezivanje Partner API-ja, a agent do svih njih dolazi jednom easyCoexistence prijavom.
Može li agent zakazivati objave umjesto da odmah objavljuje?
Može. publish_instagram_post, publish_facebook_post, publish_tiktok_post i publish_linkedin_post uzimaju scheduled_at, vrijeme u ISO 8601 formatu s vremenskom zonom, od 1 minute do 90 dana unaprijed. YouTube zakazuje izvorno uz upload_youtube_video i publish_at.
Koji modeli mogu pokretati agenta?
Svaki model za razgovor koji create_agent može koristiti s alatima. MCP alati ne ovise o modelu, a pružatelj modela naplaćuje vlastitu potrošnju; easyCoexistence naplaćuje po vezi, nikad po pozivu alata.
Koliko košta easyCoexistence za LangChain agenta?
Od US$ 9 do US$ 0.75 po vezi mjesečno, uz pad kako dodajete veze, jednako na svakoj mreži. MCP poslužitelj, proslijeđeni događaji i Partner API uključeni su, a prva 3 dana su besplatna.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na